CtrlK
BlogDocsLog inGet started
Tessl Logo

rag-architect

Use when the user asks to design a RAG pipeline, choose a chunking strategy or embedding model, pick a vector database, or evaluate retrieval quality (precision@k, recall@k, NDCG). Examples: 'design a RAG system for our docs', 'what chunk size should I use for this corpus', 'evaluate my retriever against ground truth'. NOT for general LLM cost tuning (use llm-cost-optimizer) or agent loops over retrieval (use agenthub).

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, action-oriented skill body with executable tool invocations, an explicit verification loop, and clean progressive disclosure into real reference files. It avoids explaining concepts Claude already knows and keeps the body token-efficient.

DimensionReasoningScore

Conciseness

Lean body that assumes Claude's competence — it never explains what RAG, embeddings, or vector DBs are, and every section (hard rules, tier table, workflow commands) earns its tokens with actionable guidance rather than concept padding.

5 / 5

Actionability

Provides fully executable copy-paste commands for all three tools with real flags and output paths, plus explicit required-keys schemas for the input JSON files and documented output fields.

5 / 5

Workflow Clarity

Four-step pipeline is clearly sequenced (corpus analysis → design → evaluation → verification) with explicit validation checkpoints (precision@5 ≥ 0.8, recall@10 ≥ 0.85) and a feedback loop ('change one variable... and re-run step 3. Repeat').

5 / 5

Progressive Disclosure

Body is a concise overview; detailed strategy comparisons, benchmark methodology, and metric definitions are split into three well-signaled one-level-deep reference files that all exist and are accurately described in the References section.

5 / 5

Total

20

/

20

Passed

Description

100%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 highly specific, well-structured description that uses third person, gives concrete example trigger phrases, and explicitly draws boundaries against neighboring skills. It cleanly satisfies what, when, and distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('design a RAG pipeline, choose a chunking strategy or embedding model, pick a vector database, or evaluate retrieval quality (precision@k, recall@k, NDCG)') with comprehensive coverage of the skill's scope.

5 / 5

Completeness

Explicitly answers both 'what' (design/choose/evaluate RAG components) and 'when' ('Use when the user asks...') with concrete trigger phrases and example utterances.

5 / 5

Trigger Term Quality

Includes literal natural user utterances as examples ('design a RAG system for our docs', 'what chunk size should I use for this corpus', 'evaluate my retriever against ground truth') plus technical synonyms users would say.

5 / 5

Distinctiveness Conflict Risk

Clear RAG-design niche with distinct triggers and explicit boundary guidance ('NOT for general LLM cost tuning (use llm-cost-optimizer) or agent loops over retrieval (use agenthub)') minimizing conflict risk.

5 / 5

Total

20

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
alirezarezvani/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.