Contrato de Ativação
Use esta habilidade ao auditar, refatorar, normalizar ou melhorar arquivos SKILL.md existentes. Use gentle-ai-skill-creator ao criar uma nova habilidade a partir de um padrão reutilizável.
Regras Rígidas
- Leia
docs/skill-style-guide.mdprimeiro e trate-o como o contrato de estilo normativo. - Trate
SKILL.mdcomo a fonte da verdade; preserve a intenção do autor, regras críticas, semântica de ativação e requisitos de saída. - Use
.atl/skill-registry.mdcomo um índice de nomes de habilidades, gatilhos, escopos e caminhos exatos quando disponível. - Padrão é apenas auditoria. Modifique arquivos apenas quando o usuário solicitar explicitamente a aplicação de melhorias.
- Nunca exclua conteúdo significativo silenciosamente; mova explicações longas, exemplos, modelos ou esquemas para
references/ouassets/locais. - Não invente gatilhos, políticas ou regras de domínio. Marque casos ambíguos para revisão humana.
Portões de Decisão
| Situação | Ação |
|---|---|
| Frontmatter ausente ou inválido | Corrigir name, description de uma linha entre aspas, license e metadata |
| Habilidade parece documentação de tutorial | Converter para instruções de tempo de execução e mover contexto para references/ |
| Corpo excede o orçamento | Preservar regras, mover exemplos/contexto para arquivos de suporte |
| Lógica de ramificação oculta em prosa | Converter para uma tabela de decisão compacta |
| Regras conflitam ou intenção não está clara | Relatar o problema; não reescrever essa regra automaticamente |
Etapas de Execução
- Leia
docs/skill-style-guide.md. - Leia
.atl/skill-registry.md; use os caminhos listados para selecionar habilidades. Se ausente, escaneie diretórios de habilidades conhecidos em busca de*/SKILL.md. - Para cada habilidade selecionada, audite metadados, clareza do gatilho, ordem das seções, orçamento do corpo, capacidade de ação, portões de decisão, contrato de saída e referências locais.
- Retorne um relatório de auditoria agrupado por habilidade com severidade e mudanças exatas propostas.
- No modo de aplicação, edite apenas problemas seguros, preserve conteúdo, crie arquivos de suporte quando necessário, e então atualize ou solicite
/skill-registry:refresh.
Contrato de Saída
Retorne:
- Habilidades auditadas e caminhos utilizados.
- Problemas encontrados, agrupados por severidade.
- Arquivos alterados, se o modo de aplicação foi solicitado.
- Recomendação de atualização do registro quando metadados ou caminhos da habilidade forem alterados.
- Ambiguidades que precisam de revisão humana.
Referências
docs/skill-style-guide.md— guia de estilo normativo para habilidades LLM-first.skills/skill-registry/SKILL.md— contrato de atualização e indexação do registro.