$npx -y skills add pinecone-io/gemini-cli-extension --skill assistantCreate, 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
| 1 | # Pinecone Assistant |
| 2 | |
| 3 | Pinecone Assistant is a fully managed RAG service. Upload documents, ask questions, get cited answers. No embedding pipelines or infrastructure required. |
| 4 | |
| 5 | > All scripts are in `scripts/` relative to this skill directory. |
| 6 | > Run with: `uv run scripts/script_name.py [arguments]` |
| 7 | |
| 8 | ## Operations |
| 9 | |
| 10 | | What to do | Script | Key args | |
| 11 | |---|---|---| |
| 12 | | Create an assistant | `scripts/create.py` | `--name` `--instructions` `--region` | |
| 13 | | Upload files | `scripts/upload.py` | `--assistant` `--source` `--patterns` | |
| 14 | | Sync files (incremental) | `scripts/sync.py` | `--assistant` `--source` `--delete-missing` `--dry-run` | |
| 15 | | Chat / ask a question | `scripts/chat.py` | `--assistant` `--message` | |
| 16 | | Get context snippets | `scripts/context.py` | `--assistant` `--query` `--top-k` | |
| 17 | | List assistants | `scripts/list.py` | `--files` `--json` | |
| 18 | |
| 19 | For full workflow details on any operation, read the relevant file in `references/`. |
| 20 | |
| 21 | --- |
| 22 | |
| 23 | ## Natural Language Recognition |
| 24 | |
| 25 | Proactively handle these patterns without requiring explicit commands: |
| 26 | |
| 27 | **Create:** "create an assistant", "make an assistant called X", "set up an assistant for my docs" |
| 28 | → See [references/create.md](references/create.md) |
| 29 | |
| 30 | **Upload:** "upload my docs", "add files to my assistant", "index my documentation" |
| 31 | → See [references/upload.md](references/upload.md) |
| 32 | |
| 33 | **Sync:** "sync my docs", "update my assistant", "keep assistant in sync", "refresh from ./docs" |
| 34 | → See [references/sync.md](references/sync.md) |
| 35 | |
| 36 | **Chat:** "ask my assistant about X", "what does my assistant know about X", "chat with X" |
| 37 | → See [references/chat.md](references/chat.md) |
| 38 | |
| 39 | **Context:** "search my assistant for X", "find context about X" |
| 40 | → See [references/context.md](references/context.md) |
| 41 | |
| 42 | **List:** "show my assistants", "what assistants do I have" |
| 43 | → Run `uv run scripts/list.py` |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## Conversation Memory |
| 48 | |
| 49 | Track the last assistant used within the conversation: |
| 50 | - When a user creates or first uses an assistant, remember its name |
| 51 | - If user says "my assistant", "it", or "the assistant" → use the last one |
| 52 | - Briefly confirm which assistant you're using: "Asking docs-bot..." |
| 53 | - If ambiguous and multiple exist → ask the user to clarify |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## Multi-Step Requests |
| 58 | |
| 59 | Handle chained requests naturally. Example: |
| 60 | |
| 61 | > "Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are" |
| 62 | |
| 63 | 1. `uv run scripts/create.py --name docs-bot` |
| 64 | 2. `uv run scripts/upload.py --assistant docs-bot --source ./docs` |
| 65 | 3. `uv run scripts/chat.py --assistant docs-bot --message "what are the main features?"` |
| 66 | |
| 67 | --- |
| 68 | |
| 69 | ## Prerequisites |
| 70 | |
| 71 | - `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/...` |
| 72 | - `uv` must be installed — [install uv](https://docs.astral.sh/uv/getting-started/installation/) |
| 73 | - Get a free API key at: https://app.pinecone.io/?sessionType=signup |