pinecone

Managed vector database for production AI applications. Fully managed, auto-scaling, with hybrid search (dense + sparse), metadata filtering, and namespaces. Low latency (<100ms p95). Use for production RAG, recommendation systems, or semantic search at scale. Best for serverless, managed infrastructure.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/rag/pinecone/SKILL.md

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable, code-dense body that gets a user productive quickly, but it stumbles on workflow safety and progressive disclosure: destructive deletes ship without validation steps, and the provided deployment.md reference is neither linked nor leveraged to shed duplicated content.

Suggestions

Add an explicit validation/confirmation checkpoint before destructive delete operations (e.g., require describe_index_stats output or a typed confirm before index.delete(delete_all=True)).

Link references/deployment.md from the body (e.g., a '## Deployment' section pointing to it) and remove the duplicated serverless/pod, hybrid, namespaces, and metadata-filtering blocks to thin the SKILL.md body.

Move the time-sensitive 'Pricing (as of 2025)' block into the deployment reference or a clearly dated section so stale figures do not consume the SKILL.md token budget.

Dimension	Reasoning	Score
Conciseness	Largely lean and code-forward with minimal concept explanation, but the time-sensitive 'Pricing (as of 2025)' section and duplication of serverless/pod, hybrid, namespaces, and metadata-filtering content with deployment.md keep it just below a 5.	4 / 5
Actionability	Provides copy-paste-ready executable Python covering install, init, create index, upsert, query, filtering, namespaces, hybrid search, and LangChain/LlamaIndex integration — comprehensive coverage of the common cases.	5 / 5
Workflow Clarity	A rough Quick start sequence exists, but destructive and batch operations ('delete entire index', 'delete by filter', batch upserts) lack any validation or confirmation checkpoint, which caps this dimension at 3 per the rubric.	3 / 5
Progressive Disclosure	Section headers give decent structure, but the bundle file references/deployment.md is never linked from the body and much of its content (serverless vs pod, hybrid search, namespaces, metadata filtering) is duplicated inline rather than split out.	3 / 5
	Total	15 / 20 Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, concise description that answers both what and when with concrete trigger phrases and specific capabilities. Voice is correctly third person throughout. Main weakness is feature-framing rather than action-framing and minor synonym gaps in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists several concrete capabilities — 'hybrid search (dense + sparse), metadata filtering, and namespaces', 'auto-scaling', 'Low latency (<100ms p95)' — but frames them as features rather than the explicit action verbs the anchor-5 example uses.	4 / 5
Completeness	Clearly states what ('Managed vector database... hybrid search, metadata filtering, namespaces, low latency') and explicit when guidance ('Use for production RAG, recommendation systems, or semantic search at scale'), matching the anchor-5 both-what-and-when pattern.	5 / 5
Trigger Term Quality	Includes natural trigger phrases users would say — 'production RAG, recommendation systems, or semantic search at scale', 'serverless, managed infrastructure' — but omits common synonyms like 'embeddings' or 'retrieval'.	4 / 5
Distinctiveness Conflict Risk	The managed/serverless/auto-scaling framing carves a clear niche, but it could still overlap with other managed vector-DB skills (Weaviate, Chroma) since the description field does not itself name Pinecone.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: OpenLAIR/dr-claw
Path: skills/rag/pinecone/SKILL.md
Commit: 4b35756

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.