pinecone:assistant

Create, manage, and chat with Pinecone Assistants for document Q&A with citations.

68|12|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/pinecone-io/pinecone-claude-code-plugin --skill pinecone-assistant-pinecone-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pinecone:assistant
Source: https://github.com/pinecone-io/pinecone-claude-code-plugin/tree/main/skills/assistant
Command: npx skills add https://github.com/pinecone-io/pinecone-claude-code-plugin --skill pinecone-assistant-pinecone-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pinecone, typer, rich, and includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up retrieval-augmented generation usually requires building embedding pipelines and managing vector infrastructure. This Skill lets you create Pinecone Assistants, upload documents, and ask questions with cited answers directly from Claude Code, with no RAG plumbing required. ## Core Features & Use Cases - Assistant Lifecycle Management: Create assistants with custom instructions and region selection, and list existing assistants with file details. - Document Upload & Incremental Sync: Upload Markdown, PDF, DOCX, TXT, and JSON files, then keep assistants in sync with local folders using mtime/size change detection, dry-run previews, and optional deletion of removed files. - Cited Chat & Context Retrieval: Ask questions and receive answers with source citations, or pull raw context snippets with relevance scores for custom RAG workflows. - Use Case: Point the assistant at your ./docs folder, sync it after every git pull, and ask natural-language questions like "what are the main features?" to get answers grounded in your own documentation. ## Quick Start Create a Pinecone assistant called docs-bot, upload my ./docs folder, and ask it what the main features are.

Frequently Asked Questions about pinecone:assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Pinecone Assistant for document Q&A?

Run the create script with uv run scripts/create.py --name your-name, optionally adding --instructions and --region (us or eu). The script returns the assistant status and host URL, after which you can upload documents and start chatting.

How do I upload documents to a Pinecone Assistant?

Use uv run scripts/upload.py --assistant NAME --source ./path to upload files. Supported formats are Markdown, TXT, PDF, DOCX, and JSON; code files are not supported. You can filter with --patterns and exclude directories like node_modules with --exclude.

What file formats does Pinecone Assistant support?

Pinecone Assistant supports .md, .txt, .pdf, .docx, and .json files. Source code files such as .py, .js, and .ts are not supported because the service is optimized for natural language documents.

How do I keep my assistant in sync with local files?

Run uv run scripts/sync.py --assistant NAME --source ./docs to upload only new or changed files, detected via mtime and size. Use --dry-run to preview changes and --delete-missing to remove files that no longer exist locally.

Why is my Pinecone Assistant not responding to chat messages?

Chat fails when the assistant has no uploaded files or is still indexing. Verify the assistant status is ready using the list script, confirm files finished processing, and check that PINECONE_API_KEY is exported in your environment.

What is the difference between chat and context retrieval in Pinecone Assistant?

Chat returns a synthesized conversational answer with citations, while context retrieval returns raw snippets with relevance scores and page numbers. Use context for debugging knowledge bases or building custom RAG workflows, and chat for direct Q&A.