From agentic-rag
Agentic RAG methodology for Claude Code skills — how to structure large knowledge bases using SKILL.md as a thin router, sections/_index.md as a table of contents, and 30-50 line content files as the actual knowledge. Use when building a skill with >300 lines or >5 distinct topics, or when users ask about SKILL.md structure, sections pattern, skill authoring methodology, knowledge base design, or how to write a large Claude Code skill. Методология agentic RAG для навыков Claude Code — как структурировать большие базы знаний, используя SKILL.md как тонкий роутер, sections/_index.md как оглавление и файлы по 30-50 строк как реальные знания. Применяй когда навык >300 строк или охватывает >5 тем.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agentic-rag:agentic-ragThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
A meta-skill: how to build skills using the agentic RAG pattern.
sections/content-quality/_index.mdsections/content-quality/anti-patterns.mdsections/content-quality/quality-checklist.mdsections/content-quality/references/anti-patterns/01-walls-of-text/README.mdsections/content-quality/references/anti-patterns/01-walls-of-text/bad.mdsections/content-quality/references/anti-patterns/01-walls-of-text/good.mdsections/content-quality/references/anti-patterns/02-duplicate-content/README.mdsections/content-quality/references/anti-patterns/02-duplicate-content/bad.mdsections/content-quality/references/anti-patterns/02-duplicate-content/good.mdsections/content-quality/references/anti-patterns/03-unclear-boundaries/README.mdsections/content-quality/references/anti-patterns/03-unclear-boundaries/bad.mdsections/content-quality/references/anti-patterns/03-unclear-boundaries/good.mdsections/content-quality/references/anti-patterns/04-missing-index/README.mdsections/content-quality/references/anti-patterns/04-missing-index/bad.mdsections/content-quality/references/anti-patterns/04-missing-index/good.mdsections/content-quality/references/anti-patterns/05-router-as-knowledge/README.mdsections/content-quality/references/anti-patterns/05-router-as-knowledge/bad.mdsections/content-quality/references/anti-patterns/05-router-as-knowledge/good.mdsections/description-craft/_index.mdsections/description-craft/description-format.mdA meta-skill: how to build skills using the agentic RAG pattern.
Two live examples in this marketplace: fpf-knowledge (224 sections) and ux-laws (30 sections).
| Signal | Action |
|---|---|
| Skill body > 300 lines | Switch to agentic RAG |
| Knowledge spans > 5 distinct topics | Switch to agentic RAG |
| Users ask for one of many things at a time | Switch to agentic RAG |
| Skill is < 100 lines, one clear purpose | Keep it flat — do NOT over-engineer |
| Quick reference, cheat-sheet, single concept | Keep it flat |
| What you need | Go to |
|---|---|
| Should I use RAG or flat? — decision tree | when-to-use |
| How to structure SKILL.md + sections/ layout | structure |
| How to write description: and triggers | description-craft |
| Anti-patterns + bad vs good examples | content-quality |
| Copy-paste starter-kit to fork right now | templates |
| Plugin vs standalone distribution | distribution |
_index.md of the target section — it lists files with descriptions.Write small files. Be the example you preach.
| # | Section | Files | When to use |
|---|---|---|---|
| 01 | when-to-use | 2 | Decide flat vs RAG, understand triggers |
| 02 | structure | 2 | SKILL.md router pattern, _index.md format, file budget |
| 03 | description-craft | 2 | Frontmatter triggers, EN/RU bilingual, model-invocation rules |
| 04 | content-quality | 2 | Anti-patterns (5+) with bad/good examples |
| 05 | templates | 3+ | Copy-pasteable starter-kit ready to fork |
| 06 | distribution | 2 | Plugin (marketplace) vs standalone (npx skills), CI sync |
npx claudepluginhub forgeplan/marketplace --plugin agentic-ragGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.