CtrlK
BlogDocsLog inGet started
Tessl Logo

rag-architect

Designs and implements production-grade RAG systems by chunking documents, generating embeddings, configuring vector stores, building hybrid search pipelines, applying reranking, and evaluating retrieval quality. Use when building RAG systems, vector databases, or knowledge-grounded AI applications requiring semantic search, document retrieval, context augmentation, similarity search, or embedding-based indexing.

72

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that clearly articulates specific capabilities, provides comprehensive trigger terms, and explicitly states both what the skill does and when to use it. It uses proper third-person voice throughout and covers the RAG domain thoroughly with distinct, well-chosen terminology that minimizes conflict risk with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: chunking documents, generating embeddings, configuring vector stores, building hybrid search pipelines, applying reranking, and evaluating retrieval quality. These are all distinct, well-defined technical operations.

3 / 3

Completeness

Clearly answers both 'what' (designs and implements production-grade RAG systems with specific sub-tasks) and 'when' (explicit 'Use when...' clause listing multiple trigger scenarios like building RAG systems, vector databases, or knowledge-grounded AI applications).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'RAG systems', 'vector databases', 'semantic search', 'document retrieval', 'context augmentation', 'similarity search', 'embedding-based indexing', 'knowledge-grounded AI applications'. These cover the major ways users would describe this need.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused specifically on RAG systems and vector search pipelines. The combination of RAG-specific terminology (chunking, embeddings, reranking, hybrid search) makes it very unlikely to conflict with other skills like general document processing or generic AI skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

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

This is a strong, actionable RAG skill with excellent executable code examples covering the full pipeline from chunking through evaluation. The workflow is well-sequenced with concrete validation checkpoints. Main weaknesses are the missing bundle reference files that the skill explicitly points to, and some verbosity in the constraints section that restates general engineering best practices Claude already knows.

Suggestions

Create the referenced bundle files (references/vector-databases.md, references/embedding-models.md, etc.) to fulfill the progressive disclosure promises made in the reference table.

Trim the MUST DO / MUST NOT DO lists to only RAG-specific, non-obvious constraints — remove items like 'Store raw documents without preprocessing' and 'Forget to handle edge cases' which are general engineering knowledge.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with executable code examples, but includes some unnecessary guidance that Claude would already know (e.g., 'Evaluate multiple embedding models on your domain data before committing' and several MUST NOT items are general best practices). The constraints section is somewhat verbose with items that are standard engineering practice rather than RAG-specific operational guidance.

2 / 3

Actionability

Provides fully executable, copy-paste-ready Python code for all major RAG components: chunking, embedding/indexing, hybrid search, reranking, and evaluation. Code uses real libraries (langchain, qdrant, cohere, ragas) with concrete parameters and realistic patterns like deterministic ID generation for deduplication.

3 / 3

Workflow Clarity

The 5-step core workflow is clearly sequenced with explicit validation checkpoints after each implementation step (assert statements for metadata, deduplication, search results, and metric thresholds). The instruction to 'validate before moving on' with concrete checkpoint code creates effective feedback loops for error recovery.

3 / 3

Progressive Disclosure

The reference table with 5 detailed topic files and clear 'Load When' guidance is well-structured for progressive disclosure. However, no bundle files are provided, meaning all referenced files (references/vector-databases.md, references/embedding-models.md, etc.) are missing, which undermines the actual utility of the references. The main file itself is fairly long with inline code that could potentially be split out.

2 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jeffallan/claude-skills
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.