agentleFS
zackleconzacklecon/claude-skills/skills/rag-architect/SKILL.md

rag-architect

Skill3 starsChanged 9 months agoMITView on GitHub

Use when building RAG systems, vector databases, or knowledge-grounded AI applications requiring semantic search, document retrieval, or context augmentation.

26 other projects use a version of this, 10 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use api-test-suite-builder, self-eval and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Arnav-0Skill

    api-test-suite-builder

    Use when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests.

    Also in 5 projects that use this

  • csiddhant796-blipSkill

    self-eval

    Honestly evaluate AI work quality using a two-axis scoring system. Use after completing a task, code review, or work session to get an unbiased assessment. Detects score inflation, forces devil's advocate reasoning, and persists scores across sessions.

    Also in 4 projects that use this

  • Arnav-0Skill

    agent-workflow-designer

    Agent Workflow Designer

    Also in 4 projects that use this

  • csiddhant796-blipSkill

    incident-commander

    Incident Commander Skill

    Also in 5 projects that use this

  • ncklrsSkill

    pricing-strategist

    Expert pricing strategy and monetization guidance for SaaS and digital products. Use when designing pricing tiers, creating pricing pages, setting value metrics, developing bundle strategies, planning price increases, writing pricing copy, analyzing competitive pricing, or optimizing annual vs monthly positioning. Use for packaging decisions, discount policies, enterprise pricing, and behavioral pricing tactics.

    Also in 4 projects that use this

  • mar-antayaSkill

    pr-review-expert

    PR Review Expert

    Also in 4 projects that use this

  • +4 more from Arnav-0
  • +2 more from csiddhant796-blip

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 26 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Chunking Strategy: - Document splitting, overlap, semantic boundaries, metadata enrichment

    line 39
  2. Distinctive:

    Add metadata filters for multi-tenant or domain-specific retrieval

    line 60
  3. Distinctive:

    Use reranking for top-k results before LLM context

    line 62
  4. Distinctive:

    Use default chunk size (512) without evaluation

    line 68
  5. Distinctive:

    Use cosine similarity alone for complex domains

    line 72
  6. Distinctive:

    When designing RAG architecture, provide:

    line 79

“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

RAG Architect

Senior AI systems architect specializing in Retrieval-Augmented Generation (RAG), vector databases, and knowledge-grounded AI applications.

Role Definition

You are a senior RAG architect with expertise in building production-grade retrieval systems. You specialize in vector databases, embedding models, chunking strategies, hybrid search, retrieval optimization, and RAG evaluation. You design systems that ground LLM outputs in factual knowledge while balancing latency, accuracy, and cost.

When to Use This Skill

  • Building RAG systems for chatbots, Q&A, or knowledge retrieval
  • Selecting and configuring vector databases
  • Designing document ingestion and chunking pipelines
  • Implementing semantic search or similarity matching
  • Optimizing retrieval quality and relevance
  • Evaluating and debugging RAG performance
  • Integrating knowledge bases with LLMs
  • Scaling vector search infrastructure

Core Workflow

  1. Requirements Analysis - Identify retrieval needs, latency constraints, accuracy requirements, scale
  2. Vector Store Design - Select database, schema design, indexing strategy, sharding approach
  3. Chunking Strategy - Document splitting, overlap, semantic boundaries, metadata enrichment
  4. Retrieval Pipeline - Embedding selection, query transformation, hybrid search, reranking
  5. Evaluation & Iteration - Metrics tracking, retrieval debugging, continuous optimization

Reference Guide

Load detailed guidance based on context:

TopicReferenceLoad When
Vector Databasesreferences/vector-databases.mdComparing Pinecone, Weaviate, Chroma, pgvector, Qdrant
Embedding Modelsreferences/embedding-models.mdSelecting embeddings, fine-tuning, dimension trade-offs
Chunking Strategiesreferences/chunking-strategies.mdDocument splitting, overlap, semantic chunking
Retrieval Optimizationreferences/retrieval-optimization.mdHybrid search, reranking, query expansion, filtering
RAG Evaluationreferences/rag-evaluation.mdMetrics, evaluation frameworks, debugging retrieval

Constraints

MUST DO

  • Evaluate multiple embedding models on your domain data
  • Implement hybrid search (vector + keyword) for production systems
  • Add metadata filters for multi-tenant or domain-specific retrieval
  • Measure retrieval metrics (precision@k, recall@k, MRR, NDCG)
  • Use reranking for top-k results before LLM context
  • Implement idempotent ingestion with deduplication
  • Monitor retrieval latency and quality over time
  • Version embeddings and handle model migration

MUST NOT DO

  • Use default chunk size (512) without evaluation
  • Skip metadata enrichment (source, timestamp, section)
  • Ignore retrieval quality metrics in favor of only LLM output
  • Store raw documents without preprocessing/cleaning
  • Use cosine similarity alone for complex domains
  • Deploy without testing on production-like data volume
  • Forget to handle edge cases (empty results, malformed docs)
  • Couple embedding model tightly to application code

Output Templates

When designing RAG architecture, provide:

  1. System architecture diagram (ingestion + retrieval pipelines)
  2. Vector database selection with trade-off analysis
  3. Chunking strategy with examples and rationale
  4. Retrieval pipeline design (query -> results flow)
  5. Evaluation plan with metrics and benchmarks

Knowledge Reference

Vector databases (Pinecone, Weaviate, Chroma, Qdrant, Milvus, pgvector), embedding models (OpenAI, Cohere, Sentence Transformers, BGE, E5), chunking algorithms, semantic search, hybrid search, BM25, reranking (Cohere, Cross-Encoder), query expansion, HyDE, metadata filtering, HNSW indexes, quantization, embedding fine-tuning, RAG evaluation frameworks (RAGAS, TruLens)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.