📁 A Pasta .claude/commands/
O diretorio .claude/commands/ e o coracao do sistema de Skills. Todo arquivo .md colocado aqui vira automaticamente um slash command acessivel dentro do Claude Code. Nao precisa registrar, configurar ou reiniciar nada.
🎯 Conceito Principal
Existem dois niveis de Skills:
- •Projeto:
.claude/commands/na raiz do projeto → acessiveis via/project:nome - •Usuario:
~/.claude/commands/no home → acessiveis via/user:nomeem qualquer projeto
💡 Dica Pratica
Skills de projeto vao no git e sao compartilhadas com o time. Skills de usuario sao pessoais e funcionam em todos os seus projetos. Coloque skills genericas (code review, gerar testes) no usuario, e skills especificas (deploy deste projeto, padroes deste codebase) no projeto.
🔍 Auto-Discovery
O Claude Code escaneia automaticamente as pastas de commands quando inicia uma sessao. Todo arquivo .md encontrado vira um slash command sem nenhuma configuracao extra. O nome do arquivo vira o nome do comando.
🎯 Conceito Principal
O mapeamento e direto: nome do arquivo → nome do comando.
- •
code-review.md→/project:code-review - •
generate-tests.md→/project:generate-tests - •Subpastas criam namespaces:
devops/deploy.md→/project:devops:deploy
💡 Dica Pratica
Use nomes descritivos com hifens: senior-code-review.md e melhor que scr.md. Voce vai digitar Tab para autocompletar de qualquer forma, e nomes claros ajudam todo o time a entender o proposito sem abrir o arquivo.
⚡ Slash Commands em Acao
Depois que a skill esta na pasta certa, usar ela e tao simples quanto digitar / seguido do prefixo e nome. O Claude carrega o conteudo do .md e segue as instrucoes como se voce tivesse colado tudo no chat.
🎯 Conceito Principal
- •/project:nome - Skills do projeto atual (pasta .claude/commands/)
- •/user:nome - Skills pessoais (pasta ~/.claude/commands/)
- •Argumentos: Use
$ARGUMENTSno .md para receber parametros apos o comando
💡 Dica Pratica
O placeholder $ARGUMENTS e poderoso: quando voce digita /project:code-review src/auth.ts, o Claude substitui $ARGUMENTS por "src/auth.ts" dentro das instrucoes da skill. Use isso para criar skills parametrizadas que funcionam com qualquer arquivo ou input.
🏢 Cowork Built-ins
O Claude Code Cowork (versao colaborativa/web) vem com Skills pre-instaladas que cobrem os casos de uso mais comuns. Essas built-ins servem como referencia de como estruturar suas proprias skills.
🎯 Conceito Principal
- •Code Review: Analise completa com security, performance, bugs e sugestoes
- •Generate Tests: Criacao automatica de testes unitarios e de integracao
- •Refactor: Refatoracao guiada com preservacao de funcionalidade
- •Document: Geracao de documentacao tecnica a partir do codigo
💡 Dica Pratica
Estude as built-ins antes de criar as suas. Elas mostram o padrao de qualidade esperado: instrucoes claras, passos numerados, criterios de qualidade e formato de saida definido. Copie a estrutura e adapte o conteudo para seu caso de uso.
🛒 Plugin Marketplace
Alem de Skills individuais, existe um ecossistema crescente de plugins que empacotam multiplas skills. O marketplace permite instalar conjuntos completos de funcionalidades com um unico comando.
🎯 Conceito Principal
- •Plugins oficiais: Mantidos pela Anthropic ou parceiros verificados
- •Plugins comunitarios: Criados pela comunidade, qualidade variavel
- •Instalacao: Via CLI ou marketplace web, registrado automaticamente
💡 Dica Pratica
Antes de instalar um plugin, leia o codigo-fonte. Plugins tem acesso ao seu sistema de arquivos e podem executar comandos. Verifique o que cada skill faz, quais ferramentas usa, e se o repositorio tem manutencao ativa. Plugin abandonado e risco de seguranca.
🗂️ Estrutura de Arquivos Recomendada
Uma boa organizacao de Skills faz a diferenca entre um projeto limpo e um caos de arquivos. Aqui esta a estrutura recomendada para escalar de 2 para 20 skills sem perder o controle.
🎯 Conceito Principal
.claude/
├── commands/ # Skills do projeto
│ ├── code-review.md # /project:code-review
│ ├── generate-tests.md # /project:generate-tests
│ ├── devops/
│ │ ├── deploy.md # /project:devops:deploy
│ │ └── rollback.md # /project:devops:rollback
│ └── research/
│ ├── lead-research.md # /project:research:lead-research
│ └── competitor.md # /project:research:competitor
├── settings.json # MCPs e configuracoes
└── CLAUDE.md # Instrucoes persistentes💡 Dica Pratica
Use subpastas para agrupar skills por dominio (devops, research, frontend). Isso cria namespaces automaticos nos slash commands e facilita a navegacao. Quando o projeto crescer para 10+ skills, voce vai agradecer ter organizado desde o inicio.