{"id":"c68c6d10-53b7-4c5a-82f8-e65785622f97","shortId":"BQ53Zn","kind":"skill","title":"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":["assistant","gemini","cli","extension","pinecone-io","agent-skills","agentic-ides","gemini-cli","gemini-cli-extension","pinecone","semantic-search","vector-search"],"capabilities":["skill","source-pinecone-io","skill-assistant","topic-agent-skills","topic-agentic-ides","topic-gemini-cli","topic-gemini-cli-extension","topic-pinecone","topic-semantic-search","topic-vector-search"],"categories":["gemini-cli-extension"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/pinecone-io/gemini-cli-extension/assistant","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add pinecone-io/gemini-cli-extension","source_repo":"https://github.com/pinecone-io/gemini-cli-extension","install_from":"skills.sh"}},"qualityScore":"0.461","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 23 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-01T07:01:44.535Z","embedding":null,"createdAt":"2026-04-18T22:24:43.812Z","updatedAt":"2026-05-01T07:01:44.535Z","lastSeenAt":"2026-05-01T07:01:44.535Z","tsv":"'/?sessiontype=signup':420 '/docs':207,330,356 '/uv/getting-started/installation/)':411 '1':339 '2':347 '3':357 'add':183,387 'ambigu':303 'answer':60 'api':373,381,415 'app.pinecone.io':419 'app.pinecone.io/?sessiontype=signup':418 'arg':89 'argument':82 'ask':37,56,116,212,298,307,333 'assist':1,8,17,33,39,45,47,92,100,107,120,126,132,163,166,172,187,200,202,214,220,233,246,248,261,274,282,286,294,323,351,361 'avail':377 'bot':301,327,346,354,364 'briefli':291 'call':167,324 'chain':317 'chat':5,22,115,211,224 'citat':14 'cite':59 'clarifi':311 'command':159 'confirm':292 'context':23,123,230,237 'convers':256,265 'creat':2,19,31,90,160,161,269,321 'delet':110 'delete-miss':109 'detail':139 'directori':76 'doc':36,175,182,197,300,326,345,353,363 'docs-bot':299,325,344,352,362 'docs.astral.sh':410 'docs.astral.sh/uv/getting-started/installation/)':409 'document':10,55,190 'dri':113 'dry-run':112 'embed':62 'env':390,399,401 'env-fil':398 'exampl':320 'exist':306 'explicit':158 'export':379 'featur':337,370 'file':98,104,134,146,184,391,400 'find':236 'first':271 'folder':331 'free':414 'full':137 'fulli':50 'get':58,122,412 'handl':15,153,316 'increment':105 'index':188 'infrastructur':65 'instal':406,407 'instruct':95 'json':135 'k':130 'keep':201 'key':88,374,382,385,416 'know':221 'languag':29,150 'last':260,289 'like':30 'list':26,131,243 'main':336,369 'make':164 'manag':3,51 'memori':257 'messag':121,365 'miss':111 'multi':313 'multi-step':312 'multipl':305 'must':375,404 'name':94,277,343 'natur':28,149,319 'one':290 'oper':18,83,142 'pattern':102,155 'pinecon':7,44,46,372,380 'pipelin':63 'prerequisit':371 'proactiv':152 'q':11 'queri':127 'question':57,118 'rag':52 're':296 'read':143 'recogn':27 'recognit':151 'refer':148 'references/chat.md':228,229 'references/context.md':241,242 'references/create.md':177,178 'references/sync.md':209,210 'references/upload.md':192,193 'refresh':205 'region':96 'relat':72 'relev':145 'rememb':275 'request':315,318 'requir':66,157 'retriev':24 'run':77,80,114,252,254,341,349,359,393,397 'say':280 'script':68,71,87,394,402 'scripts/chat.py':119,360 'scripts/context.py':125 'scripts/create.py':93,342 'scripts/list.py':133,255 'scripts/script_name.py':81 'scripts/sync.py':106 'scripts/upload.py':99,350 'search':231 'see':176,191,208,227,240 'servic':53 'set':169 'show':244 'skill':75 'skill-assistant' 'snippet':124 'sourc':101,108,355 'source-pinecone-io' 'step':314 'sync':21,103,194,195,204 'termin':378 'top':129 'top-k':128 'topic-agent-skills' 'topic-agentic-ides' 'topic-gemini-cli' 'topic-gemini-cli-extension' 'topic-pinecone' 'topic-semantic-search' 'topic-vector-search' 'track':258 'updat':198 'uplo':43 'upload':20,54,97,179,180,328 'use':262,272,287,297 'user':268,279,309 'uv':79,253,340,348,358,396,403,408 'within':263 'without':156 'workflow':138 'x':41,168,216,223,226,235,239 'your-key':383","prices":[{"id":"e3950cc3-f912-42f4-8d31-cf05dd966f4f","listingId":"c68c6d10-53b7-4c5a-82f8-e65785622f97","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"pinecone-io","category":"gemini-cli-extension","install_from":"skills.sh"},"createdAt":"2026-04-18T22:24:43.812Z"}],"sources":[{"listingId":"c68c6d10-53b7-4c5a-82f8-e65785622f97","source":"github","sourceId":"pinecone-io/gemini-cli-extension/assistant","sourceUrl":"https://github.com/pinecone-io/gemini-cli-extension/tree/main/skills/assistant","isPrimary":false,"firstSeenAt":"2026-04-18T22:24:43.812Z","lastSeenAt":"2026-05-01T07:01:44.535Z"}],"details":{"listingId":"c68c6d10-53b7-4c5a-82f8-e65785622f97","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"pinecone-io","slug":"assistant","github":{"repo":"pinecone-io/gemini-cli-extension","stars":23,"topics":["agent-skills","agentic-ides","gemini-cli","gemini-cli-extension","pinecone","retrieval-augmented-generation","semantic-search","vector-search"],"license":"mit","html_url":"https://github.com/pinecone-io/gemini-cli-extension","pushed_at":"2026-04-24T19:30:56Z","description":"The official Pinecone Gemini CLI extension repo.","skill_md_sha":"8449ad9e2c15c6d9550041960282ded659d7f2e7","skill_md_path":"skills/assistant/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/pinecone-io/gemini-cli-extension/tree/main/skills/assistant"},"layout":"multi","source":"github","category":"gemini-cli-extension","frontmatter":{"name":"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/gemini-cli-extension/assistant"},"updatedAt":"2026-05-01T07:01:44.535Z"}}