Skip to main content
skill CX Codex

rag-architect · borghei — Claude Code skill: what it does, how to install

rag-architect — a skill for Claude Code and Cursor designs RAG pipelines and tunes chunking configurations. It benchmarks retrieval quality using Recall@K and MRR on real queries.

LicenseRef-MIT-Commons-Clause 137 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill rag-architect -a claude-code
Open on GitHub

What rag-architect does

The skill architectures retrieval-augmented generation setups and inspects why existing systems fail to return relevant context. Three bundled CLI scripts drive the workflow: rag_pipeline_designer.py drafts the component layout with cost estimates, chunking_optimizer.py tests 12 chunking modes on corpus samples, and retrieval_evaluator.py scores query matches against TF-IDF baselines.

Validation halts without a ground truth dataset of 50 or more real query-document pairs. Running the evaluation script also requires local Python 3 execution directly in the skill directory.

What it helps with

  • design an end-to-end RAG architecture with cost estimates
  • pick optimal chunking parameters for a specific corpus
  • evaluate embedding models against a TF-IDF baseline
  • diagnose retrieval failures using Recall@K and MRR metrics

Example prompts for the agent

  • Analyze the document corpus in assets/corpus and recommend chunking settings
  • Draft a RAG architecture from requirements.json and calculate monthly costs
  • Run retrieval evaluation on sample_queries.json against ground truth

How to install rag-architect

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill rag-architect -a claude-code

2Manually: put the files in place

~/.claude/skills/rag-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/rag-architect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about rag-architect

How do I install rag-architect in Claude Code?

Run npx skills add borghei/Claude-Skills --skill rag-architect -a claude-code. The skill file is placed at ~/.claude/skills/rag-architect/SKILL.md.

What does rag-architect do?

It guides RAG pipeline design, vector database selection, and chunking tuning based on empirical retrieval benchmarks.

What CLI tools are included in the skill?

It includes rag_pipeline_designer.py for pipeline planning, chunking_optimizer.py for text segmentation tests, and retrieval_evaluator.py for scoring search quality.

Similar skills

All skills for AI and ML →

rag-architect by other authors comes first.

rag-architect https://github.com/Jeffallan rag-architect designs production RAG systems: chunks documents, generates embeddings, configures vector stores, builds hybrid search pipelines, and evaluates retrieval quality. CX Codex +1 5,100installs rag-architect Alireza Rezvani rag-architect is a Claude Code skill that designs a RAG pipeline around your documents and measures retrieval quality. It helps compare chunking strategies, embeddings, and vector databases. CX Codex +1 629installs rag-architect Vasallo94 rag-architect — a skill for editing a LangGraph-based RAG pipeline: its graph nodes, hybrid retrieval, and LLM prompts. CX Codex +1 1installs rag-implementer oakoss rag-implementer guides an agent through a retrieval-augmented generation build, from chunking and embeddings to hybrid retrieval and quality metrics. CX Codex +1 121installs rag giuseppe-trisciuoglio rag guides the creation of Retrieval-Augmented Generation pipelines, covering document chunking, embedding generation, vector database selection, and retrieval. CX Codex +1 3,900installs rag-engineer sickn33 The rag-engineer skill guides RAG design for LLM apps, from document chunking and embeddings to retrieval filters and evaluation. Use it when planning a document search pipeline. CX Codex +1 1,000installs RAG Implementer daffy0208 RAG Implementer — a skill that walks the agent through eight phases of a RAG build, from knowledge-base design to retrieval, after checking that RAG is the right call. CX Codex +1 189installs langchain-rag langchain-ai langchain-rag equips coding agents with reference RAG implementations in Python and TypeScript using LangChain loaders, splitters, and vector stores. CX Codex +1 18,600installs ai-data-engineering-rag-pipeline reason-machines ai-data-engineering-rag-pipeline is a Claude Code skill for building a local RAG workflow with BM25 retrieval, hierarchical document chunks, and retrieval scoring. It tests retrieval against a prepared set of questions. CX Codex +1 165installs

From the same set120

The whole set →
tdd-guide The tdd-guide Claude Code skill guides red-green-refactor cycles and works with test suites. It can draft tests from requirements and inspect coverage reports for gaps. CX Codex +1 143installs landing-page-generator The landing-page-generator Claude Code skill plans and builds landing pages around one conversion goal. It also supports campaign and lead-capture pages. CX Codex +1 142installs content-strategy content-strategy guides content planning by structuring topic clusters, defining content pillars, and auditing published material. CX Codex +1 140installs atlassian-templates atlassian-templates — a skill to build, validate, and manage Jira and Confluence templates across your organization. CX Codex +1 140installs interview-system-designer interview-system-designer — a skill for Claude Code and five other platforms that builds structured interview loops, writes questions with scoring rubrics, and runs calibration analysis on past results. CX Codex +1 137installs devops-workflow-engineer devops-workflow-engineer generates GitHub Actions workflows, analyzes pipelines for bottlenecks and builds deployment plans with strategy selection. CX Codex +1 136installs skill-tester skill-tester — a skill for Claude Code validates skill packages, runs Python checks, and scores quality. It fits workflows for building, auditing, or publishing a skill. CX Codex +1 136installs risk-management-specialist risk-management-specialist — a skill for medical device risk management under ISO 14971:2019: planning, hazard analysis, risk control and post-production monitoring. CX Codex +1 136installs

Project sponsors

Companies that keep this analytics open