guia · grátis

Como escrever um SKILL.md que funciona

A maioria das skills falha por um motivo só: o Claude não sabe QUANDO usar. Aqui vai o molde de SKILL.md que dispara na hora certa, e o erro que quase todo mundo comete.

SKILL.md---name: minha-skilldescription: quando usar---o gatilhoa skill disparana hora certa, sozinha
o molde
1Nomecurto e claro
2Descriptiono gatilho
3Corpoo passo a passo
4Testarpeça o gatilho
01

O frontmatter

name + description

Toda skill começa com um bloco de frontmatter. O name é o identificador; a description é o que faz o Claude decidir usar (ou ignorar) a skill.

02

A description é tudo

o ponto cego
RegraDiga o GATILHO explícito: "use quando o usuário pedir X". Description vaga é skill que nunca roda, por melhor que seja o resto.
IncluaAs palavras que a pessoa realmente digita e exemplos de pedido. É com isso que o Claude casa a hora de usar.
03

O corpo: passo a passo

Depois do frontmatter, escreva as instruções como uma receita: passos numerados, o que ler antes, o que produzir e como verificar. Curto e específico rende mais que longo e genérico.

04

Teste o gatilho

a prova real

Peça no chat exatamente o cenário da description e veja se a skill dispara sozinha. Se não disparar, o problema quase sempre é a description, não o corpo.

Quer ir além dos guias?

O mini-curso grátis de Claude Code já está no ar, com aulas liberadas aos poucos. O curso completo está em produção: salve a sua vaga por lá.

Assistir ao mini-curso grátis

Dúvida? me chama 🚀 · voltar ao site