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.

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.

Sabe usar o Claude Code? Agora faz ele trabalhar como um Tech Lead.

O Agent-Driven Protocol transforma o Claude Code num fluxo de 6 fases com 4 aprovações suas e um mapa vivo da arquitetura. A Fase Zero é grátis.

Baixar a Fase Zero · grátisVer o Protocolo Completo · R$47

Dúvida? me chama 🚀 · voltar ao site