Superpowers no GitHub: o que é o repositório de skills usado com o Claude Code?

Você busca Superpowers GitHub e cai em coisas completamente diferentes na mesma página de resultados: um framework de skills pra agente de código, um criador de jogos em HTML5 e um punhado de tutoriais que ensinam caminhos que já mudaram

Dá pra perder um tempo bom até entender qual é qual, né?

Então bora resolver isso aqui: o Superpowers que interessa pra quem usa Claude Code vive como repositório público em github.com/obra/superpowers, descrito lá como "An agentic skills framework & software development methodology that works."

Neste post eu te mostro o que tem dentro dele, quem mantém, o que já foi arquivado e como o projeto chega até o seu editor, sem inventar passo que a página não diz

O que o README diz que o projeto é

A definição não é minha, é do próprio README: "a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them"

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Traduzindo o espírito da coisa: é uma metodologia completa de desenvolvimento pros seus agentes de código, construída em cima de um conjunto de skills composable e de instruções iniciais que garantem que o agente realmente use essas skills

E o que significa composable na prática?

É a ideia de peça encaixável: cada skill é uma unidade separada, com seu próprio arquivo, e elas se combinam durante o trabalho em vez de virar um megaprompt único

Se você já mexeu com pacote de NPM ou de composer, o raciocínio é parecido: um monte de peça pequena e independente, que o projeto puxa conforme precisa

Repara na segunda metade da frase do README, que é a parte que todo mundo pula: as instruções iniciais existem justamente pra garantir que o agente use as skills, e não fique só com elas paradas no disco 🙂

O que você encontra dentro do repositório

A estrutura é simples de conferir com o olho, sem clonar nada

• skills/: cada skill mora na própria pasta, no formato skills/<nome-da-skill>/SKILL.md
• .claude-plugin/: aqui ficam o plugin.json e o marketplace.json

Entre as skills citadas no README estão brainstorming, test-driven-development e using-git-worktrees

Só por esses três nomes já dá pra sentir a pegada do projeto: pensar antes, testar antes de escrever código e isolar trabalho em worktrees separadas

O pacote também expõe comandos de barra pro fluxo estruturado:

• /brainstorm
• /write-plan
• /execute-plan

Quer entender uma skill de verdade? abre o SKILL.md dela

É arquivo de texto, dá pra ler direto no GitHub e ver o que aquilo instrui o agente a fazer antes de você instalar qualquer coisa na sua máquina

Quem mantém o Superpowers e quais são os repositórios do ecossistema

O projeto é criado e mantido por Jesse Vincent, cujo usuário no GitHub é obra (perfil github.com/obra)

É open source sob licença MIT

E a tração é grande: o repositório acumula mais de 270 mil estrelas no GitHub, sendo 271,5 mil na medição de 13/08/2026

O mesmo autor mantém outros repositórios do ecossistema:

• obra/superpowers-lab: skills experimentais
• obra/superpowers-marketplace: marketplace curado de plugins do Claude Code
• obra/superpowers-chrome: plugin de controle do Chrome via DevTools Protocol

Saber disso te poupa confusão na busca, porque muita coisa que aparece com o nome Superpowers não é o repositório principal, é um vizinho dele com outra função

Superpowers do Claude Code não é o Superpowers dos jogos HTML5

Esse é o tropeço clássico de quem digita só o nome na busca

github.com/superpowers é a organização do "Superpowers, the HTML5 2D+3D game maker", que tem o repositório superpowers-game

Zero relação com IA, com agente de código ou com skills

O jeito mais rápido de diferenciar é olhar o dono do repositório na URL, antes do nome:

Tome cuidado ao seguir tutorial antigo que só escreve "superpowers" sem o dono: é assim que a pessoa acaba clonando um game maker achando que vai ganhar skills no Claude Code haha

O repositório de skills da comunidade foi arquivado: o que isso muda

Aqui mora a maior fonte de instrução desatualizada por aí

O repositório companheiro obra/superpowers-skills, que hospedava skills editáveis pela comunidade, foi arquivado pelo dono em 27/10/2025 e está somente leitura

Junto veio a mudança que quebra tutorial velho: skills em ~/.config/superpowers/skills não são mais lidas

Elas devem ficar em ~/.claude/skills, ou seja, passaram a ser lidas pelo sistema de skills do próprio Claude Code

Se você seguiu um passo a passo de antes dessa data, criou sua skill custom no caminho antigo e ficou se perguntando por que o agente ignora ela, é provavelmente isso

E já que o assunto é pasta de configuração, vale pensar em o que versionar no repositório do time e o que fica só na sua máquina, porque skill custom é exatamente o tipo de coisa que o time inteiro quer ter igual

Como o repositório chega até o seu editor

No Claude Code, o Superpowers é distribuído pelo sistema de plugins

O README traz o caminho pelo marketplace oficial de plugins:

/plugin install superpowers@claude-plugins-official

Existe também o caminho alternativo pelo marketplace mantido pelo próprio autor, em dois comandos:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Um aviso honesto: não dá pra afirmar aqui que os dois caminhos entregam exatamente a mesma versão do plugin, porque isso não está declarado nas páginas oficiais

Outro ponto interessante é que o diretório de skills não serve só ao Claude Code

O README cita suporte a Claude Code, Cursor, Codex, GitHub Copilot CLI e OpenCode, com instalação separada por harness

Ou seja: o repositório é a fonte, e cada ferramenta tem seu próprio jeito de puxar aquilo pra dentro

Esse padrão de usar um repo do GitHub como fonte de verdade pro agente aparece em várias frentes hoje, é o mesmo raciocínio de importar um design system pelo GitHub em vez de colar tudo no prompt

O que aconteceu quando rodei o Superpowers em um projeto de teste

No vídeo abaixo eu instalo e uso o plugin num projeto de teste, e é ali que a estrutura do repositório para de ser teoria

Foram 2 comandos pra instalar

Depois da instalação foi preciso reiniciar o Claude Code pro plugin ser detectado

E aí veio a parte que mais me chamou atenção: detectado o plugin, não precisou chamar ele de forma nenhuma especial

Mandei um prompt normal, pedindo um app estilo Google Keep pra captura rápida de pensamentos, com busca e organização depois

Na tela eu vi o plugin ativar sozinho e entrar direto na etapa de brainstorming 😀

Os slash commands de brainstorm, escrita de plano e execução de plano continuam disponíveis pra chamada isolada, mas não são obrigatórios

O fluxo que eu observei foi esse:

1. brainstorm inicial, com o agente fazendo as perguntas antes de sair codando
2. criação do documento de plano, quebrando a tarefa grande em subtarefas com arquivos exatos e passos de verificação
3. execução por subagentes com TDD
4. revisão de código contra o plano
5. finalização com merge/pull request

O passo 2 leva de 2 a 5 minutos e não é só picar a tarefa em pedaços: ele organiza pra uma subtarefa não atrapalhar a outra

A orquestração por subagentes com revisão de código entre eles lembra um supervisor acompanhando vários devs ao mesmo tempo

E tem a regra de TDD obrigatório que eu vi rodando: teste primeiro e, se o código vier antes do teste, ele apaga e recomeça

Tem também a regra de que skills são tratadas como lei: existindo skill pra tarefa, o plugin usa a skill

No fim, o agente relatou 16 tarefas/testes do plano como completos, e o plano terminou com tudo concluído menos uma última tarefa

Pedi pra ele fechar essa pendência antes de rodar o projeto

Rodei o app em localhost e testei o fluxo de verdade: criei notas com cor, editei, excluí e fixei

A nota fixada aparece primeiro na lista, e os dados persistem: recarreguei a página e as notas continuavam lá

A limitação que eu apontei: não achei drag and drop, recurso que existe no Google Keep original

E tem o custo: autonomia por horas queima token, isso entra na conta

Minha leitura é que o valor aqui está mais no processo do que no visual do resultado: planejamento, subagentes e TDD forçado

O projeto nasce organizado e mais fácil de evoluir, com menos invenção da IA no meio do caminho

Vale abrir o repositório do Superpowers?

Vale, e abrir antes de instalar é o melhor caminho

Recapitulando o que o repositório é: um projeto open source sob licença MIT, mantido por Jesse Vincent no usuário obra, com um conjunto de skills composable no diretório skills/, instruções iniciais que fazem o agente usar essas skills, o diretório .claude-plugin/ e os comandos /brainstorm, /write-plan e /execute-plan

E o que ele não é: não é o criador de jogos HTML5 da organização homônima, e não é mais o obra/superpowers-skills, que está arquivado e somente leitura desde 27/10/2025

Próximo passo, bem simples: abre github.com/obra/superpowers, lê o README inteiro e depois abre o SKILL.md das skills que te interessam

São arquivos de texto, você entende em minutos o que cada uma manda o agente fazer, e aí decide se quer o plugin rodando no seu fluxo

Depois me conta como foi no seu projeto, tô curioso pra ver o que sai em stacks diferentes da minha =)

até o próximo post!