Back to catalog
Human reviewedDocuments

Skill dossier

rag-architect

Source declaration

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.

The author's original description, preserved in English. It describes intent, not verified performance.

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.

documentsreferences

Research summary

Human reviewed

Skill Atlas editorial review · editorial-preview-1.0.0

Designs retrieval-augmented generation systems end to end: chunking, embeddings, vector stores, hybrid search, reranking and evaluation.

Review scope

Deterministic static analysis of collected SKILL.md and supporting text/code. Machine-assisted candidates and findings await human editorial review; no dynamic behavior or effect is assessed.

Observable capabilities

  • Analyzes retrieval needs, latency, accuracy and scale before choosing a vector store.
  • Designs a chunking strategy with overlap and metadata enrichment.
  • Builds a retrieval pipeline with embeddings, hybrid vector plus keyword search and reranking.
  • Plans evaluation with precision@k, recall@k and similar metrics, with pass/fail thresholds.

Limitations & scope

  • Example code uses specific providers (OpenAI, Qdrant, Cohere) that may not match your stack.
  • Thresholds such as context_precision >= 0.7 are starting targets, not validated for your data.
  • This review did not execute the examples or verify library APIs.

Relevant for

  • Engineers building knowledge-grounded AI apps
  • Architects comparing vector databases
  • Teams adding retrieval evaluation

What ships with the skill

The file inventory comes from the collected source at the recorded commit. Paths and sizes are structural observations, not a measure of quality.

files
6
Markdown files
6
scripts
0
references
5
Size
106.4 KB
Structural complexity
Moderate

File inventory

PathTypeBytes
skills/rag-architect/references/chunking-strategies.mdReference24.5 KB
skills/rag-architect/references/embedding-models.mdReference15 KB
skills/rag-architect/references/rag-evaluation.mdReference23.7 KB
skills/rag-architect/references/retrieval-optimization.mdReference21.4 KB
skills/rag-architect/references/vector-databases.mdReference13.9 KB
skills/rag-architect/SKILL.mdInstruction7.9 KB

SKILL.md frontmatter

{
  "name": "rag-architect",
  "description": "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.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.1.0",
    "domain": "data-ml",
    "triggers": "RAG, retrieval-augmented generation, vector search, embeddings, semantic search, vector database, document retrieval, knowledge base, context retrieval, similarity search",
    "role": "architect",
    "scope": "system-design",
    "output-format": "architecture",
    "related-skills": "python-pro, database-optimizer, monitoring-expert, api-designer"
  }
}

A reading of the operating sequence

This workflow reconstructs the apparent sequence from source material. Unless controlled evaluation is explicitly recorded, it is provisional—not an observed trace.

  1. 01
    Input

    Requirements analysis

    Identify retrieval needs, latency constraints, accuracy requirements and scale.

  2. 02
    Action

    Build retrieval pipeline

    Select embeddings, add query transformation, hybrid search and reranking.

  3. 03
    Decision

    Validate each step

    Validate before moving on at each step using the checkpoints.

  4. 04
    Output

    Deliver architecture

    Provide architecture diagram, vector DB trade-offs, chunking rationale, pipeline design and evaluation plan.

Potential risk surfaces

Static findings identify points to inspect before installation. They do not establish that a skill is safe, malicious, or effective.

Attention recommended

144 deterministic lexical finding(s) require review across the collected text. Findings can occur in documentation and do not prove execution or exploitability; binary-only files were not scanned.

Network accessObserved
File writesObserved
Credential useObserved
Note

File modification is described or implemented

130 occurrences

This line contains a possible file-write or redirection operation. Check destination paths and overwrite behavior; the static review did not write any file. This rule matched 130 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

High

Dynamic command execution is referenced

A shell, dynamic evaluation, or process execution primitive appears here. Inspect arguments and input control. Presence in source does not prove a command ran. This rule matched 1 location(s) in the collected text; 1 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

High

Credential or secret material is referenced

7 occurrences

This line resembles a credential literal or reads a sensitive environment value. Do not expose its contents; verify whether it is a placeholder, required secret, or accidentally committed material. This rule matched 7 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Medium

Network access is mentioned

6 occurrences

A URL or network client appears in this source line. Review destinations, data sent, and trust boundaries; static text cannot establish actual network activity. This rule matched 6 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Editorial security note

Check how provider API keys are handled; the skill says to load them from environment variables, and its example code calls external embedding and rerank services.

Where context can be spent

Discovery, activation, and resource layers have different meanings. Exact values appear only when the official token-counting method was run with a named model.

Exact token counts unavailable

All token values, including per-file inventory, are null until the pipeline performs an official exact count with an explicit model.

No token measurement was recorded with the required official method. This dossier does not substitute character counts, file sizes, or estimates.

Controlled evaluation

No controlled evaluation

This skill has only the evidence identified above. No task success, token efficiency, latency, or quality advantage is claimed.

Not tested

Use with the source in view

Install command
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # Copy this skill directory into one of: # ~/.claude/skills/rag-architect # .claude/skills/rag-architect
  1. Open the pinned source at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/rag-architect/SKILL.md.
  2. Review the license, prerequisites and all bundled resources.
  3. Install the skill into a personal or project-level Claude Code skills directory.
  4. Restart or refresh Claude Code so the skill can be discovered.
Verify installation

Check that SKILL.md for rag-architect is discoverable at the destination, then ask Claude Code to use it on a small test task.

Prerequisites

  • Example code uses specific providers (OpenAI, Qdrant, Cohere) that may not match your stack.
  • Thresholds such as context_precision >= 0.7 are starting targets, not validated for your data.
  • This review did not execute the examples or verify library APIs.

Example prompts

Representative task

Use the rag-architect skill to design retrieval for our 40k-page internal wiki with per-tenant access. Propose chunking, a vector store, hybrid search with reranking, and an evaluation plan with pass/fail thresholds.

Inspect before use

Read the rag-architect skill files at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/rag-architect/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

A decision, with its limits attached

Strengths

  • Treats retrieval metrics as a gate before LLM integration.
  • Calls for evaluating chunk size and embedding models on domain data.

Considerations

  • Example hybrid search code is illustrative and simplified.
  • Requires external API keys and services.
Research conclusion

A useful architecture checklist for RAG work, best paired with your own data and evaluation set.

Traceable by construction

The dossier is a time-bound reading of a public artifact, not an endorsement. Use the source link to inspect the exact upstream material.

Jeffallanclaude-skillsskills/rag-architect
Source type
Community
Commit
67c1961b180dc92cf08983344627109e983e8f51
Collected
20 Nov 2026
Last checked
20 Nov 2026
Upstream license
MIT
Repository stars
12,464
Content basis

Deterministic lexical parsing, YAML frontmatter validation, file inventory, source-described workflow extraction, and heuristic provisional classification of the supplied files only. Generated by machine; no LLM, execution, dynamic testing, or human editorial approval.