pinecone-assistant

Create and manage Pinecone Assistants for cited Q&A over uploaded documents.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Norfolk-Group/H-Analytics --skill pinecone-assistant-norfolk-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pinecone-assistant
Source: https://github.com/Norfolk-Group/H-Analytics/tree/main/.claude/archive/agents-skills-snapshot/pinecone-assistant
Command: npx skills add https://github.com/Norfolk-Group/H-Analytics --skill pinecone-assistant-norfolk-group

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Pinecone Assistant removes the friction of building, maintaining, and querying a document knowledge base by providing a simple, script-driven workflow to create assistants, upload and sync documents, and get cited answers. It avoids manual embedding pipelines and hosting work by leveraging Pinecone managed assistants so teams can get reliable Q&A over their documentation quickly.

Core Features & Use Cases

  • Create Assistants: Provision named Pinecone Assistants with optional behavior instructions and regional selection.
  • Upload & Sync Documents: Upload documentation (Markdown, PDF, DOCX, JSON, TXT) and incrementally sync local folders with mtime/size detection and optional deletion of missing files.
  • Query & Context Retrieval: Ask questions with cited responses, stream responses, and retrieve raw context snippets for debugging or custom RAG workflows.
  • Administration: List assistants and files, view status and file metadata, and obtain MCP host details for integration.

Quick Start

Create an assistant named docs-bot, upload your ./docs folder to it, then ask the assistant a question about installation.

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 document QA assistant with Pinecone for cited answers?

To create a document QA assistant with Pinecone, you use provided scripts to provision a named assistant, upload files like PDF and Markdown, and query it to receive cited responses. This removes the need for manual embedding pipelines.

Can I incrementally sync local documentation folders to a Pinecone Assistant?

Yes, you can incrementally sync local folders to a Pinecone Assistant using mtime and size detection. The sync scripts identify changed files and optionally delete missing files from the assistant's knowledge base.

What file formats are supported for uploading to a Pinecone Assistant knowledge base?

Pinecone Assistants support uploading Markdown, PDF, DOCX, JSON, and TXT files. These formats are parsed by the managed assistant service to enable cited question-and-answer retrieval.

How do I retrieve raw context snippets from Pinecone for custom RAG workflows?

You retrieve raw context snippets from Pinecone by using the context lookup script instead of the chat workflow. This returns unformatted text segments with metadata for debugging or integration into custom RAG pipelines.

Do I need a Pinecone API key to manage assistants and upload documents?

Yes, a Pinecone API key is required to authenticate assistant creation, file uploads, and chat workflows. The scripts use the Pinecone Python SDK to handle these operations securely.

Can I stream chat responses from a Pinecone Assistant?

Yes, you can stream chat responses from a Pinecone Assistant. The chat script supports streaming to provide real-time generation of cited answers for support and research queries.