From f01d4b4e74279a4cb6835357ef19e3ec25e7500c Mon Sep 17 00:00:00 2001 From: Juan Antonio Osorio Date: Mon, 20 Apr 2026 10:54:11 +0300 Subject: [PATCH 1/2] feat(skills): package 4 Pinecone skills MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Packages 4 non-MCP-dependent skills from pinecone-io/skills (MIT). - pinecone-assistant — managed RAG service (create, upload, sync, chat) - pinecone-cli — terminal-based index and vector management (pc CLI) - pinecone-docs — curated docs reference - pinecone-help — skills overview and getting-started essentials Pinned to upstream 787cd27. Skills intentionally excluded (MCP server dependency): Per skill-criteria.md MCP-server-dependency rule, three upstream skills depend on the Pinecone MCP server (@pinecone-database/mcp — npx-distributed, stdio) which is NOT YET packaged in either the toolhive catalog or dockyard: - pinecone-mcp - pinecone-query - pinecone-quickstart Follow-up: packaging npx/pinecone-mcp in dockyard and registering it in the toolhive catalog would unlock these three skills in a later PR. Security: all 4 pass with only MANIFEST_MISSING_LICENSE. Refs #495 Co-Authored-By: Claude Opus 4.7 (1M context) --- skills/pinecone-assistant/spec.yaml | 23 +++++++++++++++++++++++ skills/pinecone-cli/spec.yaml | 23 +++++++++++++++++++++++ skills/pinecone-docs/spec.yaml | 23 +++++++++++++++++++++++ skills/pinecone-help/spec.yaml | 23 +++++++++++++++++++++++ 4 files changed, 92 insertions(+) create mode 100644 skills/pinecone-assistant/spec.yaml create mode 100644 skills/pinecone-cli/spec.yaml create mode 100644 skills/pinecone-docs/spec.yaml create mode 100644 skills/pinecone-help/spec.yaml diff --git a/skills/pinecone-assistant/spec.yaml b/skills/pinecone-assistant/spec.yaml new file mode 100644 index 0000000..494d0a7 --- /dev/null +++ b/skills/pinecone-assistant/spec.yaml @@ -0,0 +1,23 @@ +# Pinecone pinecone-assistant Skill +# Create, manage, and chat with Pinecone Assistants for document Q&A. +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-assistant:0.1.0 + +metadata: + name: pinecone-assistant + description: "Create, manage, and chat with Pinecone Assistants for document Q&A with citations — fully managed RAG (create, upload, sync, chat, context retrieval, list) via bundled uv-run Python scripts" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-assistant" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." diff --git a/skills/pinecone-cli/spec.yaml b/skills/pinecone-cli/spec.yaml new file mode 100644 index 0000000..718d019 --- /dev/null +++ b/skills/pinecone-cli/spec.yaml @@ -0,0 +1,23 @@ +# Pinecone pinecone-cli Skill +# Manage Pinecone resources from the terminal with the `pc` CLI. +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-cli:0.1.0 + +metadata: + name: pinecone-cli + description: "Use the Pinecone CLI (`pc`) to manage Pinecone resources from the terminal — supports all index types (standard, integrated, sparse) and all vector operations; backups, namespaces, CI/CD automation" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-cli" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." diff --git a/skills/pinecone-docs/spec.yaml b/skills/pinecone-docs/spec.yaml new file mode 100644 index 0000000..a1ddcef --- /dev/null +++ b/skills/pinecone-docs/spec.yaml @@ -0,0 +1,23 @@ +# Pinecone pinecone-docs Skill +# Curated documentation reference index for developers building with Pinecone. +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-docs:0.1.0 + +metadata: + name: pinecone-docs + description: "Curated Pinecone documentation reference — organized links by topic (getting started, indexes, upsert, search, production) and data format references for vectors and records" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-docs" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." diff --git a/skills/pinecone-help/spec.yaml b/skills/pinecone-help/spec.yaml new file mode 100644 index 0000000..b3198a9 --- /dev/null +++ b/skills/pinecone-help/spec.yaml @@ -0,0 +1,23 @@ +# Pinecone pinecone-help Skill +# Overview of available Pinecone skills and getting-started essentials. +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-help:0.1.0 + +metadata: + name: pinecone-help + description: "Overview of available Pinecone skills and getting-started essentials — what a user needs (account, API key, optional CLI/MCP/uv) and which skill to use for each Pinecone task" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-help" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." From 2300a44717d2fcc3cdee9c9137657f256f6d2143 Mon Sep 17 00:00:00 2001 From: Juan Antonio Osorio Date: Mon, 20 Apr 2026 11:03:08 +0300 Subject: [PATCH 2/2] feat(skills): add 3 MCP-dependent Pinecone skills MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Pinecone MCP server is now being registered in the toolhive catalog (stacklok/toolhive-catalog PR) and packaged in dockyard (stacklok/dockyard#509), satisfying the skill-criteria.md requirement that 'every referenced MCP server must already be included in the catalog'. These three previously-excluded skills are therefore eligible for inclusion: - pinecone-mcp — Pinecone MCP server tools reference - pinecone-query — natural-language query via search-records - pinecone-quickstart — two-path onboarding (Database via MCP, Assistant) Pinned to upstream 787cd27 (same as the other 4 Pinecone skills). Security: all 3 pass with only MANIFEST_MISSING_LICENSE. Refs #495 Co-Authored-By: Claude Opus 4.7 (1M context) --- skills/pinecone-mcp/spec.yaml | 25 +++++++++++++++++++++++++ skills/pinecone-query/spec.yaml | 24 ++++++++++++++++++++++++ skills/pinecone-quickstart/spec.yaml | 24 ++++++++++++++++++++++++ 3 files changed, 73 insertions(+) create mode 100644 skills/pinecone-mcp/spec.yaml create mode 100644 skills/pinecone-query/spec.yaml create mode 100644 skills/pinecone-quickstart/spec.yaml diff --git a/skills/pinecone-mcp/spec.yaml b/skills/pinecone-mcp/spec.yaml new file mode 100644 index 0000000..0071083 --- /dev/null +++ b/skills/pinecone-mcp/spec.yaml @@ -0,0 +1,25 @@ +# Pinecone pinecone-mcp Skill +# Reference for the Pinecone MCP server tools. +# Depends on: Pinecone MCP server (packaged in toolhive-catalog under +# registries/*/servers/pinecone; dockyard ghcr.io/stacklok/dockyard/npx/pinecone-mcp). +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-mcp:0.1.0 + +metadata: + name: pinecone-mcp + description: "Reference for the Pinecone MCP server tools — list-indexes, describe-index, describe-index-stats, create-index-for-model, upsert-records, search-records, cascading-search, rerank-documents, search-docs" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-mcp" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." diff --git a/skills/pinecone-query/spec.yaml b/skills/pinecone-query/spec.yaml new file mode 100644 index 0000000..83e3e5a --- /dev/null +++ b/skills/pinecone-query/spec.yaml @@ -0,0 +1,24 @@ +# Pinecone pinecone-query Skill +# Query Pinecone integrated indexes using text via the Pinecone MCP server. +# Depends on: Pinecone MCP server (packaged in toolhive-catalog). +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-query:0.1.0 + +metadata: + name: pinecone-query + description: "Query Pinecone integrated indexes using natural-language text via the Pinecone MCP — search-records with filtering and reranking; interactive argument resolution via list-indexes and describe-index when the user omits required fields" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-query" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter." diff --git a/skills/pinecone-quickstart/spec.yaml b/skills/pinecone-quickstart/spec.yaml new file mode 100644 index 0000000..0439fa8 --- /dev/null +++ b/skills/pinecone-quickstart/spec.yaml @@ -0,0 +1,24 @@ +# Pinecone pinecone-quickstart Skill +# Interactive quickstart for new Pinecone developers. +# Depends on: Pinecone MCP server (packaged in toolhive-catalog). +# Source: https://github.com/pinecone-io/skills +# Will publish as: ghcr.io/stacklok/dockyard/skills/pinecone-quickstart:0.1.0 + +metadata: + name: pinecone-quickstart + description: "Interactive Pinecone quickstart — two paths: Database (create integrated index, upsert sample data, semantic search via Pinecone MCP + Python) or Assistant (document Q&A via Pinecone Assistant)" + +spec: + repository: "https://github.com/pinecone-io/skills" + ref: "787cd274ffeae942c9dcd693eadb86bafcacca19" # main as of 2026-03-11 + path: "skills/pinecone-quickstart" + version: "0.1.0" + +provenance: + repository_uri: "https://github.com/pinecone-io/skills" + repository_ref: "refs/heads/main" + +security: + allowed_issues: + - rule_id: MANIFEST_MISSING_LICENSE + reason: "pinecone-io/skills is licensed MIT at the repository root; upstream does not embed an SPDX license identifier in per-skill SKILL.md frontmatter."