Domínio 3 — Claude Code Configuration & Workflows · Lição 3 de 6

Slash commands e skills

Objetivos de aprendizagem

• Criar slash commands de projeto (.claude/commands/, compartilhados via git) e pessoais (~/.claude/commands/) — task statement 3.2.
• Criar skills em .claude/skills/ com SKILL.md e frontmatter: context: fork, allowed-tools, argument-hint.
• Explicar quando context: fork é a escolha certa (saída verbosa/exploração que não deve poluir a conversa principal).
• Decidir entre skill (workflow sob demanda) e CLAUDE.md (padrão universal sempre carregado).
• Criar variantes pessoais de skills em ~/.claude/skills/ com nomes distintos, sem afetar o time.

Slash commands: prompts empacotados

Um slash command é um arquivo Markdown cujo conteúdo vira o prompt quando alguém digita /nome-do-comando. Existem dois escopos, e a distinção cai na prova (é uma das sample questions oficiais):

O arquivo aceita frontmatter (description, argument-hint, allowed-tools, model) e placeholders: $ARGUMENTS (tudo que foi digitado após o comando) ou $1, $2... (posicionais):

---
description: Roda o checklist de code review do time no diff atual
argument-hint: "[branch-base]"
allowed-tools: "Bash(git diff*) Bash(git log*) Read Grep"
---
Revise o diff contra a branch $1 seguindo o checklist do time:

1. Segurança: entradas validadas? segredos hardcoded?
2. Erros: caminhos de falha tratados e logados?
3. Testes: novos comportamentos cobertos?

Reporte cada achado com arquivo:linha e severidade (alta/média/baixa).

Skills: capacidades sob demanda

Uma skill vive em .claude/skills/<nome>/SKILL.md (com arquivos auxiliares na mesma pasta, se precisar). Diferente do CLAUDE.md — carregado sempre, em toda sessão —, a skill é carregada sob demanda: quando invocada ou quando o Claude julga que a descrição dela casa com a tarefa. É o mecanismo certo para workflows específicos que não precisam ocupar contexto em toda interação.

---
name: analyze-deps
description: Analisa o grafo de dependencias do monorepo e aponta ciclos
context: fork
allowed-tools: "Read Grep Glob"
argument-hint: "[pacote]"
---
Analise as dependencias do pacote $ARGUMENTS:

1. Liste imports entre pacotes internos (use Grep em package.json e imports).
2. Detecte ciclos e dependencias nao declaradas.
3. Retorne APENAS um resumo: ciclos encontrados, top 5 acoplamentos, riscos.

Os três campos de frontmatter cobrados no exame:

• context: fork — executa a skill em um subagente com contexto isolado: as dezenas de leituras e buscas intermediárias ficam no fork e só o resultado final volta à conversa principal. Use para skills de saída verbosa (análise de codebase) ou exploratória (brainstorm de alternativas) que poluiriam a sessão.
• allowed-tools — restringe as ferramentas disponíveis durante a execução da skill (ex.: só leitura/busca para uma skill de análise, impedindo ações destrutivas; ou só operações de escrita de arquivo quando é isso que a skill deve fazer).
• argument-hint — mostra ao desenvolvedor quais parâmetros o comando espera (aparece no autocomplete), evitando invocações sem os argumentos necessários.

flowchart TD
    I["/analyze-deps pacote-x"] --> F{context: fork?}
    F -- sim --> SUB["Subagente isolado
leituras e buscas verbosas
ficam aqui"]
    SUB --> RES["Só o resumo volta
à conversa principal"]
    F -- não --> MAIN["Roda na conversa principal
toda a saída entra no contexto"]
  

Skill vs CLAUDE.md: o critério

Variantes pessoais sem afetar o time

Quer experimentar uma versão diferente de uma skill do time (outro formato de relatório, outros passos)? Crie a variante em ~/.claude/skills/ com nome diferente (ex.: analyze-deps-experimental). Ela fica disponível só para você, em qualquer projeto, e não interfere na skill oficial versionada do repositório. O mesmo raciocínio vale para comandos pessoais em ~/.claude/commands/.

Pegadinhas da prova

• Distrator típico: criar o comando do time em ~/.claude/commands/ — pessoal, nunca chega aos colegas. Comando de time = .claude/commands/ no repositório.
• Distrator típico: definir comandos num config.json com "commands array" — esse mecanismo não existe; comandos são arquivos Markdown.
• Distrator típico: colocar convenções que devem valer sempre numa skill — skills são sob demanda; convenção universal pertence ao CLAUDE.md/rules.
• Distrator típico: rodar análise verbosa de codebase sem context: fork "para o Claude manter todo o contexto" — o entulho intermediário degrada a conversa principal; o fork isola e devolve só o resumo.
• Distrator típico: editar a skill compartilhada do repositório para experimentar algo pessoal — a variante pessoal vai em ~/.claude/skills/ com outro nome.
• Distrator típico: achar que allowed-tools é orientação — é restrição real de ferramentas durante a execução da skill.

Resumo em 5 linhas

Documentação oficial

• Slash commands
• Skills
• Manage Claude's memory (CLAUDE.md)

Questões de fixação