Superpowers para Claude Code: instalação, skills e fluxo
O que o plugin Superpowers acrescenta ao Claude Code, os comandos de instalação exatos do repositório, as 15 skills que ele traz na v7.0.2 e como o fluxo difere do Claude Code puro.
Resumo
- Superpowers é um plugin de código aberto com 15 skills combináveis — brainstorming, planos, TDD, depuração, worktrees, revisão de código — que o Claude Code carrega automaticamente após a instalação.
- No marketplace oficial: /plugin install superpowers@claude-plugins-official. Ou adicione obra/superpowers-marketplace e instale superpowers@superpowers-marketplace.
- O post do autor cita Claude Code 2.0.13 ou algo próximo como mínimo; o manifesto do plugin no repositório está na v7.0.2, publicado em 2026-11-03.
- O fluxo: brainstorming → worktree → plano escrito → execução com subagentes ou inline com TDD → revisão → fechamento da branch. O agente procura uma skill relevante antes de cada tarefa.
Estado do repositório verificado em 2026-11-11: 315,938 estrelas no GitHub, última versão v7.0.2 publicada em 2026-11-03, último commit 22f0b463. Estrelas mudam todo dia — leia como um retrato do momento. Os comandos, nomes de skills e versões desta página foram copiados dessas fontes, não reescritos.
O que Superpowers é de fato
Superpowers é um plugin de código aberto sob licença MIT — v7.0.2 no momento da escrita — que dá ao Claude Code uma metodologia de desenvolvimento, não mais uma caixa de ferramentas. Não é modelo, nem proxy de API, nem fork: é uma biblioteca de 15 skills mais um bootstrap que manda o agente procurá-las e segui-las.
Uma skill é uma pasta com um arquivo SKILL.md: frontmatter YAML com name e description, e abaixo instruções em markdown. A description é o gatilho — o Claude Code lê e decide se a skill se aplica. Superpowers adiciona um hook de início de sessão que injeta o bootstrap using-superpowers, então o agente procura uma skill antes de responder, não depois de já ter escrito código.
Foi criado por Jesse Vincent (obra) na Prime Radiant e publicado em 2025-10-09, no mesmo dia em que a Anthropic lançou o sistema de plugins do Claude Code. O mesmo repositório também instala no Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode e outros: uma biblioteca de skills, vários harnesses.
- Versão
- v7.0.2 · 2026-11-03
- Último commit
- 22f0b463
- Licença
- MIT
Instalar o Superpowers no Claude Code
Duas rotas suportadas, ambas copiadas do README do repositório. Execute dentro de uma sessão do Claude Code — são comandos de barra, não comandos de shell.
Rota 1 — o marketplace oficial (uma linha)
O marketplace claude-plugins-official da Anthropic é adicionado automaticamente na primeira sessão interativa do Claude Code, então só a linha de instalação é necessária. O README também aponta para uma página de apresentação: claude.com/plugins/superpowers.
/plugin install superpowers@claude-plugins-officialRota 2 — o marketplace do Superpowers
Use se quiser o marketplace do próprio autor, que também traz plugins relacionados como superpowers-chrome e elements-of-style. A primeira linha registra o marketplace e a segunda instala o plugin pelo nome.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceO que precisa existir antes
- 1Claude Code 2.0.13 ou mais novo — o mínimo citado pelo post do autor para a rota de plugin.
- 2Reiniciar depois de instalar: saia e abra o claude de novo para o hook de início injetar o bootstrap.
- 3Um repositório git para o fluxo completo — a etapa de worktree cria uma branch isolada e o fechamento oferece merge, pull request ou descarte.
Outros harnesses, o mesmo repositório
O README lista uma linha de instalação por agente de código. Aqui estão copiadas como estão — releia o README antes de rodar, os comandos mudam entre versões.
| Harness | Comando de instalação |
|---|---|
| Codex CLI | /plugins |
| Cursor | /add-plugin superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Qwen Code | qwen extensions install obra/superpowers |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers |
| Grok Build | grok plugin install superpowers@xai-official --trust |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes | hermes plugins install obra/superpowers --enable |
O fluxo que ele impõe
É esta a parte que muda de verdade o comportamento do Claude Code. Sete passos da seção Basic Workflow do README, mais a regra de que o agente checa se há uma skill relevante antes de qualquer tarefa.
- 1
brainstorming
Antes de construir qualquer coisa, o agente pergunta o que você realmente quer e por quê, devolve o entendimento para correção e escreve um documento de design para tudo maior que uma pequena mudança.
- 2
using-git-worktrees
Aprovado o design, ele cria um espaço isolado em uma branch nova, roda o setup do projeto e confere uma base de testes limpa antes de tocar no código.
- 3
writing-plans
O design aprovado vira tarefas de 2 a 5 minutos, cada uma com caminhos de arquivo exatos, código completo e passos de verificação.
- 4
subagent-driven-development ou executing-plans
Dois modos: um subagente novo por tarefa com revisão após cada uma (o mais minucioso), ou execução inline na sessão atual com uma única revisão da branch inteira no final (o mais barato).
- 5
test-driven-development
Durante a implementação vale RED-GREEN-REFACTOR: escreva o teste que falha, veja falhar, escreva o mínimo de código, veja passar, faça commit. Código escrito antes do teste é apagado.
- 6
requesting-code-review
Entre tarefas o trabalho é revisado contra o plano e os problemas são reportados por severidade — achados críticos bloqueiam o avanço.
- 7
finishing-a-development-branch
No fim ele verifica os testes, oferece merge, pull request, manter ou descartar, executa sua escolha e limpa o worktree.
As 15 skills da v7.0.2
Nomes de pasta são os identificadores que o agente usa para casar, então não são traduzidos. Cada descrição parafraseia o frontmatter daquela skill no commit 22f0b463.
Testes
test-driven-development
Escreva o teste primeiro, veja falhar e só então escreva o código suficiente para passar — com uma referência de antipadrões de teste.
Depuração
systematic-debugging
Um processo de causa raiz em quatro fases para qualquer bug, teste falhando ou comportamento estranho, antes de propor correção. Corrigir o sintoma conta como falha.
verification-before-completion
Rode o comando de verificação e leia a saída antes de afirmar que algo está pronto, corrigido ou passando.
diagnosing-superpowers
Quando uma sessão deu errado, lê a transcrição e relata o que aconteceu com evidência linha a linha; se quiser, empacota um pacote higienizado para um relato de bug.
Colaboração
brainstorming
Obrigatória antes de trabalho criativo: extrai a intenção com perguntas e devolve o entendimento antes de construir.
writing-plans
Transforma uma especificação em plano que um engenheiro que nunca viu o código consegue executar: arquivos, nomes, assinaturas e testes exatos por tarefa.
executing-plans
Execução inline do plano: você implementa tarefa por tarefa na sessão atual, com uma única revisão de toda a branch no fim.
subagent-driven-development
Um subagente implementador novo por tarefa, revisão de especificação e qualidade após cada uma, e uma revisão ampla da branch inteira no final.
dispatching-parallel-agents
Com duas ou mais tarefas independentes e sem estado compartilhado, delegue cada uma a um agente com contexto próprio em vez de ir em série.
requesting-code-review
Envia um subagente revisor com contexto montado com precisão para os problemas aparecerem entre tarefas, não no fim.
receiving-code-review
Como receber feedback de revisão: verifique antes de implementar, pergunte em vez de supor e evite concordância de fachada.
using-git-worktrees
Garante um espaço isolado, preferindo as ferramentas nativas de worktree da plataforma e caindo para git worktree manual só quando não houver.
finishing-a-development-branch
Verifica testes, detecta o ambiente, oferece merge, PR, manter ou descartar, executa a escolha e limpa.
Meta
writing-skills
Criar e editar skills aplicando TDD à documentação de processo, incluindo como testar se uma skill realmente dispara.
using-superpowers
A skill de arranque: como achar skills, como carregá-las e por que precisam ser invocadas antes de qualquer resposta.
Superpowers contra o Claude Code puro
O Claude Code puro já tem plan mode, skills nativas, subagentes, worktrees e plugins. Superpowers não acrescenta primitivas novas: acrescenta opiniões sobre quando usá-las e um hook que torna essas opiniões difíceis de pular.
| Tema | Claude Code puro | Com Superpowers |
|---|---|---|
| De onde vem o fluxo | Você escolhe por sessão: plan mode, uma convenção no CLAUDE.md ou um prompt colado à mão. | Um hook de início injeta um bootstrap obrigatório de skills, e essa sequência vira o comportamento padrão. |
| Planejamento | O plan mode produz um plano que você aprova, e a implementação começa no mesmo contexto. | brainstorming → documento de design → writing-plans transformam o plano em tarefas de 2 a 5 minutos com caminhos e testes. |
| Isolamento e execução | Worktrees e subagentes existem, mas você decide quando usá-los. | using-git-worktrees roda sozinho após o design; depois você escolhe entre subagent-driven-development e executing-plans. |
| Portões de qualidade | Você pede testes e revisão, ou monta hooks e CI por conta própria. | TDD, verification-before-completion e requesting-code-review disparam entre tarefas; achados críticos bloqueiam o avanço. |
Onde ajuda
- O padrão muda de «escrever código já» para «perguntar primeiro» — a maior diferença prática e o eixo do post do autor.
- Skills pequenas e legíveis: cada comportamento é um arquivo markdown que você abre, compara e edita.
- Uma biblioteca de skills para vários harnesses — o mesmo repositório instala no Claude Code, Codex, Cursor, Gemini CLI e mais.
O que custa
- Mais tokens e mais turnos: perguntas, documento de design, plano e revisões por tarefa acontecem antes da primeira linha de código de produção.
- Opinativo de propósito: YAGNI, TDD estrito e invocação obrigatória de skills caem bem em projeto novo e menos em um hotfix em código legado.
- Mais uma coisa para manter atualizada, e o ganho completo pressupõe repositório git e um harness com subagentes.
Quando uma sessão descarrilha
Se uma skill dispara quando não devia, fica muda quando devia falar, ou o agente ignora o próprio plano, o repositório traz uma skill diagnosing-superpowers exatamente para isso. Peça na sessão — acrescente «in session <id>» para uma anterior — e ela lê a transcrição, relata o que houve com evidências e pode empacotar um pacote higienizado para um relato de bug.
figure out what went wrong with superpowers in session <id>Telemetria e como desligar
O README é explícito: o companheiro visual opcional da skill brainstorming carrega um logo do site da Prime Radiant que leva a versão do Superpowers, mas nenhum dado de projeto, prompt ou agente. Defina SUPERPOWERS_DISABLE_TELEMETRY com qualquer valor verdadeiro para desligar; DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC do Claude Code também são respeitados.