superpowers (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Conjunto de skills compacto e opinativo (não uma cozinha completa)
Inclui meta-skills: como briefar o Claude, como fazer autorrevisão
Skills fortes de fluxo de trabalho git (rebase, cherry-pick, bisect)
Loops de depuração e planejamento
Licença MIT

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "superpowers-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/obra/superpowers",
        "~/.claude/skills/superpowers"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "superpowers-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/obra/superpowers",
        "~/.claude/skills/superpowers"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "superpowers-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/obra/superpowers",
        "~/.claude/skills/superpowers"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "superpowers-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/obra/superpowers",
        "~/.claude/skills/superpowers"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "superpowers-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/obra/superpowers",
        "~/.claude/skills/superpowers"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "superpowers-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/obra/superpowers",
          "~/.claude/skills/superpowers"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add superpowers-skill -- git clone https://github.com/obra/superpowers ~/.claude/skills/superpowers

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: superpowers

Planejar uma feature ambígua antes de escrever qualquer código

👤 Devs que pulam para o código rápido demais ⏱ ~45 min intermediate

Quando usar: A feature está vaga e você se beneficiaria de reflexão forçada.

Pré-requisitos

Skills instaladas — git clone https://github.com/obra/superpowers ~/.claude/skills/superpowers

Fluxo

Acionar a skill de planejamento

Apply the planning skill. Feature: per-user rate limiting that scales to 10k req/s.✓ Copiado

→ Skill pede restrições, critérios de sucesso, alternativas
Iterar sobre o plano

Push back on each assumption. What would Linus reject?✓ Copiado

→ Plano mais robusto com riscos explícitos
Traduzir para o primeiro PR

What's the smallest first PR that proves the plan?✓ Copiado

→ Primeiro passo em forma de MVP

Resultado: Um plano que você defenderia em uma revisão de design, não apenas um que você chutou.

Recuperar de uma situação git confusa de forma limpa

👤 Devs em 'falência de git stash' ⏱ ~30 min advanced

Quando usar: Você tem um merge ruim, commits perdidos ou rebase que deu errado.

Fluxo

Diagnosticar

Apply the git-rescue skill. Show me what's salvageable: reflog, stash, dangling commits.✓ Copiado

→ Inventário do estado recuperável
Reconstruir

Plan the recovery. Run only after I confirm.✓ Copiado

→ Sequência proposta de operações git com explicações
Verificar

After recovery, confirm tree is what I expected.✓ Copiado

→ Árvore final corresponde à intenção

Resultado: Estado do branch recuperado sem perda de trabalho.

Executar autorrevisão na própria saída do Claude antes de aceitar

👤 Devs que confiam no Claude demais / de menos ⏱ ~15 min beginner

Quando usar: Você quer que o modelo audite a si mesmo antes de você fazer isso.

Fluxo

Acionar autorrevisão

Apply self-review skill on the diff you just produced. Be harsh.✓ Copiado

→ Preocupações específicas, não 'parece bom' genérico
Endereçar as descobertas

Fix every sev-1 finding. Ignore sev-3 if it's nitpicks.✓ Copiado

→ Diff mais restrito

Resultado: Saída de maior qualidade sem você ter que ser o único crítico.

Combine com: wshobson-skills-skill

Combinações

Combine com outros MCPs para 10× de alavancagem

superpowers-skill + wshobson-agents-skill

Planejar com superpowers, executar com agentes wshobson

Plan via superpowers/planning; delegate implementation to backend-architect.✓ Copiado

superpowers-skill + wshobson-skills-skill

Duas opiniões empilhadas

Use both skill sets — superpowers for git, wshobson for testing.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
planning	fuzzy feature	Reflexão pré-código
git-rescue	broken state	Emergências de git
self-review	claude output	Gate pré-aceitação
debug-loop	bug	Caçadas de bugs metódicas

Custo e limites

O que custa rodar

Cota de API: N/A — local
Tokens por chamada: As skills aqui são concisas — menor custo por acionamento do que os conjuntos maiores
Monetário: Gratuito (MIT)
Dica: Este é o conjunto mais leve — menos tokens por skill do que wshobson

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhum

Solução de problemas

Erros comuns e correções

Skill não detectada

O caminho do clone deve corresponder a ~/.claude/skills/superpowers; verifique com claude config show

Colisões de acionamento com wshobson

As skills roteiam automaticamente por descrição; renomeie uma se ambas disputarem pela mesma intenção

Alternativas

superpowers vs. outros

Alternativa	Quando usar	Troca
wshobson/skills	Você quer cobertura mais ampla	Maior mas menos curado
anthropics/skills (oficial)	Conjunto inicial oficial da Anthropic	Linha de base oficial; superpowers adiciona opinião

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills