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
- santiago-migoni/claude-skillsedited, first seen Nov 8, 2026
- darkweb19/skillstheir own version, first seen Nov 8, 2026
- kazemcodes/skill-treetheir own version, first seen Nov 8, 2026
- AxlZero21/Skillsedited, first seen Nov 8, 2026
- Cure-Consulting-Group/ProductEngineeringSkillstheir own version, first seen Nov 4, 2026
- lsyamsiar/claude-skillsedited, first seen Nov 1, 2026
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-0Skillapi-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-blipSkillself-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-0Skillagent-workflow-designer
Agent Workflow Designer
Also in 4 projects that use this
csiddhant796-blipSkillincident-commander
Incident Commander Skill
Also in 5 projects that use this
ncklrsSkillpricing-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-antayaSkillpr-review-expert
PR Review Expert
Also in 4 projects that use this
- +4 more from Arnav-0
- +2 more from csiddhant796-blip
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 10
- Jeffallan/claude-skills★ 12k29% same
- codeApe-7/ai-agent-workflowGroup★ 1831% same
- PIXARTSeu/Synapse★ 931% same
- AxlZero21/Skills★ 129% same
- Antthonyyy/marketing-agents-kit★ 030% same
- hu465/claude-skills-★ 029% same
- james-paul25/claude-skill★ 030% same
- lsyamsiar/claude-skills★ 029% same
- santiago-migoni/claude-skills★ 029% same
- usmanmubarak1/ClaudeSkilledAgents★ 092% same
Wrote their own version · 16
- kumaran-is/claude-code-onboarding★ 35same name
- Hassaan146/claude-skills★ 18same name
- vignesh2027/Claude-Agentic-Skills2.0-version★ 6same name
- Cure-Consulting-Group/ProductEngineeringSkills★ 3same name
- AllanWessels/Bratan★ 2same name
- csiddhant796-blip/claude-skills-collection★ 2same name
- Hussain-Elfalah/Agentic-Skills★ 2same name
- JoaoEquer/Oficina★ 2same name
- salmandev/everything-gemini★ 2same name
- sohaibdevv/Claude-Agentic-Skills2.0-version★ 2same name
6 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository66 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- angular-architectSkill
- api-designerSkill
- architecture-designerSkill
- atlassian-mcpSkill
- chaos-engineerSkill
- cli-developerSkill
- cloud-architectSkill
- code-documenterSkill
- code-reviewerSkill
- cpp-proSkill
- csharp-developerSkill
- database-optimizerSkill
- debugging-wizardSkill
- devops-engineerSkill
- django-expertSkill
- dotnet-core-expertSkill
- embedded-systemsSkill
- fastapi-expertSkill
- feature-forgeSkill
- fine-tuning-expertSkill
- flutter-expertSkill
- fullstack-guardianSkill
- game-developerSkill
- golang-proSkill
- graphql-architectSkill
- java-architectSkill
- javascript-proSkill
- kotlin-specialistSkill
- kubernetes-specialistSkill
- laravel-specialistSkill
- legacy-modernizerSkill
- mcp-developerSkill
- microservices-architectSkill
- ml-pipelineSkill
- monitoring-expertSkill
- nestjs-expertSkill
- nextjs-developerSkill
- pandas-proSkill
- php-proSkill
- playwright-expertSkill
- postgres-proSkill
- prompt-engineerSkill
- python-proSkill
- rails-expertSkill
- react-expertSkill
- react-native-expertSkill
- rust-engineerSkill
- salesforce-developerSkill
- secure-code-guardianSkill
- security-reviewerSkill
- shopify-expertSkill
- spark-engineerSkill
- spec-minerSkill
- spring-boot-engineerSkill
- sql-proSkill
- sre-engineerSkill
- swift-expertSkill
- terraform-engineerSkill
- test-masterSkill
- The first 60 shown.
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
- Distinctive: line 39
Chunking Strategy: - Document splitting, overlap, semantic boundaries, metadata enrichment
- Distinctive: line 60
Add metadata filters for multi-tenant or domain-specific retrieval
- Distinctive: line 62
Use reranking for top-k results before LLM context
- Distinctive: line 68
Use default chunk size (512) without evaluation
- Distinctive: line 72
Use cosine similarity alone for complex domains
- Distinctive: line 79
When designing RAG architecture, provide:
“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.
Files
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
- Requirements Analysis - Identify retrieval needs, latency constraints, accuracy requirements, scale
- Vector Store Design - Select database, schema design, indexing strategy, sharding approach
- Chunking Strategy - Document splitting, overlap, semantic boundaries, metadata enrichment
- Retrieval Pipeline - Embedding selection, query transformation, hybrid search, reranking
- Evaluation & Iteration - Metrics tracking, retrieval debugging, continuous optimization
Reference Guide
Load detailed guidance based on context:
| Topic | Reference | Load When |
| Vector Databases | references/vector-databases.md | Comparing Pinecone, Weaviate, Chroma, pgvector, Qdrant |
| Embedding Models | references/embedding-models.md | Selecting embeddings, fine-tuning, dimension trade-offs |
| Chunking Strategies | references/chunking-strategies.md | Document splitting, overlap, semantic chunking |
| Retrieval Optimization | references/retrieval-optimization.md | Hybrid search, reranking, query expansion, filtering |
| RAG Evaluation | references/rag-evaluation.md | Metrics, 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:
- System architecture diagram (ingestion + retrieval pipelines)
- Vector database selection with trade-off analysis
- Chunking strategy with examples and rationale
- Retrieval pipeline design (query -> results flow)
- 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)
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
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.

