CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/llm-tools/pinecone/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

The body is a well-organized, largely executable API reference for Pinecone with concrete code for all core operations and a useful decision table of alternatives. Its weaknesses are duplicated quick-start code, a time-sensitive pricing section, no validation guardrails around destructive delete operations, and a monolithic inline structure that ignores the existing references/deployment.md file.

Suggestions

Add validation/confirmation guidance to the destructive operations (e.g., run describe_index_stats or list matching IDs before index.delete(delete_all=True), and require an explicit re-check after deletion) to lift workflow_clarity past the destructive-operation cap.

Deduplicate the create-index/upsert examples between 'Quick start' and 'Core operations', and move the LangChain/LlamaIndex integrations, pricing, and performance sections into reference files (e.g., link references/deployment.md for deployment patterns, add references/integrations.md) so SKILL.md stays a lean overview.

Move the 'Pricing (as of 2025)' figures into a dated reference section or file so stale time-sensitive numbers don't consume body tokens and mislead later readers.

DimensionReasoningScore

Conciseness

The body is mostly efficient code-plus-comment and avoids explaining what a vector database is, but it could be tightened: the create-index and upsert examples appear nearly duplicated in 'Quick start' and again in 'Core operations', and the time-sensitive 'Pricing (as of 2025)' section sits inline rather than in a dated/deprecated section, which the guidelines penalize. This fits 'mostly efficient but includes some unnecessary... could be tightened' rather than the 4-anchor's only-minor-trimmings.

3 / 5

Actionability

Concrete, largely executable Python for every core operation (create, upsert, query, filter, namespaces, hybrid, delete, index management) with real API calls and parameters, plus a runnable credential check. Not a 5 because placeholders like "values": [0.1, 0.2, ...] and undefined variables (embeddings, metadatas, docs, documents) in the batch-upsert and LangChain/LlamaIndex snippets make them not copy-paste ready.

4 / 5

Workflow Clarity

There is no end-to-end sequence connecting the operations, and the destructive/batch operations — "Delete by ID", "Delete by filter", "Delete all in namespace", "Delete entire index" — have no validation or confirmation checkpoints (the scoring note caps database/destructive skills without feedback loops at 3). The credential check is a lone checkpoint, so this sits at the 'steps listed but validation gaps' anchor rather than 4.

3 / 5

Progressive Disclosure

Section headers give the ~360-line body reasonable structure, but content that belongs in separate files is inlined wholesale (LangChain and LlamaIndex integrations, pricing, performance table), and the existing bundle file references/deployment.md is never referenced or signaled anywhere in the body — a dangling reference. This matches 'references present but not clearly signaled; content that should be separate is inline', rather than 2 because the body's own section organization is decent.

3 / 5

Total

13

/

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 description that clearly states what the service does and when to use it, with concrete capability details (hybrid search, metadata filtering, namespaces, <100ms p95) and natural trigger terms like RAG and semantic search. Main gaps are a few missing synonyms (embeddings, similarity search) and slight overlap risk with other managed vector-database skills.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "hybrid search (dense + sparse), metadata filtering, and namespaces", "auto-scaling", "Low latency (<100ms p95)" — with only minor gaps (core operations like upsert/query are implied rather than named). It matches the 'lists several specific actions; minor gaps in coverage' anchor, and falls short of 5 because it enumerates features of the service more than concrete actions performed.

4 / 5

Completeness

Both questions are answered explicitly: the what ("Managed vector database... hybrid search (dense + sparse), metadata filtering, and namespaces") and the when ("Use for production RAG, recommendation systems, or semantic search at scale"), plus a supplementary "Best for serverless, managed infrastructure" clause. This mirrors the top anchor's explicit what + when with concrete trigger phrases; it is not a 4 because the when-clause is already explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are present: "production RAG", "recommendation systems", "semantic search at scale", "vector database", "serverless". Not a 5 because common synonyms like "embeddings", "similarity search", or "Pinecone" itself (which would anchor triggering to the named product) are missing.

4 / 5

Distinctiveness Conflict Risk

A managed/serverless production vector database is a clear niche with mostly distinct triggers, but the generic phrase "vector database" plus "Best for serverless, managed infrastructure" leaves minor overlap risk with other vector-DB skills (Chroma, Weaviate, Qdrant) in a shared skill set. Not a 5 because the description alone (without the name field) doesn't distinguish the product from competing managed vector databases.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/llm-tools/pinecone/SKILL.md

Reviewed

Table of Contents

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.