O que é o Superpowers do Claude Code e como ele muda o jeito do agente escrever código?

Tem agente que improvisa a cada prompt, e tem agente que segue um método

Fala aí, beleza? O Superpowers nasceu justamente pra colocar o agente no segundo grupo: ele é um framework de skills composable para agentes de código somado a uma metodologia de desenvolvimento de software, construído em cima de um conjunto de skills composable mais algumas instruções iniciais que garantem que o teu agente realmente use essas skills

Nesse post eu te conto o que ele é, como funciona por dentro (skill, SKILL.md, progressive disclosure), em que momento ele entra em ação sozinho e o que muda na prática no jeito do agente escrever código

Bora? 🙂

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

De onde veio o Superpowers e quem está por trás

O projeto é criado e mantido por Jesse Vincent, que usa o handle obra no GitHub, e o repositório oficial é o obra/superpowers

Ele apresentou a coisa publicamente em outubro de 2025, no post Superpowers: How I’m using coding agents in October 2025, publicado em 09/10/2025

O código é open source sob licença MIT, então tu pode ler, clonar e adaptar sem drama

E tem um detalhe que ajuda MUITO quem quer se aprofundar: a documentação técnica do repositório está indexada publicamente no DeepWiki, incluindo páginas específicas de integração com o Claude Code, tipo ‘Installing on Claude Code’ e ‘Claude Code: Skill Tool and Hooks’

Ou seja, não é aquele projeto misterioso que tu só entende lendo o código fonte na madrugada, hehe

Como o Superpowers funciona por dentro: skills, SKILL.md e progressive disclosure

Antes do como, o porquê: a ideia é tirar o conhecimento da cabeça do prompt e colocar em arquivo, versionável, que o agente lê quando precisa

Na prática, uma skill é uma pasta com o nome da skill contendo um arquivo SKILL.md

Esse arquivo tem frontmatter YAML com dois campos obrigatórios:

• name: máximo de 64 caracteres
• description: máximo de 1024 caracteres

E tem uma recomendação de tamanho: manter o corpo do SKILL.md abaixo de 500 linhas, jogando o excedente em arquivos separados

Que negócio é esse de progressive disclosure?

Boa pergunta, é o coração do modelo

O SKILL.md funciona como a visão geral: ele explica a coisa e aponta pros arquivos de referência

O agente carrega só o arquivo que ele precisa naquele momento

Os outros ficam parados no filesystem consumindo ZERO tokens de contexto

Se tu já mexeu com import de módulo, a analogia é essa: tu não carrega a biblioteca inteira na memória só porque vai usar uma função dela

Existem skills nomeadas pra etapas específicas do fluxo de desenvolvimento, tipo a writing-plans e a writing-skills

Uma cuida da etapa de planejamento, a outra ensina o método de escrever skill nova

Em que momento o Superpowers entra em ação

Aqui mora a parte mais interessante, e é onde a maioria dos posts passa batido

O que faz o agente usar as skills SEM tu pedir é um hook de início de sessão

Esse session-start hook injeta o bootstrap using-superpowers no começo de cada sessão

A partir daí, as skills disparam sozinhas quando são relevantes pro que tu está fazendo

Tu não fica lembrando o agente de seguir método, o método já entrou junto com a sessão

E onde as skills ficam guardadas?

As skills saíram do plugin e passaram a viver em um repositório dedicado, o obra/superpowers-skills

O plugin virou um shim leve, que gerencia um clone local desse repositório

Esse clone mora em um caminho fixo na tua máquina:

~/.config/superpowers/skills/

E ele se atualiza sozinho no início da sessão, sem comando manual

O setup inicial é feito pelo script initialize-skills.sh, disparado pelo mesmo session-start hook

Bem elegante: o gatilho que carrega o método é o mesmo que mantém o método atualizado 😀

Como instalar o Superpowers no Claude Code

O caminho documentado pelo próprio projeto tem dois comandos, e a ORDEM importa

1. Registre o marketplace do Superpowers dentro do Claude Code:

/plugin marketplace add obra/superpowers-marketplace

O erro comum deste passo: pular ele e tentar instalar o plugin direto, o Claude Code não tem como resolver o nome do plugin se o marketplace não foi registrado antes

2. Agora sim, instale o plugin:

/plugin install superpowers@superpowers-marketplace

O erro comum deste passo: digitar só o nome do plugin sem o @superpowers-marketplace, a parte depois do arroba é o marketplace que tu acabou de registrar

3. Confirme que deu certo rodando o /help

Depois de instalado, o /help passa a listar os comandos do Superpowers, tipo /superpowers:brainstorm, /superpowers:write-plan e /superpowers:execute-plan

Se eles aparecerem na lista, tá tudo certo

Se não aparecerem, volta no passo 1: quase sempre é o marketplace que não ficou registrado

Para que serve o Superpowers no dia a dia

O uso mais direto é conduzir o fluxo de desenvolvimento pelos comandos que aparecem no /help

Tu começa a tarefa pelo /superpowers:brainstorm, passa pro /superpowers:write-plan quando a ideia tá redonda, e manda o /superpowers:execute-plan pra tocar a execução

É o mesmo trabalho de sempre, só que com etapa declarada em vez de tudo no improviso de um prompt gigante

Na etapa de planejamento entra a skill writing-plans, que é justamente a parte de transformar intenção em plano antes de sair escrevendo código

E tem o caso mais massa na minha opinião: escrever as TUAS próprias skills, com a writing-skills

A metodologia do projeto pra isso é bem específica, e é quase TDD aplicado a documentação:

1. escrever casos de teste com subagentes
2. ver falhar sem a skill
3. escrever a documentação da skill
4. ver passar
5. refatorar

Sacou a jogada? A skill só é considerada boa se ela muda o comportamento do agente de forma comprovável

É o mesmo tipo de decisão de o que delegar ao agente e o que continua sendo trabalho teu de escrever na mão

O que muda no jeito do agente escrever código

Sai o agente que decide tudo no improviso de cada prompt

Entra um agente com fluxo declarado em arquivos versionáveis, carregado sob demanda e acionado por gatilho de sessão em vez de pedido manual

A diferença prática é essa: o conhecimento deixa de ser algo que tu redigita toda vez e vira algo que mora no repositório, junto com o resto do projeto

Quem já brigou pra fazer o agente respeitar o padrão do projeto sabe bem o tamanho dessa dor

E tem mais: o Superpowers não fica preso ao Claude Code

O mesmo conjunto de skills atende outros agentes de código, cada um com seu próprio bootstrap e sua seção de instalação no README

O projeto documenta suporte a Cursor, OpenAI Codex, GitHub Copilot CLI, Gemini CLI e OpenCode

Ou seja, o método que tu escreve hoje não morre se tu trocar de ferramenta amanhã, e isso é insano quando a gente lembra da velocidade que essas ferramentas mudam…

Vale a pena adotar o Superpowers?

Se a tua reclamação com agente de código é ‘ele faz certo hoje e faz diferente amanhã’, o Superpowers ataca exatamente esse ponto

Ele entrega hoje: framework de skills composable, o modelo de arquivo com progressive disclosure, o hook de sessão que injeta as instruções iniciais, os comandos de brainstorm, plano e execução, e uma metodologia pra tu escrever skill nova em cima disso

Tudo open source sob MIT

Pra quem faz sentido? Pra quem já usa agente com frequência e quer padronizar o jeito de trabalhar, seja sozinho ou em time

Se tu usa o agente pra tarefinha solta uma vez por semana, talvez seja camada demais pro teu caso

Próximo passo concreto, na ordem: instala pelo marketplace, roda o /help pra ver os comandos aparecendo, e começa pelo /superpowers:brainstorm em uma tarefa PEQUENA, só pra sentir o fluxo

Depois disso, vale ler a documentação do repositório e as páginas do DeepWiki do projeto pra se aprofundar na parte de hooks e de escrita de skills

Faça o teste e me conta o que achou

até o próximo post! =)