rag-architect
Installation
SKILL.md
RAG Architect
The agent designs, implements, and optimizes production-grade RAG pipelines, from document chunking through evaluation.
Core Capabilities
- Chunking strategy selection — match corpus characteristics to fixed-size, sentence, paragraph, semantic, recursive, or document-aware chunking with sized parameters.
- Embedding & vector-DB choice — pick an embedding model (local vs API) and vector store (Pinecone, Weaviate, Qdrant, Chroma, pgvector) by scale, latency, and cost.
- Retrieval design — dense, sparse (BM25), or hybrid retrieval with Reciprocal Rank Fusion plus cross-encoder reranking when precision must exceed 0.85.
- Query transformations — HyDE, multi-query, and step-back techniques for style mismatch and ambiguous queries.
- Guardrails — PII detection, hallucination/NLI checks, source attribution, confidence scoring, and injection prevention.
- Evaluation — RAGAS faithfulness/relevance plus IR metrics (Precision@K, Recall@K, MRR, NDCG) with failure analysis.
- Production patterns — caching, streaming, fallbacks, incremental re-indexing, and cost control.
When to Use
- Building a RAG system end to end.
- Selecting a chunking strategy or choosing a vector database.
- Optimizing retrieval quality or adding reranking.
- Evaluating a pipeline with RAGAS or IR metrics.