Crie Skills e Comandos Personalizados para o Claude Code
Skills transformam prompts repetitivos em comandos reutilizáveis. Escreva um SKILL.md uma vez, invoque com /nome-da-skill, e o Claude Code executa o fluxo completo.
Skills são arquivos markdown que definem fluxos de trabalho reutilizáveis para o Claude Code. Em vez de digitar o mesmo prompt complexo toda vez que quer fazer deploy, rodar uma code review ou gerar documentação, você escreve um SKILL.md uma vez e invoca com um slash command.
O que é uma Skill do Claude Code?
Uma Skill é um arquivo markdown (SKILL.md) que contém instruções que o Claude Code segue quando você a invoca. Pode incluir descrição, restrições de ferramentas, configurações de contexto e instruções passo a passo. Pense como um prompt salvo com superpoderes.
Como criar uma Skill?
Crie um arquivo SKILL.md no diretório .claude/skills/ do seu projeto (compartilhado com o time) ou em ~/.claude/skills/ (pessoal):
# .claude/skills/deploy.md
---
name: deploy
description: Deploy da branch atual para staging
allowed-tools: Bash, Read
---
## Passos
1. Rode a suíte de testes: `npm run test`
2. Se os testes passarem, builde o projeto: `npm run build`
3. Faça deploy para staging: `npm run deploy:staging`
4. Verifique o deploy checando o endpoint de saúde
5. Poste um resumo do que foi deployadoAgora você pode invocá-la:
# No Claude Code
> /deployQuais opções de frontmatter estão disponíveis?
| Opção | O que faz | Exemplo |
|---|---|---|
| name | Nome do slash command | deploy |
| description | Aparece na lista de skills | Deploy para staging |
| allowed-tools | Restringe quais ferramentas a skill pode usar | Bash, Read, Edit |
| disable-model-invocation | Impede chamadas de IA aninhadas | true |
| context | Tratamento de sessão | fork (roda em contexto isolado) |
Quais são bons casos de uso para Skills?
- +Fluxos de deploy (testar → buildar → deployar → verificar)
- +Checklists de code review (segurança, performance, estilo)
- +Geração de documentação (API docs, changelogs, READMEs)
- +Operações de banco de dados (migração, seed, backup)
- +Onboarding de novos membros (tour do projeto, verificação de setup)
- +Gerenciamento de release (version bump, changelog, tag, publish)
Como usar variáveis em Skills?
Skills suportam argumentos através de $ARGUMENTS (texto completo) e variáveis posicionais ($0, $1, etc.):
# .claude/skills/create-component.md
---
name: create-component
description: Criar um novo componente React
---
Crie um novo componente React chamado $0 no diretório de componentes.
Requisitos:
- TypeScript com interface de props adequada
- Tailwind CSS para estilização
- Exportar como default
- Incluir teste unitário básico em __tests__/
Uso: /create-component UserProfileInvocando com argumentos
# Argumento único
> /create-component UserProfile
# Múltiplos argumentos
> /create-component UserProfile --with-tests --with-storyComo compartilhar Skills com o time?
Coloque Skills no diretório .claude/skills/ do projeto e commite no git. Todo desenvolvedor que clonar o repo recebe as mesmas skills. Skills pessoais vão em ~/.claude/skills/ e não são compartilhadas.
Skills compõem bem com Hooks. Por exemplo, uma skill "deploy" pode acionar um hook PostToolUse que envia uma notificação no Slack após o deploy. Construa sua automação em camadas.