Pinecone Assistant

From the author

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".

— the description by Pinecone

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Pinecone Assistant is a managed RAG service that enables users to upload documents and perform natural language queries with citations. This skill provides a set of scripts to automate the lifecycle of these assistants, including creation, file management, document synchronization, conversational Q&A, and raw context retrieval. It simplifies the integration by handling the underlying infrastructure, allowing users to focus on querying their data.

What it does

Create and configure new Pinecone Assistants.
Upload and index documents for knowledge base population.
Synchronize local files with the assistant's knowledge base.
Perform conversational Q&A with cited responses.
Retrieve raw context snippets for debugging or custom workflows.
List and manage existing assistants.

When to use it

When you need to build a RAG-enabled assistant without managing embedding pipelines.
When you want to query specific documentation or local files using natural language.
When you need to verify the relevance of indexed content through raw context retrieval.
When you want to automate the synchronization of local document folders with a cloud assistant.

Advantages

Fully managed infrastructure eliminates the need for manual embedding pipelines.
Provides cited answers for improved transparency and verification.
Supports incremental synchronization to keep knowledge bases up to date.
Enables both conversational chat and raw data retrieval for flexible use cases.

Usage examples

“Create an assistant called docs-bot and upload my ./docs folder.”: The agent initializes a new Pinecone Assistant named docs-bot and indexes all files found in the specified local directory.
“Ask my assistant about the main features of the project.”: The agent sends the query to the active assistant and returns a conversational response with relevant citations.
“Find context about authentication in my assistant.”: The agent retrieves and displays raw text snippets related to authentication from the assistant's knowledge base.
“Sync my docs with the assistant.”: The agent performs an incremental update, ensuring the assistant's knowledge base reflects the current state of the local files.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/pinecone-io/pinecone-assistant/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip pinecone-assistant.zip -d .agents/skills

Documentation by Pinecone

Pinecone Assistant is a fully managed RAG service. Upload documents, ask questions, get cited answers. No embedding pipelines or infrastructure required.

All scripts are in scripts/ relative to this skill directory. Run with: uv run scripts/script_name.py [arguments]

<<clarify_style>>

Operations

What to do	Script	Key args
Create an assistant	`scripts/create.py`	`--name` `--instructions` `--region`
Upload files	`scripts/upload.py`	`--assistant` `--source` `--patterns`
Sync files (incremental)	`scripts/sync.py`	`--assistant` `--source` `--delete-missing` `--dry-run`
Chat / ask a question	`scripts/chat.py`	`--assistant` `--message`
Get context snippets	`scripts/context.py`	`--assistant` `--query` `--top-k`
List assistants	`scripts/list.py`	`--files` `--json`

For full workflow details on any operation, read the relevant file in references/.

Natural Language Recognition

Proactively handle these patterns without requiring explicit commands:

Create: "create an assistant", "make an assistant called X", "set up an assistant for my docs" → See references/create.md

Upload: "upload my docs", "add files to my assistant", "index my documentation" → See references/upload.md

Sync: "sync my docs", "update my assistant", "keep assistant in sync", "refresh from ./docs" → See references/sync.md

Chat: "ask my assistant about X", "what does my assistant know about X", "chat with X" → See references/chat.md

Context: "search my assistant for X", "find context about X" → See references/context.md

List: "show my assistants", "what assistants do I have" → Run uv run scripts/list.py

Conversation Memory

Track the last assistant used within the conversation:

When a user creates or first uses an assistant, remember its name
If user says "my assistant", "it", or "the assistant" → use the last one
Briefly confirm which assistant you're using: "Asking docs-bot..."
If ambiguous and multiple exist → ask the user to clarify

Multi-Step Requests

Handle chained requests naturally. Example:

"Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are"

uv run scripts/create.py --name docs-bot
uv run scripts/upload.py --assistant docs-bot --source ./docs
uv run scripts/chat.py --assistant docs-bot --message "what are the main features?"

Prerequisites

PINECONE_API_KEY must be available: <<api_key_setup>>
uv must be installed — install uv
Get a free API key at: https://app.pinecone.io/?sessionType=signup

Files

ATTRIBUTION.mdAdded by AutoGineer865 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md3.1 KiB
references/chat.md1.2 KiB
references/context.md1.5 KiB
references/create.md1.5 KiB
references/list.md713 B
references/sync.md1.9 KiB
references/upload.md1.7 KiB
scripts/chat.pyScript4.9 KiB
scripts/context.pyScript5.8 KiB
scripts/create.pyScript3.7 KiB
scripts/list.pyScript8.3 KiB
scripts/sync.pyScript13.2 KiB
scripts/upload.pyScript7.4 KiB

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an API key, Needs Python

Security

What our scanner noticed· Low risk

Instructions that use the network
Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Claude API
AnthropicOfficial
Comprehensive reference for integrating Anthropic's Claude API, SDKs, and Managed Agents into your applications.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Medium riskHas scriptsGitHub stars of the source repository188.6k
Transformers
K-Dense· Community
Integrate Hugging Face Transformers for model loading, inference, and fine-tuning across NLP, vision, and audio tasks.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k
Open Notebook
K-Dense· Community
Integrate with the self-hosted Open Notebook platform to automate research ingestion, context-aware chat, and AI-driven analysis.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository56.4k
Vision Sft
Seth Hobson· Community
A structured workflow for supervised fine-tuning of vision-language models, focusing on adapter configuration and silent failure prevention.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
LLM Evaluation
Seth Hobson· Community
A comprehensive framework for evaluating LLM application performance using automated metrics, human feedback, and LLM-as-a-judge techniques.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Lora Qlora Recipes
Seth Hobson· Community
Provides configuration recipes and best-practice hyperparameters for LoRA and QLoRA supervised fine-tuning.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download pinecone-assistant.zip