Slash Commands no Claude Code: Guia Completo para Criar e Usar (2026)

Se voce usa o Claude Code no terminal, ja deve ter notado que digitar / abre uma lista de comandos. Esses sao os slash commands -- atalhos que executam acoes especificas sem precisar digitar prompts longos.

Mas a maioria dos usuarios para nos comandos nativos e nunca descobre que pode criar seus proprios slash commands usando Skills. Neste guia, voce vai aprender tudo: desde os comandos embutidos ate como montar uma skill personalizada do zero.

1. O que sao slash commands no Claude Code

Slash commands sao comandos que comecam com / e que voce digita diretamente no prompt do Claude Code. Eles se dividem em dois tipos:

• Nativos (built-in): ja vem com o Claude Code. Executam acoes do sistema como limpar contexto, ver custos ou iniciar projetos.
• Personalizados (Skills): criados por voce (ou instalados de terceiros). Aparecem na mesma lista quando voce digita /. Cada skill e um arquivo Markdown com instrucoes que o Claude segue quando o comando e acionado.

O ponto central: slash commands personalizados transformam o Claude Code de um assistente generico em um especialista sob demanda. Voce digita /auditoria-seo e ele executa uma auditoria completa. Digita /gerar-copy e ele cria copy seguindo frameworks especificos.

2. Todos os slash commands nativos

O Claude Code vem com uma serie de comandos embutidos. Aqui esta a lista completa e atualizada:

Comando	O que faz
/help	Mostra a lista de comandos disponiveis e ajuda geral
/clear	Limpa todo o contexto da conversa atual, comecando do zero
/compact	Compacta o historico da conversa para economizar tokens (aceita instrucoes opcionais de como resumir)
/cost	Mostra o custo acumulado de tokens da sessao atual
/init	Gera o arquivo CLAUDE.md do projeto com instrucoes baseadas no codebase
/review	Faz code review do diff atual (mudancas nao commitadas)
/terminal-setup	Instala o atalho Shift+Cmd+U para pegar contexto do terminal
/config	Abre o arquivo de configuracao do Claude Code
/logout	Encerra a sessao de autenticacao atual
/login	Alterna de conta ou metodo de autenticacao
/doctor	Diagnostica problemas de instalacao e configuracao
/permissions	Mostra e gerencia as permissoes de ferramentas
/memory	Edita o arquivo CLAUDE.md do projeto
/model	Alterna entre modelos disponiveis (Opus, Sonnet, Haiku)
/vim	Ativa o modo de edicao vim no input

Esses comandos cobrem operacoes de sistema. Mas note: nenhum deles e especializado em marketing, SEO, copywriting, desenvolvimento com frameworks especificos ou qualquer dominio tecnico. Para isso, voce precisa de skills.

3. Como criar slash commands personalizados usando Skills

O sistema de Skills do Claude Code e direto: voce cria uma pasta com um arquivo Markdown e o Claude Code faz o resto. Sem instalacao de pacotes, sem compilacao, sem configuracao de CLI.

O processo em 3 passos:

1. Criar a pasta da skill dentro de .claude/skills/ (no projeto) ou ~/.claude/skills/ (global)
2. Criar o arquivo SKILL.md com frontmatter YAML + instrucoes em Markdown
3. Pronto. Da proxima vez que voce digitar / no Claude Code, sua skill aparece na lista

O Claude Code detecta novas skills automaticamente ao iniciar a sessao. Se voce adicionar uma skill com o Claude Code ja aberto, inicie uma nova sessao com /clear ou reinicie o Claude Code para que ela apareca.

4. Estrutura completa de uma skill

Uma skill pode ser simples (apenas o SKILL.md) ou completa (com testes e arquivos de referencia). Aqui esta a estrutura maxima:

O arquivo SKILL.md

O arquivo principal de toda skill. Ele tem duas partes: o frontmatter YAML (metadados) e o corpo Markdown (instrucoes).

Campos do frontmatter

Campo	Obrigatorio	Descricao
name	Sim	Nome do slash command (aparece como /nome)
description	Sim	Descricao curta que aparece na lista de comandos

O corpo do Markdown aceita qualquer formatacao: listas, tabelas, blocos de codigo, headings. Tudo que voce escrever ali sera a instrucao que o Claude segue quando o usuario aciona o comando.

Pasta references/

Arquivos na pasta references/ sao carregados como contexto adicional quando a skill e acionada. Use para:

• Templates de output (HTML, JSON, CSV)
• Dados de referencia (guias de estilo, tone of voice, brand guidelines)
• Exemplos de entrada e saida esperada
• Documentacao tecnica especifica do dominio

Pasta evals/

O arquivo evals.json define testes automatizados para validar se a skill esta funcionando corretamente. E util para quem distribui skills ou quer garantir qualidade apos atualizacoes.

5. Onde colocar os arquivos: local vs global

O Claude Code busca skills em dois lugares:

Local	Caminho	Escopo
Projeto (local)	.claude/skills/	Disponivel apenas quando voce abre o Claude Code naquele diretorio do projeto
Usuario (global)	~/.claude/skills/	Disponivel em qualquer projeto, em qualquer diretorio

Quando usar cada um?

• Local: skills especificas do projeto. Exemplo: um skill de code review que segue as convencoes daquele repositorio, ou um skill de deploy que usa o pipeline especifico do projeto.
• Global: skills que voce usa em qualquer contexto. Exemplo: auditoria SEO, geracao de copy, traducao, formatacao de Markdown. Sao skills utilitarias que independem do projeto.

Se existir uma skill local e uma global com o mesmo nome, a local tem prioridade. Isso permite customizar comportamentos por projeto.

6. Exemplos praticos: 3 skills do zero

Vamos criar tres skills reais para voce entender o padrao e comecar a usar hoje.

Exemplo 1: Auditoria SEO On-Page

Com essa skill instalada, voce digita /seo-audit no Claude Code e ele inicia a auditoria automaticamente.

Exemplo 2: Gerador de Copy (AIDA)

Exemplo 3: Code Review Automatizado

Note o padrao: toda skill segue a mesma estrutura -- frontmatter com nome e descricao, contexto do papel (quem o Claude deve ser), instrucoes de quando acionado, regras de execucao e formato de saida.

7. Dicas avancadas: evals, referencias e composicao

Usando arquivos de referencia

Para skills que precisam de contexto rico, adicione arquivos na pasta references/. O Claude Code carrega esses arquivos automaticamente quando a skill e acionada.

No SKILL.md, voce pode referenciar esses arquivos diretamente nas instrucoes. O Claude tera acesso a eles como parte do contexto da skill.

Testando com evals

O arquivo evals/evals.json permite definir testes para validar se a skill funciona como esperado. A estrutura segue o padrao:

{
  "evals": [
    {
      "input": "Faca auditoria SEO de uma pagina com title vazio",
      "expected_output_contains": ["CRITICO", "title"],
      "description": "Deve identificar title vazio como critico"
    },
    {
      "input": "Analise pagina com todos os elementos OK",
      "expected_output_contains": ["100", "OK"],
      "description": "Deve dar score alto quando tudo esta correto"
    }
  ]
}

Evals sao uteis para quem cria skills para equipes ou para distribuicao -- garantem que atualizacoes nao quebrem o comportamento esperado.

Composicao: combinando multiplas skills

Voce pode criar skills que referenciam outras skills. Por exemplo, uma skill de "lancamento de produto" que orienta o Claude a executar sequencialmente:

1. A skill de pesquisa de mercado
2. A skill de geracao de copy
3. A skill de criacao de landing page
4. A skill de configuracao de tracking

Isso transforma o Claude Code em um verdadeiro workflow automatizado, onde cada passo alimenta o proximo.

Boas praticas ao escrever skills

• Seja especifico no papel: "Voce e um copywriter senior especializado em SaaS B2B" funciona melhor que "Voce e um escritor"
• Defina o formato de saida: se voce quer uma tabela, uma lista ou um relatorio, especifique. O Claude segue a estrutura que voce definir
• Inclua restricoes: "Nunca use jargao tecnico", "Limite a 500 palavras", "Sempre inclua exemplos". Restricoes deixam o output mais previsivel
• Use secoes claras: separe contexto, instrucoes, regras e formato com headings H2 ou H3. O Claude processa melhor instrucoes bem estruturadas
• Teste antes de distribuir: rode a skill varias vezes com inputs diferentes para garantir consistencia

8. Por que nao criar do zero?

Voce pode criar todas as suas skills do zero. Mas considere o que isso envolve:

• Pesquisa de dominio: cada skill precisa de conhecimento profundo da area. Uma skill de Google Ads, por exemplo, precisa cobrir estrutura de campanhas, bidding strategies, quality score, extensoes, scripts -- sao horas de pesquisa so para uma skill
• Iteracao e teste: a primeira versao de uma skill raramente e a melhor. Voce precisa testar com diferentes inputs, ajustar instrucoes, refinar o formato de saida. Sao multiplas rodadas de iteracao
• Manutencao: plataformas mudam. O que era best practice em Meta Ads ha 6 meses pode estar desatualizado. Skills precisam de atualizacao constante
• Cobertura: criar 5 skills e viavel. Criar 50 e trabalhoso. Criar 134 skills de marketing ou 750 skills de desenvolvimento e um projeto de meses

O custo real de criar skills do zero nao e so o tempo de escrita -- e o custo de oportunidade. Cada hora que voce gasta escrevendo uma skill e uma hora que voce nao esta usando o Claude Code para entregar trabalho real para seus clientes.

A matematica e simples

Se voce cobra R$100/hora e gasta 2 horas criando uma skill, o custo real foi R$200. Por R$19, voce tem acesso a um pacote inteiro com centenas de skills prontas, testadas e atualizadas.

Nao e sobre "nao saber criar" -- e sobre usar seu tempo no que gera receita e deixar a infraestrutura pronta para quem ja fez o trabalho pesado.