Testar e distribuir skills
Itere skills e compartilhe com o time
⏱ Estim. ~6 min
01 · Ler
Escrever a skill é só metade do trabalho. Você precisa testar — e iterar.
Uma skill que parece certa no papel pode produzir saída inconsistente na prática. Pode ser que o Claude siga 4 das suas 5 regras e ignore uma. Pode ser que ele interprete uma instrução vaga de um jeito diferente do seu.
O ciclo de teste é simples: ative a skill, dê ao Claude uma tarefa que deveria disparar a skill, confira se a saída segue suas regras e, se não seguir, refine a skill.
Assim como código, skills ficam melhores por iteração. A maioria das skills precisa de 2 a 3 rodadas de refinamento até funcionar de forma estável.
Pontos-chave
- Teste skills ativando com /skill e dando uma tarefa relevante ao Claude
- Confira a saída contra cada regra do corpo da skill
- Teste casos limite — o que acontece com entradas inesperadas?
- Itere: a maioria das skills exige 2 a 3 rodadas de refinamento
- Versione skills com git — elas são apenas arquivos
02 · Passo a passo
Siga este fluxo toda vez que criar ou atualizar uma skill.
1. Crie ou atualize a skill
Escreva ou edite o arquivo SKILL.md. Salve em .claude/skills/your-skill/SKILL.md. Se for uma atualização, mude um ponto por vez para conseguir enxergar o efeito.
2. Ative com /skill
Em uma conversa do Claude Code, digite /skill e escolha sua skill na lista. O Claude carrega as instruções e segue durante o resto da conversa.
3. Dê ao Claude uma tarefa relevante
Peça ao Claude para fazer algo que deveria disparar as regras da sua skill. Skill de code review: peça uma revisão. Skill de commit message: peça um commit. Use entradas reais, não exemplos de brincadeira.
4. Confira a saída
A saída segue cada regra da sua skill? Vá item por item de cada lista, cada requisito de formato, cada restrição. Confira a fundo — atender parcialmente significa que a skill precisa ser refinada.
5. Refine e repita
Se algo não bateu, atualize o corpo da skill. Seja mais explícito onde o Claude desviou. Adicione exemplos da saída correta. Tire frases vagas. Depois teste de novo com a mesma tarefa.
6. Faça commit com git
Quando a skill funcionar de forma estável em vários casos de teste, faça commit. Skills são apenas arquivos — pertencem ao controle de versão, como qualquer outra coisa. git add .claude/skills/ && git commit -m 'feat: add code-reviewer skill'
03 · Ler
Depois que a skill funcionar de forma estável, decida onde ela vive. Na primeira lição você aprendeu que existem dois lugares: skills de projeto (.claude/skills/) vão por commit no git e são compartilhadas com o time, e skills de usuário (~/.claude/skills/) são pessoais e valem em todos os seus projetos.
A regra é simples: se é convenção do time, faça commit como skill de projeto. Se é preferência pessoal, mantenha como skill de usuário.
Pontos-chave
- Skills de projeto: commit no git → o time inteiro se beneficia
- Skills de usuário: ficam locais → só sua preferência pessoal
- Faça commit das skills de projeto como qualquer outra mudança de código
04 · Quiz
Você acabou de criar uma skill que aplica o formato de mensagens de commit do time: cada commit começa com um prefixo de tipo, como 'feat:' ou 'fix:'. Isso deve ser skill de projeto ou de usuário?
- Skill de projeto — é convenção do time, vai por commit no git
- Skill de usuário — fica em ~/.claude/skills/ para uso pessoal
- Qualquer um dos dois serve
- Deveria estar em um arquivo de configuração, não em uma skill
05 · Preencher
Skills guardadas em ~/.claude/skills/ se chamam skills de _____, porque andam com você por todos os projetos.
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.