| name | topic-nome-da-skill |
| description | [OBRIGATORIO se a skill deve carregar sempre que X — use OBRIGATORIO/SEMPRE/antes de no inicio.]
Descreva o que a skill faz e quando deve ser usada.
Inclua palavras-gatilho concretas que o usuario tipicamente usa (verbos, substantivos, frases).
[Para skills cross-cutting:] Frases-gatilho: "concluido", "feito", "X", "Y".
[Opcional:] Garante que <regra> nao seja violada silenciosamente.
Use prefixo de topico no nome: architecture-, process-, workflow-, language-, greeting-, testing-, quality-, framework-, security-, operational-, documentation-, coding-.
|
Nome da Skill
Explique de forma objetiva o comportamento que o agente deve adotar quando esta skill for acionada. Uma frase de propósito; o resto vai nas seções.
Quando rodar
- Cenário 1 em que a skill deve carregar (palavras/contextos específicos).
- Cenário 2.
Fluxo
- Passo concreto e operacional.
- Próximo passo.
- Quando a tarefa envolver nomenclatura, estrutura ou convenções de stack, consulte primeiro as rules aplicáveis em
.agents/rules.
- Validação ao final, quando houver forma prática de validar.
Regras / Pontos a verificar
- Regra operacional 1 — descreva comportamento observável.
- Regra operacional 2.
- Mantenha instruções curtas e específicas.
Anti-padrões
- Anti-padrão 1 (com sintoma detectável quando possível).
- Anti-padrão 2.
Exemplo: errado vs certo
Errado — descrição curta do que evitar:
Certo — descrição curta da alternativa:
Output verificável (quando aplicável)
Auto-verificação antes de enviar
Antes de submeter o resumo final, releia:
- A resposta tem a seção X? Se não, VOLTE e adicione.
- Aplicou a regra Y a cada item afetado? Se não, VOLTE e corrija.
- Frases de conclusão correspondem ao estado real da checklist? Se não, VOLTE e ajuste.
Referências cruzadas
- Ver
process-tdd para o ciclo TDD completo.
- Ver
quality-revisao-aderencia para o formato de revisão final.
- Ver rules de nomenclatura/estrutura em
.agents/rules/naming-structure-<linguagem>.md.
Checklist
- Item operacional verificável 1.
- Item operacional verificável 2.
- Comando ou ferramenta foi executado quando aplicável.
- Output verificável foi incluído no resumo final, se a skill exige.