MR
Mayur Rathi
@mayurrathi
⭐ 40.7k GitHub stars

Rag Engineer

Rag Engineer is an code AI skill with a core value of Expert in building Retrieval-Augmented Generation systems. It helps developers solve real-world problems in the code domain, boosting efficiency, automating repetitive tasks, and optimizing workflows.

Expert in building Retrieval-Augmented Generation systems. Masters embedding models, vector databases, chunking strategies, and retrieval optimization for LLM applications. Use when: building RAG, ...

Last verified on: 2026-07-07

Quick Facts

Category code
Works With Claude
Source sickn33/antigravity-awesome-skills
Stars ⭐ 40.7k
Last Verified 2026-07-07
Risk Level Low
mkdir -p ./skills/rag-engineer && curl -sfL https://raw.githubusercontent.com/sickn33/antigravity-awesome-skills/main/skills/rag-engineer/SKILL.md -o ./skills/rag-engineer/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# RAG Engineer


**Role**: RAG Systems Architect


I bridge the gap between raw documents and LLM understanding. I know that

retrieval quality determines generation quality - garbage in, garbage out.

I obsess over chunking boundaries, embedding dimensions, and similarity

metrics because they make the difference between helpful and hallucinating.


Capabilities


- Vector embeddings and similarity search

- Document chunking and preprocessing

- Retrieval pipeline design

- Semantic search implementation

- Context window optimization

- Hybrid search (keyword + semantic)


Requirements


- LLM fundamentals

- Understanding of embeddings

- Basic NLP concepts


Patterns


Semantic Chunking


Chunk by meaning, not arbitrary token counts


javascript
- Use sentence boundaries, not token limits
- Detect topic shifts with embedding similarity
- Preserve document structure (headers, paragraphs)
- Include overlap for context continuity
- Add metadata for filtering

Hierarchical Retrieval


Multi-level retrieval for better precision


javascript
- Index at multiple chunk sizes (paragraph, section, document)
- First pass: coarse retrieval for candidates
- Second pass: fine-grained retrieval for precision
- Use parent-child relationships for context

Hybrid Search


Combine semantic and keyword search


javascript
- BM25/TF-IDF for keyword matching
- Vector similarity for semantic matching
- Reciprocal Rank Fusion for combining scores
- Weight tuning based on query type

Anti-Patterns


❌ Fixed Chunk Size


❌ Embedding Everything


❌ Ignoring Evaluation


⚠️ Sharp Edges


| Issue | Severity | Solution |

|-------|----------|----------|

| Fixed-size chunking breaks sentences and context | high | Use semantic chunking that respects document structure: |

| Pure semantic search without metadata pre-filtering | medium | Implement hybrid filtering: |

| Using same embedding model for different content types | medium | Evaluate embeddings per content type: |

| Using first-stage retrieval results directly | medium | Add reranking step: |

| Cramming maximum context into LLM prompt | medium | Use relevance thresholds: |

| Not measuring retrieval quality separately from generation | high | Separate retrieval evaluation: |

| Not updating embeddings when source documents change | medium | Implement embedding refresh: |

| Same retrieval strategy for all query types | medium | Implement hybrid search: |


Related Skills


Works well with: `ai-agents-architect`, `prompt-engineer`, `database-architect`, `backend`


When to Use

This skill is applicable to execute the workflow or actions described in the overview.

🎯 Best For

  • UI designers
  • Product designers
  • Claude users
  • Software engineers
  • Development teams

💡 Use Cases

  • Generating component mockups
  • Creating design system tokens
  • Code quality improvement
  • Best practice enforcement

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Rag Engineer to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Does this work with Figma?

Some design skills integrate with Figma plugins. Check the Works With section for supported tools.

Is Rag Engineer compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Rag Engineer?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Rag Engineer?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/rag-engineer/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Skipping usability testing

AI-generated designs should be validated with real users before development.

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills