O que é SKILL.md e como criar uma primeira skill

SKILL.md é o arquivo que descreve o que uma skill faz, quando deve ser usada e quais passos o agente deve seguir. Ele transforma um procedimento recorrente em instruções reutilizáveis.

Prompt, skill e ferramenta

Um prompt pede um trabalho na conversa. Uma skill guarda um procedimento para reutilizar. Uma ferramenta executa uma operação, como ler um arquivo. A skill orienta o agente, mas não cria por si só acesso a contas ou capacidade de executar ações.

Estrutura mínima

Crie uma pasta revisar-oferta com um arquivo SKILL.md. Exemplo original para adaptar:

---
name: revisar-oferta
description: Revisar textos de páginas de produto para esclarecer preço, entrega e próximo passo.
---
# Revisar oferta
1. Identifique público, produto e ação principal.
2. Confira se preço e conteúdo estão explícitos.
3. Aponte afirmações que precisam de comprovação.
4. Sugira uma versão curta, sem inventar benefícios.
5. Entregue revisão e justificativa; não publique.

Quando incluir outros arquivos

Se o procedimento precisar de modelos, referências ou scripts, mantenha-os junto da skill e explique quando usar cada recurso. Comece com instruções suficientes para uma tarefa; acrescente recursos quando houver uma necessidade concreta.

Como testar sua primeira versão

1. Escolha três páginas de produto com problemas diferentes.
2. Peça a mesma revisão com a skill em cada página.
3. Confira se ela identifica preço ausente, entrega vaga e promessa sem evidência.
4. Experimente um pedido fora do escopo, como corrigir um erro de código.
5. Ajuste a descrição se a skill for acionada em situações erradas.

Guarde os exemplos e compare versões. O objetivo é tornar o procedimento previsível para o seu trabalho, não adicionar instruções para todas as situações imagináveis.

Referências de estrutura: OpenAI e Cursor. Continue com skill-creator para desenvolver a ideia.