Skills e slash commands (/investigate, /review, /ship)

Pedir tudo "solto" pro Claude Code funciona, mas a gente descobriu algo melhor: fluxos prontos pras tarefas que se repetem. São as skills (slash commands) — e elas embutem o jeito certo de fazer cada coisa, em vez de você reinventar o prompt toda vez.

O que é uma skill

Uma skill é um fluxo nomeado, acionado por /comando, que carrega um procedimento especializado: a sequência de passos, o contexto certo e as boas práticas daquela tarefa. Em vez de "me ajuda a investigar esse bug", você chama /investigate e o fluxo já sabe como conduzir.

As que mais usamos no ClubPetro

• /investigate — bug, erro 500, "por que isso quebrou". Conduz a investigação de forma estruturada em vez de chutar causa.
• /review — revisar um diff antes do PR. Olha correção, risco, padrão.
• /ship — subir/deployar, criar PR. Encadeia os passos de entrega com segurança.

E há outras no nosso fluxo (qa, document-release, design-review, plan-eng-review, checkpoint, health…). A regra de roteamento do nosso CLAUDE.md é clara: quando a tarefa casa com uma skill, invoca a skill primeiro — ela produz resultado melhor que prompt ad-hoc.

Por que isso é melhor que pedir solto

1. Consistência. Todo mundo investiga bug do mesmo jeito bom, não cada um do seu.
2. Boas práticas embutidas. A skill já carrega o "como fazer certo" — você não depende de lembrar.
3. Menos prompt, mais resultado. O fluxo faz o trabalho de estruturar; você foca no problema.
4. Conhecimento que escala. Melhorou o fluxo? Todo mundo ganha, sem treinar de novo.

Como tirar proveito

• Aprenda quais skills existem antes de inventar prompt. Metade das tarefas comuns já tem uma.
• Deixe a skill conduzir. Ela tem um roteiro melhor que o improviso — siga.
• Combine com plan mode. /investigate que entende o bug → plano de correção → geração → /review.

A ideia maior

Skills transformam vibe coding de "talento individual com prompt" em processo de time. O bom prompt deixa de ser segredo de quem manja e vira ferramenta que todo mundo usa.

⚠️ Armadilha #15: ignorar as skills e reescrever o mesmo prompt manual toda vez. É reinventar a roda — pior, uma roda mais torta que a que o time já lapidou.

Próximo da série: #16 — Refactors e migrations em massa.