Superpowers: dale skills a tu agente

Superpowers es una metodología completa de desarrollo de software para tu agente de IA, armada sobre un conjunto de skills combinables más unas instrucciones iniciales que se aseguran de que el agente las use. Es open-source, lo mantiene Jesse Vincent junto al equipo de Prime Radiant, y lo instalás como plugin: obra/superpowers.

Qué problema resuelve

Si usás Claude Code u otro agente de coding, ya conocés el patrón: le pedís algo y se tira de cabeza a escribir código. Sin preguntar qué querés lograr, sin plan, sin tests. A veces zafa. La mayoría de las veces terminás corrigiendo, re-pidiendo y explicando lo mismo tres veces.

Superpowers le mete método a eso. Desde el momento en que prendés el agente y ve que estás por construir algo, no arranca tipeando. Da un paso atrás y te pregunta qué estás tratando de hacer en realidad. Una vez que sacó una especificación de la conversación, te la muestra en pedazos cortos como para que los puedas leer y aprobar. Recién después de que firmaste el diseño, arma un plan de implementación. Y recién cuando le decís "dale", se pone a ejecutar.

La clave es que esto no lo tenés que pedir. Las skills se disparan solas según lo que estés haciendo. Tu agente simplemente tiene superpoderes.

Por qué darle skills reutilizables importa

Una skill es un manual destilado: el paso a paso de cómo se hace bien una tarea, para que el agente deje de improvisar y la repita como alguien que ya la hizo cien veces. En lugar de re-explicar el mismo procedimiento en cada chat, está escrito una sola vez y el agente lo encuentra solo cuando hace falta.

Superpowers no es una skill suelta: es una biblioteca de skills que cubre todo el ciclo de desarrollo —diseñar, planificar, testear, depurar, revisar— más el pegamento que hace que el agente las consulte sin que se lo recuerdes. La diferencia con un prompt largo y único es que las skills se cargan de a poco, solo la que corresponde a la tarea del momento, así no llenás la memoria de trabajo del agente al pedo.

Cómo se instala en Claude Code

La instalación cambia según el harness (el programa que corre tu agente). Si usás más de uno, instalá Superpowers por separado en cada uno. Acá va el camino para Claude Code, que tiene dos opciones.

Opción A: marketplace oficial de Anthropic

La forma más directa. Superpowers está disponible en el marketplace oficial de plugins de Claude. Un solo comando dentro de Claude Code:

/plugin install superpowers@claude-plugins-official

Opción B: marketplace de Superpowers

El marketplace propio de Superpowers ofrece este plugin y algunos otros relacionados. Son dos pasos: primero registrás el marketplace, después instalás el plugin desde ahí.

Registrá el marketplace:

/plugin marketplace add obra/superpowers-marketplace

Después instalá el plugin:

/plugin install superpowers@superpowers-marketplace

Cualquiera de las dos opciones te deja Superpowers funcionando. Si solo querés probarlo, la opción A es la más corta.

Qué skills vienen adentro

La biblioteca está organizada por etapa del trabajo. Estas son las que trae:

Testing

• test-driven-development — el ciclo RED-GREEN-REFACTOR: escribís el test que falla, lo ves fallar, escribís el código mínimo para que pase, lo ves pasar, commiteás. Incluye una referencia de anti-patrones de testing.

Debugging

• systematic-debugging — un proceso de 4 fases para encontrar la causa raíz en vez de adivinar parches. Incluye técnicas como rastreo de causa raíz, defensa en profundidad y espera por condición.
• verification-before-completion — asegurarse de que algo está realmente arreglado antes de cantar victoria. Evidencia antes que afirmaciones.

Colaboración

• brainstorming — refinamiento de diseño al estilo socrático: convierte ideas crudas en una especificación a fuerza de preguntas.
• writing-plans — planes de implementación detallados, partidos en tareas chiquitas.
• executing-plans — ejecución por lotes con puntos de control humanos.
• dispatching-parallel-agents — flujos con varios subagentes trabajando en paralelo.
• requesting-code-review — checklist previo a pedir una revisión de código.
• receiving-code-review — cómo responder a la devolución de una revisión.
• using-git-worktrees — ramas de desarrollo en paralelo, aisladas entre sí.
• finishing-a-development-branch — el flujo de decisión para cerrar una rama: mergear, abrir PR, conservar o descartar.
• subagent-driven-development — iteración rápida con revisión en dos etapas (primero si cumple la spec, después la calidad del código).

Meta

• writing-skills — crear skills nuevas siguiendo buenas prácticas, con su metodología de testing incluida.
• using-superpowers — la introducción al sistema de skills, lo primero que el agente lee.

Cómo se invocan las skills

Acá está la parte que la hace distinta de un montón de prompts sueltos: no las invocás vos. El agente revisa si hay una skill relevante antes de cualquier tarea, y la activa solo cuando corresponde. Son flujos obligatorios, no sugerencias.

El recorrido típico de un proyecto se encadena solo, más o menos así:

1. brainstorming             → te saca la spec con preguntas
2. using-git-worktrees       → arma un espacio aislado en una rama nueva
3. writing-plans             → parte el trabajo en tareas de 2-5 minutos
4. subagent-driven-development → un subagente fresco por tarea, con doble revisión
5. test-driven-development   → RED-GREEN-REFACTOR en cada implementación
6. requesting-code-review    → revisa contra el plan, reporta por severidad
7. finishing-a-development-branch → verifica tests y te ofrece mergear/PR/descartar

Cada paso se dispara en su momento: brainstorming se activa apenas ve que vas a escribir código; using-git-worktrees, después de que aprobaste el diseño; writing-plans, con el diseño aprobado; y así. No es raro que el agente trabaje solo durante un par de horas sin desviarse del plan que armaron juntos.

La filosofía de fondo es simple y la vas a notar en cada skill:

• TDD siempre — los tests van primero, sin excepción.
• Sistemático antes que improvisado — proceso en lugar de adivinanza.
• Reducir complejidad — la simplicidad como objetivo principal.
• Evidencia antes que afirmaciones — verificar antes de declarar el éxito.

Cómo actualizarlo y un detalle de privacidad

Las actualizaciones dependen del harness, pero suelen ser automáticas. Si instalaste por el marketplace, el plugin se mantiene al día solo en la mayoría de los casos.

Un punto que conviene saber: la función opcional de "compañero visual" de brainstorming carga el logo de Prime Radiant desde su sitio, junto con la versión de Superpowers que estás usando. No manda nada sobre tu proyecto, tu prompt ni tu agente —es solo para que el equipo tenga una idea aproximada de cuánta gente lo usa—. Si querés apagarlo, poné la variable de entorno en cualquier valor verdadero:

SUPERPOWERS_DISABLE_TELEMETRY=1

También respeta los opt-out de Claude Code (DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC), así que si ya los tenés puestos, no hace falta tocar nada más.

Próximo paso

Si usás Claude Code, instalalo hoy y probalo en tu próximo proyecto: corré /plugin install superpowers@claude-plugins-official y empezá a construir algo. Vas a ver cómo el agente te frena, te pregunta y arma un plan antes de tocar una línea de código.

Y si querés que veamos juntos cómo integrarlo a tu flujo real —con tus proyectos, tus herramientas y la forma en que ya trabajás— agendá una llamada en /agenda y lo armamos en vivo.