← Explore all skills

DATABASES / Pinecone

Pinecone quickstart

Pinecone's onboarding skill: either a semantic-search demo on a new integrated index through the Pinecone MCP and a bundled upsert script, or a Pinecone Assistant built from the user's own documents.

“Interactive Pinecone quickstart for new developers. Choose between two paths - Database (create an integrated index, upsert data, and query using Pinecone MCP + Python) or Assistant (create a Pinecone Assistant for document Q&A). Use when a user wants to get started with Pinecone for the first time or wants a guided tour of Pinecone's tools.”

01 / THE REASONING

Why this made the selection.

  • Path A is a fixed, checkable loop: list-indexes to test the key, create-index-for-model for a serverless index quickstart-skills (aws, us-east-1, llama-text-embed-v2, text mapped to chunk_text), a bundled upsert of nine records with pinecone==9.1.0, search-records queries that share no keywords with the records, and optional bge-reranker-v2-m3 reranking.
  • Path B reuses the sibling pinecone-assistant scripts to create an assistant, upload .pdf, .md, .txt or .docx files and ask a question that is answered with citations, so both Pinecone products start from one skill.
  • Pinecone publishes it in pinecone-io/skills, which the README calls Pinecone's official Agent Skills library, under the MIT License.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/pinecone-quickstart/SKILL.md
  • skills/pinecone-quickstart/scripts/upsert.py
  • skills/pinecone-quickstart/scripts/quickstart_complete.py
  • skills/pinecone-assistant/scripts/create.py
  • skills/pinecone-assistant/scripts/upload.py
  • README.md
  • LICENSE
  • targets/README.md
  • targets/claude-code.yaml
  • targets/codex.yaml
  • targets/cursor.yaml
  • The git tree at 885dc539, which holds nine skills/*/SKILL.md files

Our findings

  • Path A uses Pinecone MCP tool calls plus a bundled Python upsert script; Path B delegates to the sibling pinecone-assistant skill's create, upload and chat scripts.
  • Both bundled quickstart scripts pin pinecone==9.1.0 in uv inline metadata and stop if PINECONE_API_KEY is unset.
  • upload.py's default patterns include **/*.json, which SKILL.md's list of accepted file types does not mention.
  • The base SKILL.md holds unfilled snippet markers; targets/claude-code.yaml fills clarify_style with an instruction to use the AskUserQuestion tool and api_key_setup with a shell export line.
  • The scripts pass source_tag values to the Pinecone client, and create.py stores agentic-ide-source metadata on each assistant it creates.

Not established by this review

  • Not executed: it was not installed or run.
  • No index or assistant was created, no records or files were uploaded, and no search or rerank was run.
  • The Pinecone MCP server, the Claude Code plugin repository and the docs.pinecone.io pages were not read.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The README prints `npx skills add pinecone-io/skills`. It installs all nine SKILL.md skills under skills/ at this revision, not this skill alone.
  2. For Claude Code the README says to try Pinecone's plugin at https://github.com/pinecone-io/pinecone-claude-code-plugin instead; that repository was not reviewed here.
  3. Before use, create an API key and run `export PINECONE_API_KEY="your-key"`, as the README prerequisites say. The README lists the Pinecone MCP server and uv as optional; this skill's Path A calls the Pinecone MCP tools, and both paths run their scripts with `uv run`.

Before you start

  • A Pinecone account and API key
  • The Pinecone MCP server for Path A
  • uv to run the bundled scripts, which declare requires-python >=3.10

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/skills/pinecone-quickstart/SKILL.md

    Supports: upstreamDescription, homepage, whySelected, bestFor, limitations[1], limitations[2], limitations[3], limitations[4], access.permissions, install.prerequisites, review.findings

  2. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/README.md

    Supports: compatibility, install, whySelected, limitations[1], limitations[2], limitations[5], access.cost, review.findings

  3. MIT LICENSE at 885dc539 ↗Checked

    https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/LICENSE

    Supports: license, whySelected, limitations[6]

  4. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/skills/pinecone-quickstart/scripts/upsert.py

    Supports: whySelected, language, access.permissions, install.prerequisites, review.findings

  5. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/skills/pinecone-quickstart/scripts/quickstart_complete.py

    Supports: bestFor, limitations[4], access.permissions, review.findings

  6. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/skills/pinecone-assistant/scripts/create.py

    Supports: access.permissions, review.findings

  7. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/skills/pinecone-assistant/scripts/upload.py

    Supports: limitations[3], access.permissions, review.findings

  8. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/targets/README.md

    Supports: limitations[2], review.findings

  9. https://github.com/pinecone-io/skills/blob/885dc539fbc2c777dee9764a5b05656663b43c5f/targets/claude-code.yaml

    Supports: limitations[5], access.permissions, review.findings

Evidence & Ask