# Skills Index Snippets

Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the...

- Repository: https://github.com/Aaronontheweb/dotnet-skills (1244 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Aaronontheweb/dotnet-skills --skill skills-index-snippets -g -a claude-code -y`
Codex: `npx skills add Aaronontheweb/dotnet-skills --skill skills-index-snippets -g -a codex -y`
Cursor: `npx skills add Aaronontheweb/dotnet-skills --skill skills-index-snippets -g -a cursor -y`
Gemini CLI: `npx skills add Aaronontheweb/dotnet-skills --skill skills-index-snippets -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Aaronontheweb/dotnet-skills`

## Description

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).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

```markdown
# Agent Guidance: dotnet-skills

IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
Workflow: skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- C# / code quality: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance
- ASP.NET Core / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing
- Data: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testing: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing

The rest: https://github.com/Aaronontheweb/dotnet-skills/blob/HEAD/skills/skills-index-snippets/SKILL.md