---
nome: Criar skill
descricao: transformar um jeito de trabalhar numa skill do PrimoCode — cabeçalho certo, gatilho preciso, texto curto e testado
quando: criar skill, criar uma skill, cria uma skill, crie uma skill, nova skill, new skill, escrever uma skill, skill.md, minha skill, transforma isso em skill, vira skill, virar skill, melhorar a skill, a skill não dispara
autor: adaptado de "skill-creator" (Anthropic, anthropics/skills, Apache-2.0 — ver LICENSE.txt); resumido, traduzido e ajustado ao formato do PrimoCode
---
Uma skill do PrimoCode é um arquivo `SKILL.md`: um cabeçalho e um texto que vai
para o modelo quando o pedido bate. É só texto — nada de script, nada que rode.

**1. Entenda o que a pessoa quer** (se a conversa já mostrou o jeito dela de
trabalhar, tire as respostas dali e só confirme):
- o que a skill faz o agente fazer diferente;
- em que pedidos ela deve entrar — e em quais NÃO;
- como fica o resultado quando dá certo.

**2. O cabeçalho**
```
---
nome: Revisão com lint
descricao: roda o lint e corrige antes de dizer que terminou
quando: lint, eslint, terminar, entregar
autor: você
---
```
O `quando:` decide tudo. São palavras ou expressões separadas por vírgula,
casadas por PALAVRA INTEIRA no pedido (acento e maiúscula não importam). Sem uma
palavra que bata, a skill nunca entra. Palavra comum demais ("fazer", "tudo",
"bem") faz ela entrar em conversa que não tem nada a ver.

**3. O corpo**
- CURTO: até uns 2.500 caracteres. Cada pedido leva no máximo 6.000 caracteres
  de skills somadas; a longa demais fica de fora quando outra também bate.
- No imperativo, e explicando o PORQUÊ ("rode o lint: erro de lint quebra o
  deploy") — regra com motivo é seguida em caso que ela não previu; MAIÚSCULA
  sem motivo, não.
- Um exemplo do resultado esperado vale mais que três parágrafos.
- Nada que a pessoa estranharia se lesse: nada de esconder ação, mandar dado
  para fora ou mexer onde ninguém pediu.

**4. Teste antes de dar por pronta**
- Escreva 2 ou 3 pedidos de verdade, do jeito que a pessoa fala. Cada um tem de
  conter uma palavra do `quando:`; "oi, tudo bem?" não pode conter nenhuma.
- Faça a tarefa com a skill e compare com o que sairia sem ela. Não mudou
  nada? O texto está genérico demais — reescreva.
- Ajuste com o que a pessoa disser, e teste de novo.

**5. Instale.** Salve em `<pasta>/SKILL.md` e diga à pessoa para rodar
`/install-skill <caminho da pasta>`. Ou ela cria direto pelo `/marketplace` →
"New Skill". Com `/skills` ela vê a lista e confirma que a nova está ligada.