skills-index-snippets

Manutenção de Índices de Snippets de Skills (AGENTS.md / CLAUDE.md)

Quando Usar Esta Skill

Use esta skill quando:

• Adicionar, remover ou renomear skills ou agentes neste repositório
• Atualizar .claude-plugin/plugin.json
• Criar snippets copiáveis para repositórios downstream (OpenCode, Claude Code, etc.)
• Você deseja um índice compacto, sempre ativo, que melhora a utilização das skills

Objetivo

Tornar skills e agentes fáceis de usar pelos assistentes de código, eliminando o ponto de decisão.

Em vez de esperar que um assistente "lembre" de invocar uma skill, forneça um pequeno snippet roteador dentro de AGENTS.md / CLAUDE.md que:

1. Instrua o assistente a preferir raciocínio orientado por recuperação (retrieval-led reasoning)
2. Forneça um índice de roteamento tarefa->skill/agente
3. Defina gates de qualidade leves (opcional)

Fonte da Verdade

• Registro: .claude-plugin/plugin.json
  • Skills são listadas como diretórios (cada um contém SKILL.md)
  • Agentes são listados como arquivos markdown em agents/
• IDs das skills: o campo name: no frontmatter de cada SKILL.md
• IDs dos agentes: o campo name: no frontmatter de cada agente

Ao escrever snippets para repositórios downstream, sempre referencie skills/agentes pelos seus IDs (frontmatter name), não por caminhos de sistema de arquivos locais.

Template de Snippet Mínimo (Legível)

Use este template nos repositórios de destino para rotear tarefas comuns:

# Orientação do Agente: dotnet-skills

IMPORTANTE: Prefira raciocínio orientado por recuperação (retrieval-led reasoning) em vez de pré-treinamento para qualquer trabalho .NET.
Fluxo de trabalho: ler padrões do repositório -> consultar dotnet-skills pelo nome -> implementar a menor mudança -> anotar conflitos.

Roteamento (invocar pelo nome)
- C# / qualidade de código: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance
- ASP.NET Core / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing
- Dados: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testes: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing

Gates de qualidade (usar quando aplicável)
- dotnet-slopwatch: após código novo/refatorado/substancial gerado por LLM
- crap-analysis: após testes adicionados ou alterados em código complexo

Agentes especialistas
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist

Template de Snippet Compacto (Estilo Vercel)

Use este template quando desejar máxima densidade (pequeno footprint de contexto):

[dotnet-skills]|IMPORTANTE: Prefira raciocínio orientado por recuperação em vez de pré-treinamento para qualquer trabalho .NET.
|fluxo:{ler padrões do repositório -> consultar dotnet-skills pelo nome -> implementar a menor mudança -> anotar conflitos}
|rota:
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,api-design,type-design-performance}
|aspnetcore-web:{aspire-service-defaults,aspire-integration-testing}
|dados:{efcore-patterns,database-performance}
|di-config:{dependency-injection-patterns,microsoft-extensions-configuration}
|testes:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing}
|gates-qualidade:{dotnet-slopwatch(após:código novo/refatorado/substancial gerado por LLM),crap-analysis(após:testes adicionados ou alterados em código complexo)}
|agentes:{dotnet-concurrency-specialist,dotnet-performance-analyst,dotnet-benchmark-designer,akka-net-specialist,docfx-specialist}

Regenerando o bloco README

Se o README contiver os marcadores abaixo, o gerador pode atualizá-lo automaticamente:

<!-- BEGIN DOTNET-SKILLS COMPRESSED INDEX -->
...snippet compacto...
<!-- END DOTNET-SKILLS COMPRESSED INDEX -->

Execute:

./scripts/generate-skill-index-snippets.sh --update-readme

Como Atualizar Snippets Após Mudanças nas Skills

1. Atualize .claude-plugin/plugin.json para incluir/remover skills e agentes.
2. Certifique-se de que cada skill tenha o campo name: correto no frontmatter (usado por OpenCode e outros).
3. Execute ./scripts/validate-marketplace.sh.
4. Atualize suas listas de roteamento do snippet:
   • Adicione novas skills à categoria correta
   • Remova skills deletadas
   • Mantenha os nomes exatamente iguais aos IDs do frontmatter
5. Se você mantém um snippet AGENTS.md/CLAUDE.md downstream, regenere-o e copie novamente para os repositórios dependentes.

Categorias Recomendadas

Estas são categorias de snippet (não necessariamente estrutura de pastas do repositório):

• C# / qualidade de código
• ASP.NET Core / Web (incl. Aspire)
• Dados
• DI / config
• Testes
• Gates de qualidade
• Agentes especialistas

Mantenha o snippet pequeno; ele deve ser um roteador, não documentação.