{"id":"9e257bf3-2072-4497-b911-5fd56308728b","shortId":"qykTMJ","kind":"skill","title":"pinecone-assistant","tagline":"Create, manage, and chat with Pinecone Assistants for document Q&A with citations. Handles all assistant operations - create, upload, sync, chat, context retrieval, and list. Recognizes natural language like \"create an assistant from my docs\", \"ask my assistant about X\", or \"uplo","description":"# Pinecone Assistant\n\nPinecone Assistant is a fully managed RAG service. Upload documents, ask questions, get cited answers. No embedding pipelines or infrastructure required.\n\n> All scripts are in `scripts/` relative to this skill directory.\n> Run with: `uv run scripts/script_name.py [arguments]`\n\n## Operations\n\n| What to do | Script | Key args |\n|---|---|---|\n| Create an assistant | `scripts/create.py` | `--name` `--instructions` `--region` |\n| Upload files | `scripts/upload.py` | `--assistant` `--source` `--patterns` |\n| Sync files (incremental) | `scripts/sync.py` | `--assistant` `--source` `--delete-missing` `--dry-run` |\n| Chat / ask a question | `scripts/chat.py` | `--assistant` `--message` |\n| Get context snippets | `scripts/context.py` | `--assistant` `--query` `--top-k` |\n| List assistants | `scripts/list.py` | `--files` `--json` |\n\nFor full workflow details on any operation, read the relevant file in `references/`.\n\n---\n\n## Natural Language Recognition\n\nProactively handle these patterns without requiring explicit commands:\n\n**Create:** \"create an assistant\", \"make an assistant called X\", \"set up an assistant for my docs\"\n→ See [references/create.md](references/create.md)\n\n**Upload:** \"upload my docs\", \"add files to my assistant\", \"index my documentation\"\n→ See [references/upload.md](references/upload.md)\n\n**Sync:** \"sync my docs\", \"update my assistant\", \"keep assistant in sync\", \"refresh from ./docs\"\n→ See [references/sync.md](references/sync.md)\n\n**Chat:** \"ask my assistant about X\", \"what does my assistant know about X\", \"chat with X\"\n→ See [references/chat.md](references/chat.md)\n\n**Context:** \"search my assistant for X\", \"find context about X\"\n→ See [references/context.md](references/context.md)\n\n**List:** \"show my assistants\", \"what assistants do I have\"\n→ Run `uv run scripts/list.py`\n\n---\n\n## Conversation Memory\n\nTrack the last assistant used within the conversation:\n- When a user creates or first uses an assistant, remember its name\n- If user says \"my assistant\", \"it\", or \"the assistant\" → use the last one\n- Briefly confirm which assistant you're using: \"Asking docs-bot...\"\n- If ambiguous and multiple exist → ask the user to clarify\n\n---\n\n## Multi-Step Requests\n\nHandle chained requests naturally. Example:\n\n> \"Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are\"\n\n1. `uv run scripts/create.py --name docs-bot`\n2. `uv run scripts/upload.py --assistant docs-bot --source ./docs`\n3. `uv run scripts/chat.py --assistant docs-bot --message \"what are the main features?\"`\n\n---\n\n## Prerequisites\n\n- `PINECONE_API_KEY` must be available — terminal: `export PINECONE_API_KEY=\"your-key\"`, or add to a `.env` file and run scripts with `uv run --env-file .env scripts/...`\n- `uv` must be installed — [install uv](https://docs.astral.sh/uv/getting-started/installation/)\n- Get a free API key at: https://app.pinecone.io/?sessionType=signup","tags":["pinecone","assistant","skills","pinecone-io","agent-skills","agents","semantic-search","skills-sh"],"capabilities":["skill","source-pinecone-io","skill-pinecone-assistant","topic-agent-skills","topic-agents","topic-pinecone","topic-semantic-search","topic-skills-sh"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/pinecone-io/skills/pinecone-assistant","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add pinecone-io/skills","source_repo":"https://github.com/pinecone-io/skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (2,928 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:26.835Z","embedding":null,"createdAt":"2026-05-18T19:07:26.835Z","updatedAt":"2026-05-18T19:07:26.835Z","lastSeenAt":"2026-05-18T19:07:26.835Z","tsv":"'/?sessiontype=signup':422 '/docs':209,332,358 '/uv/getting-started/installation/)':413 '1':341 '2':349 '3':359 'add':185,389 'ambigu':305 'answer':62 'api':375,383,417 'app.pinecone.io':421 'app.pinecone.io/?sessiontype=signup':420 'arg':91 'argument':84 'ask':39,58,118,214,300,309,335 'assist':3,10,19,35,41,47,49,94,102,109,122,128,134,165,168,174,189,202,204,216,222,235,248,250,263,276,284,288,296,325,353,363 'avail':379 'bot':303,329,348,356,366 'briefli':293 'call':169,326 'chain':319 'chat':7,24,117,213,226 'citat':16 'cite':61 'clarifi':313 'command':161 'confirm':294 'context':25,125,232,239 'convers':258,267 'creat':4,21,33,92,162,163,271,323 'delet':112 'delete-miss':111 'detail':141 'directori':78 'doc':38,177,184,199,302,328,347,355,365 'docs-bot':301,327,346,354,364 'docs.astral.sh':412 'docs.astral.sh/uv/getting-started/installation/)':411 'document':12,57,192 'dri':115 'dry-run':114 'embed':64 'env':392,401,403 'env-fil':400 'exampl':322 'exist':308 'explicit':160 'export':381 'featur':339,372 'file':100,106,136,148,186,393,402 'find':238 'first':273 'folder':333 'free':416 'full':139 'fulli':52 'get':60,124,414 'handl':17,155,318 'increment':107 'index':190 'infrastructur':67 'instal':408,409 'instruct':97 'json':137 'k':132 'keep':203 'key':90,376,384,387,418 'know':223 'languag':31,152 'last':262,291 'like':32 'list':28,133,245 'main':338,371 'make':166 'manag':5,53 'memori':259 'messag':123,367 'miss':113 'multi':315 'multi-step':314 'multipl':307 'must':377,406 'name':96,279,345 'natur':30,151,321 'one':292 'oper':20,85,144 'pattern':104,157 'pinecon':2,9,46,48,374,382 'pinecone-assist':1 'pipelin':65 'prerequisit':373 'proactiv':154 'q':13 'queri':129 'question':59,120 'rag':54 're':298 'read':145 'recogn':29 'recognit':153 'refer':150 'references/chat.md':230,231 'references/context.md':243,244 'references/create.md':179,180 'references/sync.md':211,212 'references/upload.md':194,195 'refresh':207 'region':98 'relat':74 'relev':147 'rememb':277 'request':317,320 'requir':68,159 'retriev':26 'run':79,82,116,254,256,343,351,361,395,399 'say':282 'script':70,73,89,396,404 'scripts/chat.py':121,362 'scripts/context.py':127 'scripts/create.py':95,344 'scripts/list.py':135,257 'scripts/script_name.py':83 'scripts/sync.py':108 'scripts/upload.py':101,352 'search':233 'see':178,193,210,229,242 'servic':55 'set':171 'show':246 'skill':77 'skill-pinecone-assistant' 'snippet':126 'sourc':103,110,357 'source-pinecone-io' 'step':316 'sync':23,105,196,197,206 'termin':380 'top':131 'top-k':130 'topic-agent-skills' 'topic-agents' 'topic-pinecone' 'topic-semantic-search' 'topic-skills-sh' 'track':260 'updat':200 'uplo':45 'upload':22,56,99,181,182,330 'use':264,274,289,299 'user':270,281,311 'uv':81,255,342,350,360,398,405,410 'within':265 'without':158 'workflow':140 'x':43,170,218,225,228,237,241 'your-key':385","prices":[{"id":"cc24a8f3-626c-4ce9-8715-9720a4271f38","listingId":"9e257bf3-2072-4497-b911-5fd56308728b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"pinecone-io","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T19:07:26.835Z"}],"sources":[{"listingId":"9e257bf3-2072-4497-b911-5fd56308728b","source":"github","sourceId":"pinecone-io/skills/pinecone-assistant","sourceUrl":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-assistant","isPrimary":false,"firstSeenAt":"2026-05-18T19:07:26.835Z","lastSeenAt":"2026-05-18T19:07:26.835Z"}],"details":{"listingId":"9e257bf3-2072-4497-b911-5fd56308728b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"pinecone-io","slug":"pinecone-assistant","github":{"repo":"pinecone-io/skills","stars":12,"topics":["agent-skills","agents","pinecone","retrieval-augmented-generation","semantic-search","skills-sh"],"license":"mit","html_url":"https://github.com/pinecone-io/skills","pushed_at":"2026-05-07T04:32:27Z","description":"Pinecone's official Agent Skills library, for use with agentic IDEs such as Cursor, Github Copilot, Antigravity, Gemini CLI and more.","skill_md_sha":"eeb3eb8edb544006b8c88f7fa6065eddb678eefd","skill_md_path":"skills/pinecone-assistant/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-assistant"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"pinecone-assistant","description":"Create, manage, and chat with Pinecone Assistants for document Q&A with citations. Handles all assistant operations - create, upload, sync, chat, context retrieval, and list. Recognizes natural language like \"create an assistant from my docs\", \"ask my assistant about X\", or \"upload my docs to Pinecone\"."},"skills_sh_url":"https://skills.sh/pinecone-io/skills/pinecone-assistant"},"updatedAt":"2026-05-18T19:07:26.835Z"}}