⚡ Slash Commands e Skills: Automações Reutilizáveis

Um slash command é um atalho nomeado para um arquivo de instruções. Ao digitar /meu-comando no Claude Code, o modelo carrega o arquivo de skill associado e o executa no contexto atual — como se você tivesse colado todo o conteúdo do arquivo manualmente.

O escopo de um slash command determina onde ele está disponível. Comandos locais vivem no repo e são para aquele projeto. Comandos globais ficam na home e estão disponíveis em qualquer sessão Claude Code.

// .claude/settings.json (local - para o projeto)
{
  "commands": {
    "revisar-pr": {
      "description": "Revisa um PR seguindo os padrões do projeto",
      "file": ".claude/skills/revisar-pr.md"
    },
    "gerar-migration": {
      "description": "Gera SQL de migration para nova tabela",
      "file": ".claude/skills/gerar-migration.md"
    }
  }
}

// ~/.claude/settings.json (global - para o usuário)
{
  "commands": {
    "commit-msg": {
      "description": "Gera mensagem de commit Conventional Commits",
      "file": "~/.claude/skills/commit-msg.md"
    }
  }
}

Uma skill é um arquivo Markdown com instruções detalhadas sobre como executar uma tarefa específica. É o "manual de execução" que o Claude recebe quando você aciona um slash command — pode ter contexto, exemplos, regras, checklists e referências.

# Skill: Revisar Pull Request

## Objetivo
Revisar o PR atual seguindo os padrões de qualidade do projeto.

## Passos obrigatórios

1. Leia o diff completo com `git diff main...HEAD`
2. Para cada arquivo modificado:
   - Verifique nomenclatura (camelCase para funções, PascalCase para classes)
   - Verifique que funções públicas têm testes correspondentes
   - Verifique que não há `console.log` ou `debugger` residuais
3. Verifique cobertura de testes: `npm run test:coverage`
4. Liste os problemas encontrados por prioridade: CRÍTICO, MAIOR, MENOR

## Formato do relatório

```
## Revisão do PR

### Problemas Críticos (bloqueiam merge)
- [ ] ...

### Problemas Maiores (devem ser corrigidos)
- [ ] ...

### Sugestões (opcional)
- ...
```

## Referências
- Leia `docs/CONTRIBUTING.md` para padrões detalhados

Criar um slash command envolve três etapas: escrever o arquivo de skill, registrar no settings.json e testar no Claude Code. Vamos criar um comando /analisar-deps que analisa dependências desatualizadas.

# Skill: Analisar Dependências

Execute `npm outdated --json` e analise o resultado.
Para cada dependência desatualizada:
1. Identifique o tipo: patch, minor ou major
2. Verifique o CHANGELOG no npm registry
3. Classifique o risco: BAIXO (patch), MÉDIO (minor), ALTO (major)

Apresente um relatório organizado por risco.

{
  "commands": {
    "analisar-deps": {
      "description": "Analisa dependências desatualizadas por risco",
      "file": ".claude/skills/analisar-deps.md"
    }
  }
}

# No terminal, dentro do projeto:
claude

# No Claude Code:
/analisar-deps

Ao digitar /meu-comando argumento extra, o texto após o nome do comando fica disponível na skill como $args. Isso permite criar skills genéricas que se adaptam conforme o contexto de uso.

# Skill: Gerar Componente React
# Uso: /gerar-componente NomeDoComponente

Crie um componente React chamado **$args**.

Requisitos:
- TypeScript com tipos explícitos
- Props interface com nome `${args}Props`
- Arquivo: `src/components/$args/$args.tsx`
- Story: `src/components/$args/$args.stories.tsx`
- Teste: `src/components/$args/$args.test.tsx`

Siga os padrões em `src/components/Button/` como referência.

/gerar-componente UserAvatar
# $args = "UserAvatar"
# Cria UserAvatar.tsx, stories, test

/gerar-componente UserAvatar large
# $args = "UserAvatar large"
# Tudo após o comando é $args

Criar um slash command tem custo: você precisa escrever a skill, mantê-la atualizada e garantir que ela funciona em diferentes contextos. Nem tudo precisa ser um comando — saber quando não criar é tão importante quanto saber como criar.