skills-index-snippets

1# Maintaining Skill Index Snippets (AGENTS.md / CLAUDE.md)
2 
3## When to Use This Skill
4 
5Use this skill when:
6- Adding, removing, or renaming any skills or agents in this repository
7- Updating `.claude-plugin/plugin.json`
8- Creating copy/paste snippets for downstream repositories (OpenCode, Claude Code, etc.)
9- You want a compact, always-on index that improves skill utilization
10 
11## Goal
12 
13Make skills and agents easy for coding assistants to use by removing the decision point.
14 
15Instead of hoping an assistant will "remember" to invoke a skill, provide a small router snippet inside `AGENTS.md` / `CLAUDE.md` that:
16 
171) Tells the assistant to prefer retrieval-led reasoning
182) Provides a task->skill/agent routing index
193) Defines lightweight quality gates (optional)
20 
21## Source of Truth
22 
23- Registry: `.claude-plugin/plugin.json`
24  - Skills are listed as directories (each contains `SKILL.md`)
25  - Agents are listed as markdown files in `agents/`
26- Skill IDs: the `name:` field in each `SKILL.md` frontmatter
27- Agent IDs: the `name:` field in each agent frontmatter
28 
29When writing snippets for downstream repos, always reference skills/agents by their IDs (frontmatter `name`), not by local filesystem paths.
30 
31## Minimal Snippet Template (Readable)
32 
33Use this in target repos to route common tasks:
34 
35```markdown
36# Agent Guidance: dotnet-skills
37 
38IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
39…