Superpowers para Claude Code: instalación, skills y flujo
Qué añade el plugin Superpowers a Claude Code, los comandos de instalación exactos del repositorio, los 15 skills que incluye en v7.0.2 y en qué se diferencia su flujo del Claude Code a secas.
Resumen
- Superpowers es un plugin de código abierto con 15 skills combinables — brainstorming, planes, TDD, depuración, worktrees, revisión de código — que Claude Code carga automáticamente al instalarlo.
- Desde el marketplace oficial: /plugin install superpowers@claude-plugins-official. O añadir obra/superpowers-marketplace e instalar superpowers@superpowers-marketplace.
- El artículo del autor cita Claude Code 2.0.13 o similar como mínimo; el manifiesto del plugin en el repositorio es v7.0.2, publicado el 2026-11-03.
- El flujo: brainstorming → worktree → plan escrito → ejecución con subagentes o en línea con TDD → revisión → cierre de rama. El agente busca un skill relevante antes de cada tarea.
Estado del repositorio verificado el 2026-11-11: 315,938 estrellas en GitHub, última versión v7.0.2 publicada el 2026-11-03, último commit 22f0b463. Las estrellas cambian a diario — léelo como una foto fija. Los comandos, nombres de skills y versiones de esta página están copiados de esas fuentes, no reformulados.
Qué es Superpowers en realidad
Superpowers es un plugin de código abierto con licencia MIT — v7.0.2 en el momento de escribir esto — que da a Claude Code una metodología de desarrollo en lugar de otra caja de herramientas. No es un modelo, ni un proxy de API, ni un fork: es una biblioteca de 15 skills más un bootstrap que ordena al agente buscarlos y seguirlos.
Un skill es una carpeta con un archivo SKILL.md: frontmatter YAML con name y description, y debajo instrucciones en markdown. La description es el disparador — Claude Code la lee y decide si el skill aplica. Superpowers añade un hook de inicio de sesión que inyecta el bootstrap using-superpowers, así que el agente busca un skill antes de responder, no después de haber escrito código.
Lo creó Jesse Vincent (obra) en Prime Radiant y se publicó el 2025-10-09, el mismo día en que Anthropic lanzó el sistema de plugins de Claude Code. El mismo repositorio también se instala en Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode y otros: una biblioteca de skills, muchos harness.
- Versión
- v7.0.2 · 2026-11-03
- Último commit
- 22f0b463
- Licencia
- MIT
Instalar Superpowers en Claude Code
Dos rutas admitidas, ambas copiadas del README del repositorio. Ejecútalas dentro de una sesión de Claude Code — son comandos de barra, no comandos de shell.
Ruta 1 — el marketplace oficial (una línea)
El marketplace claude-plugins-official de Anthropic se añade automáticamente la primera vez que abres una sesión interactiva de Claude Code, así que solo necesitas la línea de instalación. El README enlaza además una página de presentación: claude.com/plugins/superpowers.
/plugin install superpowers@claude-plugins-officialRuta 2 — el marketplace de Superpowers
Útil si quieres el marketplace del propio autor, que también aloja plugins relacionados como superpowers-chrome y elements-of-style. La primera línea registra el marketplace y la segunda instala el plugin por nombre.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceQué necesitas antes de que funcione
- 1Claude Code 2.0.13 o superior — el mínimo que cita el artículo del autor para la ruta del plugin.
- 2Reiniciar tras instalar: sal y vuelve a lanzar claude para que el hook de inicio inyecte el bootstrap.
- 3Un repositorio git para el flujo completo — el paso de worktree crea una rama aislada y el cierre ofrece merge, pull request o descartar.
Otros harness, el mismo repositorio
El README da una línea de instalación por agente de código. Aquí están copiadas tal cual — vuelve a leer el README antes de ejecutarlas, los comandos cambian entre versiones.
| Harness | Comando de instalación |
|---|---|
| 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 |
El flujo que impone
Esta es la parte que cambia de verdad el comportamiento de Claude Code. Siete pasos de la sección Basic Workflow del README, más la regla de que el agente comprueba si hay un skill relevante antes de cualquier tarea.
- 1
brainstorming
Antes de construir nada, el agente pregunta qué quieres de verdad y por qué, te devuelve su interpretación para que la corrijas y escribe un documento de diseño para todo lo que supere un cambio pequeño.
- 2
using-git-worktrees
Tras aprobar el diseño crea un espacio aislado en una rama nueva, ejecuta la configuración del proyecto y verifica una base de tests limpia antes de tocar código.
- 3
writing-plans
El diseño aprobado se convierte en tareas de 2 a 5 minutos, cada una con rutas de archivo exactas, código completo y pasos de verificación.
- 4
subagent-driven-development o executing-plans
Dos modos: un subagente nuevo por tarea con revisión después de cada una (el más minucioso), o ejecución en línea en la sesión actual con una sola revisión de toda la rama al final (el más barato).
- 5
test-driven-development
Durante la implementación rige RED-GREEN-REFACTOR: escribe el test que falla, míralo fallar, escribe el mínimo código, míralo pasar, haz commit. El código escrito antes de su test se borra.
- 6
requesting-code-review
Entre tareas se revisa contra el plan y los problemas se reportan por gravedad — los críticos bloquean el avance.
- 7
finishing-a-development-branch
Al final verifica los tests, ofrece merge, pull request, conservar o descartar, ejecuta tu elección y limpia el worktree.
Los 15 skills de la v7.0.2
Los nombres de carpeta son los identificadores con los que empareja el agente, así que no se traducen. Cada descripción parafrasea el frontmatter de ese skill en el commit 22f0b463.
Pruebas
test-driven-development
Escribe primero el test, míralo fallar y luego escribe solo el código necesario para pasarlo — con una referencia de antipatrones de testing.
Depuración
systematic-debugging
Un proceso de causa raíz en cuatro fases para cualquier bug, test fallido o comportamiento raro, antes de proponer un arreglo. Arreglar el síntoma cuenta como fallo.
verification-before-completion
Ejecuta el comando de verificación y lee su salida antes de afirmar que algo está terminado, arreglado o en verde.
diagnosing-superpowers
Cuando una sesión salió mal, lee su transcripción y reporta lo ocurrido con evidencia línea a línea; si quieres, empaqueta un lote saneado para un informe de bug.
Colaboración
brainstorming
Obligatorio antes de cualquier trabajo creativo: saca la intención con preguntas y devuelve su comprensión antes de construir.
writing-plans
Convierte una especificación en un plan que puede ejecutar un ingeniero que nunca vio el código: archivos, nombres, firmas y tests exactos por tarea.
executing-plans
Ejecución en línea del plan: implementas tarea a tarea en la sesión actual, con una única revisión de toda la rama al final.
subagent-driven-development
Un subagente implementador nuevo por tarea, una revisión de especificación y calidad tras cada una y una revisión amplia de toda la rama al final.
dispatching-parallel-agents
Con dos o más tareas independientes y sin estado compartido, delega cada una a un agente con su propio contexto en vez de ir en serie.
requesting-code-review
Lanza un subagente revisor con contexto construido con precisión para que los problemas salgan entre tareas y no al final.
receiving-code-review
Cómo recibir feedback de revisión: verifica antes de implementar, pregunta en vez de asumir y evita el acuerdo de cara a la galería.
using-git-worktrees
Garantiza un espacio aislado, prefiriendo las herramientas nativas de worktree de la plataforma y recurriendo a git worktree solo como último recurso.
finishing-a-development-branch
Verifica tests, detecta el entorno, ofrece merge, PR, conservar o descartar, ejecuta la elección y limpia.
Meta
writing-skills
Crear y editar skills aplicando TDD a la documentación de procesos, incluido cómo probar que un skill se dispara de verdad.
using-superpowers
El skill de arranque: cómo encontrar skills, cómo cargarlos y por qué hay que invocarlos antes de cualquier respuesta.
Superpowers frente a Claude Code a secas
Claude Code a secas ya tiene plan mode, skills nativos, subagentes, worktrees y plugins. Superpowers no añade primitivas nuevas: añade opiniones sobre cuándo usarlas y un hook que hace difícil saltárselas.
| Tema | Claude Code a secas | Con Superpowers |
|---|---|---|
| De dónde sale el flujo | Eliges en cada sesión: plan mode, una convención en CLAUDE.md o un prompt pegado a mano. | Un hook de inicio inyecta un bootstrap obligatorio de skills y esa secuencia pasa a ser el comportamiento por defecto. |
| Planificación | El plan mode produce un plan que apruebas y la implementación empieza en el mismo contexto. | brainstorming → documento de diseño → writing-plans convierten el plan en tareas de 2 a 5 minutos con rutas y tests. |
| Aislamiento y ejecución | Worktrees y subagentes existen, pero decides tú cuándo usarlos. | using-git-worktrees se ejecuta solo tras el diseño y luego eliges entre subagent-driven-development y executing-plans. |
| Controles de calidad | Pides tests y revisión, o montas hooks y CI por tu cuenta. | TDD, verification-before-completion y requesting-code-review se disparan entre tareas; un hallazgo crítico bloquea el avance. |
Dónde ayuda
- El comportamiento por defecto pasa de «escribir código ya» a «preguntar primero», la diferencia práctica más grande y el eje del artículo del autor.
- Skills pequeños y legibles: cada comportamiento es un archivo markdown que puedes abrir, diferenciar y editar.
- Una biblioteca de skills para varios harness: el mismo repositorio se instala en Claude Code, Codex, Cursor, Gemini CLI y más.
Qué te cuesta
- Más tokens y más turnos: preguntas, documento de diseño, plan y revisiones por tarea ocurren antes de la primera línea de código de producción.
- Con opinión fuerte a propósito: YAGNI, TDD estricto e invocación obligatoria de skills encajan en un proyecto nuevo y menos en un arreglo urgente sobre código heredado.
- Una cosa más que mantener actualizada, y el beneficio completo supone un repositorio git y un harness con subagentes.
Cuando una sesión se descarrila
Si un skill se dispara cuando no debe, calla cuando debería hablar, o el agente ignora su propio plan, el repositorio incluye un skill diagnosing-superpowers justo para eso. Pídelo en la sesión — añade «in session <id>» para una anterior — y leerá la transcripción, contará qué pasó con pruebas y podrá empaquetar un lote saneado para un informe de bug.
figure out what went wrong with superpowers in session <id>Telemetría y cómo desactivarla
El README lo dice claro: el compañero visual opcional del skill brainstorming carga un logo desde el sitio de Prime Radiant que lleva la versión de Superpowers, pero ningún dato del proyecto, del prompt ni del agente. Pon SUPERPOWERS_DISABLE_TELEMETRY en cualquier valor verdadero para desactivarla; DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC de Claude Code también se respetan.