Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct dotnet-skills skills and agents (including compressed Vercel-style indexes).

Maintaining Skill Index Snippets (AGENTS.md / CLAUDE.md) When to Use This Skill Use this skill when: Adding, removing, or renaming any skills or agents in this repository Updating .claude plugin/plugin.json Creating copy/paste snippets for downstream repositories (OpenCode, Claude Code, etc.) You want a compact, always on index that improves skill utilization Goal Make skills and agents easy for coding assistants to use by removing the decision point. Instead of hoping an assistant will "remember" to invoke a skill, provide a small router snippet inside AGENTS.md / CLAUDE.md that: 1) Tells the assistant to prefer retrieval led reasoning 2) Provides a task skill/agent routing index 3) Defines lightweight quality gates (optional) Source of Truth Registry: .claude plugin/plugin.json Skills are listed as directories (each contains SKILL.md ) Agents are listed as markdown files in agents/ Skill IDs: the name: field in each SKILL.md frontmatter Agent IDs: the name: field in each agent frontmatter When writing snippets for downstream repos, always reference skills/agents by their IDs (frontmatter name ), not by local filesystem paths. Minimal Snippet Template (Readable) Use this in target repos to route common tasks: Compressed Snippet Template (Vercel style) Use this when you want maximum density (small context footprint): Regenerating the README block If the README contains the markers below, the generator can update it automatically: Run: How to Update Snippets After Skill Changes 1. Update .claude plugin/plugin.json to include/remove skills and agents. 2. Ensure each skill has correct frontmatter name: (used by OpenCode and others). 3. Run ./scripts/validate marketplace.sh . 4. Update your snippet routing lists: Add new skills to the right category Remove deleted skills Keep names exactly matching frontmatter IDs 5. If you maintain a downstream AGENTS.md / CLAUDE.md snippet, regenerate it and re copy into dependent repos. Recommended Categories These are snippet categories (not necessarily repository folder structure): C / code quality ASP.NET Core / Web (incl. Aspire) Data DI / config Testing Quality gates Specialist agents Keep the snippet small; it should be a router, not documentation.

skills-index-snippets