Superpowers: el framework de habilidades agénticas que convierte a tu agente de código en un ingeniero disciplinado

Por David Moya · · 13 min lectura · Artículo técnico

Superpowers es un framework de habilidades agénticas y metodología de desarrollo para agentes de código. Descubre cómo funciona, cómo instalarlo y sus casos de uso.

Superpowers: el framework de habilidades agénticas que convierte a tu agente de código en un ingeniero disciplinado

En IAcademy llevamos meses analizando cómo los agentes de código están transformando el ciclo de vida del desarrollo de software. La mayoría de las herramientas se centran en generar código más rápido, pero muy pocas abordan el problema real: los agentes escriben código sin entender el problema, sin planificar y sin verificar. Superpowers, el repositorio de obra que acumula más de 289 000 estrellas en GitHub, propone una solución radicalmente distinta: una metodología completa de desarrollo de software empaquetada como un conjunto de habilidades composables que se activan automáticamente en tu agente.

En este artículo analizamos qué problema resuelve Superpowers, cómo está diseñado por dentro, cómo puedes empezar a usarlo hoy mismo y por qué creemos que representa un cambio de paradigma en la forma en que trabajamos con agentes de IA.

El problema: agentes que escriben código sin pensar

Si has usado Claude Code, Cursor, Codex CLI o cualquier agente de codificación moderno, probablemente hayas vivido esta situación: le pides una funcionalidad y el agente se lanza a escribir archivos sin preguntar nada. Diez minutos después tienes 400 líneas de código que no resuelven tu problema real, que no siguen las convenciones de tu proyecto y que, además, no tienen tests.

Este patrón tiene un nombre en la industria: vibe coding. Es rápido, es adictivo y es peligroso. El agente no sabe qué estás construyendo, no conoce tus restricciones y no tiene forma de verificar si lo que hizo funciona. El resultado es deuda técnica generada a velocidad industrial.

Los equipos que han intentado mitigar esto con prompts elaborados descubren pronto un problema estructural: los prompts son frágiles, no se componen bien y se pierden en cuanto la conversación crece. Lo que hace falta no es un prompt mejor, sino una metodología que el agente pueda ejecutar de forma consistente.

Eso es exactamente lo que ofrece Superpowers.

Qué es Superpowers y qué lo hace diferente

Superpowers se define como una metodología completa de desarrollo de software para tus agentes de código, construida sobre un conjunto de habilidades composables y unas instrucciones iniciales que garantizan que el agente las use. La diferencia clave con otras propuestas es que no se trata de un prompt ni de una extensión de IDE: es un framework de habilidades que se instala como plugin en tu arnés de agente favorito y se activa desde el primer mensaje.

La filosofía subyacente es sencilla pero poderosa: en lugar de pedirle al agente que escriba código, se le pide que piense antes de escribir. El flujo es el siguiente:

  1. El agente detecta que estás construyendo algo y, en lugar de lanzarse a programar, te pregunta qué intentas conseguir realmente.
  2. Extrae una especificación de la conversación y te la muestra en fragmentos cortos, digeribles y revisables.
  3. Cuando apruebas el diseño, genera un plan de implementación tan claro que podría seguirlo un ingeniero junior sin contexto.
  4. Al dar luz verde, lanza un proceso de desarrollo dirigido por subagentes: agentes que ejecutan cada tarea, inspeccionan su propio trabajo y continúan.

El resultado, según la documentación del proyecto, es que no es raro que el agente trabaje de forma autónoma durante un par de horas sin desviarse del plan acordado. Eso es una diferencia cualitativa enorme respecto al vibe coding.

Arquitectura de Superpowers: habilidades, subagentes y TDD

Para entender Superpowers hay que mirar debajo del capó. El repositorio está escrito principalmente en Shell, lo cual es revelador: no es una aplicación pesada, sino una capa de orquestación ligera que se integra con el arnés del agente. Su arquitectura se apoya en cuatro pilares.

1. Habilidades composables

Las skills son unidades de comportamiento que el agente puede invocar. Cada habilidad encapsula una práctica de ingeniería: hacer brainstorming, escribir una especificación, planificar una implementación, aplicar TDD, revisar código, etc. Al ser composables, se pueden encadenar para formar flujos completos.

2. Instrucciones de arranque

El plugin inyecta instrucciones al inicio de la sesión que garantizan que el agente sepa que las habilidades existen y cuándo debe activarlas. Esto es clave: no dependes de recordar invocarlas manualmente. El agente las usa porque forman parte de su contexto inicial.

3. Desarrollo dirigido por subagentes

En lugar de que un único agente haga todo, Superpowers lanza subagentes especializados. Cada subagente recibe una tarea concreta del plan, la ejecuta, inspecciona su propio resultado y devuelve el control. Este patrón reduce la deriva y permite paralelizar trabajo.

4. TDD real, YAGNI y DRY

El plan de implementación que genera el agente enfatiza tres principios clásicos de la ingeniería de software: TDD (primero el test rojo, luego el verde), YAGNI (You Aren't Gonna Need It, no construyas lo que no necesitas) y DRY (Don't Repeat Yourself). No son eslóganes: son restricciones que el agente aplica al generar código.

El siguiente diagrama muestra el flujo completo:

┌─────────────────────────────────────────────────────────────┐
│                    SESIÓN DEL AGENTE                        │
│                                                             │
│  ┌──────────────┐                                           │
│  │  Arranque    │  Instrucciones iniciales inyectadas       │
│  │  del plugin  │  por Superpowers                          │
│  └──────┬───────┘                                           │
│         │                                                   │
│         ▼                                                   │
│  ┌──────────────┐     ┌──────────────────┐                  │
│  │  Habilidad:  │────▶│  Especificación  │                  │
│  │ brainstorming│     │  revisada por    │                  │
│  └──────────────┘     │  el humano       │                  │
│                       └────────┬─────────┘                  │
│                                │                            │
│                                ▼                            │
│                       ┌──────────────────┐                  │
│                       │  Habilidad:      │                  │
│                       │  planificación   │                  │
│                       │  (TDD/YAGNI/DRY) │                  │
│                       └────────┬─────────┘                  │
│                                │                            │
│                                ▼                            │
│              ┌─────────────────────────────────┐            │
│              │  Desarrollo dirigido por        │            │
│              │  subagentes                     │            │
│              │  ┌──────┐ ┌──────┐ ┌──────┐     │            │
│              │  │ Sub 1│ │ Sub 2│ │ Sub N│     │            │
│              │  └──┬───┘ └──┬───┘ └──┬───┘     │            │
│              │     │        │        │         │            │
│              │     ▼        ▼        ▼         │            │
│              │  Inspección y revisión continua  │            │
│              └─────────────────────────────────┘            │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Lo interesante es que este flujo no requiere que el usuario haga nada especial. Las habilidades se activan automáticamente porque el agente las reconoce como parte de su repertorio.

Cómo empezar con Superpowers

Una de las mayores fortalezas del proyecto es su amplitud de integraciones. Superpowers funciona con prácticamente todos los arneses de agentes relevantes del mercado: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent y Muse. Si usas más de uno, debes instalarlo por separado en cada uno.

Veamos los casos más habituales.

Instalación en Claude Code

La vía más directa es el marketplace oficial de plugins de Anthropic:

/plugin install superpowers@claude-plugins-official

Si prefieres el marketplace mantenido por el propio autor, que incluye otros plugins relacionados:

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

Instalación en Cursor

Desde el chat del agente de Cursor:

/add-plugin superpowers

También puedes buscar «superpowers» en el marketplace de plugins del editor.

Instalación en Gemini CLI

gemini extensions install https://github.com/obra/superpowers

Y para actualizar más adelante:

gemini extensions update superpowers

Instalación en Codex CLI

Superpowers está disponible en el marketplace oficial de plugins de OpenAI. Abre la interfaz de búsqueda:

/plugins

Busca «superpowers» y selecciona Install Plugin.

Instalación en GitHub Copilot CLI

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

Instalación en Factory Droid

droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowers

Instalación en Devin CLI

devin plugins install obra/superpowers

Y para actualizar:

devin plugins update superpowers

Instalación en Antigravity

agy plugin install https://github.com/obra/superpowers

Antigravity ejecuta el hook de inicio de sesión del plugin, por lo que Superpowers está activo desde el primer mensaje. Para actualizar, reinstala con el mismo comando.

Instalación en Kimi Code

Abre el gestor de plugins de Kimi Code:

/plugins

Ve a Marketplace > Superpowers e instálalo. También puedes instalarlo directamente desde el repositorio:

/plugins install https://github.com/obra/superpowers

Instalación en Grok Build CLI

grok plugin install superpowers@xai-official --trust

O abre el marketplace en la TUI con /marketplace, busca Superpowers e instálalo.

El flujo de trabajo básico en la práctica

Más allá de la instalación, lo que importa es cómo cambia tu día a día. Imaginemos que quieres añadir autenticación con OAuth a tu API en Node.js. Sin Superpowers, el agente probablemente empiece a escribir middleware y rutas sin preguntar. Con Superpowers, el flujo es otro.

Paso 1: brainstorming. El agente te pregunta qué proveedores necesitas, si quieres sesiones o JWT, cómo gestionarás los refresh tokens, qué pasa con los usuarios existentes. No escribe código todavía.

Paso 2: especificación. Te muestra un documento corto con las decisiones tomadas. Lo revisas, corriges lo que no te encaje y apruebas.

Paso 3: plan de implementación. El agente descompone el trabajo en tareas atómicas: crear el modelo de usuario, escribir el test de registro, implementar el endpoint, escribir el test de login, etc. Cada tarea incluye el test que debe pasar antes de escribir el código.

Paso 4: ejecución con subagentes. El agente lanza subagentes que van resolviendo tareas. Cada uno ejecuta el test, escribe el código, verifica que el test pasa y reporta. Si algo falla, se detiene y te lo comunica.

El resultado es un pull request coherente, con tests, que sigue las convenciones de tu proyecto. Y tú has intervenido solo en los puntos de decisión importantes.

Casos de uso prácticos

Superpowers brilla en escenarios donde la calidad importa más que la velocidad bruta. Estos son los que hemos identificado como más valiosos.

Refactorizaciones grandes con red de seguridad

Cuando tienes que migrar un módulo legacy, el mayor riesgo es romper comportamiento existente. Superpowers fuerza a escribir tests primero, lo que crea una red de seguridad antes de tocar el código. El agente puede trabajar durante horas sabiendo que cualquier regresión se detecta de inmediato.

Desarrollo de funcionalidades con requisitos difusos

Si el requisito es «quiero que los usuarios puedan compartir informes», el agente no puede limitarse a programar. La fase de brainstorming obliga a clarificar: ¿compartir por enlace público o con usuarios concretos? ¿Con caducidad? ¿Con permisos de solo lectura? Estas preguntas suelen salir a la luz antes de escribir una sola línea.

Onboarding de nuevos miembros del equipo

El plan de implementación que genera Superpowers es, en la práctica, documentación ejecutable. Un nuevo desarrollador puede leerlo y entender no solo qué se construyó, sino por qué se tomaron ciertas decisiones. Es una forma de capturar el razonamiento de diseño que normalmente se pierde.

Prototipado rápido con disciplina

Paradójicamente, Superpowers también acelera el prototipado. Al evitar que el agente se pierda en callejones sin salida, el tiempo total hasta tener algo funcional suele ser menor, aunque el agente «piense» más al principio.

Proyectos con requisitos de cumplimiento

En entornos regulados, la trazabilidad importa. El hecho de que Superpowers genere especificaciones y planes revisables facilita la auditoría del proceso de desarrollo. No es una solución de cumplimiento por sí misma, pero ayuda a documentar decisiones.

Comparativa con alternativas

Superpowers no es la única propuesta en el espacio de agentes de código disciplinados. Veamos cómo se compara con las alternativas más relevantes.

Característica Superpowers Prompts personalizados Frameworks de agentes (LangChain, CrewAI) IDE con agente integrado
Metodología completa de SDLC Parcial No No
Habilidades composables No No
Activación automática No No Parcial
Multi-arnés Sí (16+) Depende Independiente No
Desarrollo por subagentes No No
TDD forzado Manual Manual No
Curva de aprendizaje Baja Media Alta Baja

La comparación más justa es con los prompts personalizados, porque es lo que la mayoría de equipos usa hoy. La diferencia es que un prompt es un texto estático que el agente puede ignorar cuando la conversación se complica, mientras que Superpowers es un sistema de habilidades que el agente reconoce y aplica de forma consistente.

Frente a frameworks como LangChain o CrewAI, la propuesta es distinta: esos frameworks te dan primitivas para construir tus propios agentes, mientras que Superpowers te da una metodología ya construida que se integra en agentes existentes. No compiten directamente; se pueden complementar.

Limitaciones y consideraciones

Sería deshonesto presentar Superpowers como una solución sin aristas. Estas son las que hemos observado.

Dependencia del arnés. Aunque soporta muchos arneses, el comportamiento puede variar entre ellos. Un agente con ventana de contexto pequeña tendrá más dificultades para mantener el plan completo en memoria.

Coste de tokens. Pensar antes de escribir consume tokens. En proyectos pequeños, el ahorro de tiempo puede no compensar el coste adicional. En proyectos medianos y grandes, sí.

Curva de adaptación del equipo. Los desarrolladores acostumbrados a vibe coding pueden sentirse frenados al principio. La disciplina requiere un cambio de hábito.

Telemetría. El proyecto incluye telemetría del visual companion. Es un punto a revisar si trabajas en entornos con requisitos estrictos de privacidad.

Servicios comerciales. El autor ofrece soporte comercial a través de [email protected] para empresas que necesiten herramientas adicionales o gestión de gasto. Es relevante si planeas un despliegue a gran escala.

Filosofía: por qué esto importa más allá de la herramienta

La sección de filosofía del repositorio merece atención porque revela la intención del proyecto. Superpowers no pretende reemplazar al desarrollador, sino elevar el nivel de abstracción de su trabajo. En lugar de revisar líneas de código, revisas especificaciones y planes. En lugar de corregir bugs, corriges decisiones de diseño.

Esto conecta con una tendencia más amplia en la industria: el valor del desarrollador se desplaza desde la escritura de código hacia la definición de problemas y la verificación de soluciones. Superpowers es una herramienta que acelera ese desplazamiento.

En IAcademy creemos que esta es la dirección correcta. Los agentes que solo generan código son un commodity; los agentes que aplican metodología son una ventaja competitiva. Superpowers es, hoy, una de las implementaciones más maduras de esa idea.

Preguntas frecuentes

¿Superpowers funciona con cualquier agente de código?

No con cualquiera, pero sí con la gran mayoría de los relevantes: Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot CLI, Devin CLI, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Qwen Code, Antigravity, Pi, Hermes Agent y Muse, entre otros. Si usas varios, debes instalarlo por separado en cada uno.

¿Necesito saber programar para usar Superpowers?

Sí, aunque el nivel requerido baja. Superpowers te pide revisar especificaciones y planes, no escribir código. Pero necesitas criterio técnico para evaluar si las decisiones de diseño son correctas. No es una herramienta para no programadores.

¿Superpowers sustituye a los tests que ya tengo?

No. Superpowers enfatiza TDD, lo que significa que el agente escribirá tests nuevos para el código nuevo. Tus tests existentes siguen siendo válidos y, de hecho, ayudan al agente a entender el comportamiento esperado.

¿Es gratis?

El plugin es de código abierto y gratuito. El autor ofrece servicios comerciales opcionales para empresas que necesiten soporte, herramientas adicionales o gestión de gasto. Para uso individual o de equipos pequeños, la versión gratuita es suficiente.

¿Qué pasa si el agente se desvía del plan?

Superpowers está diseñado precisamente para minimizar eso. Los subagentes trabajan sobre tareas atómicas del plan y verifican su propio trabajo antes de continuar. Si algo falla, el agente se detiene y te lo comunica en lugar de improvisar. La sección «When Something Goes Wrong» del repositorio documenta los patrones de recuperación.

Conclusión

Superpowers representa una maduración del ecosistema de agentes de código. Ya no basta con que el agente escriba código; hace falta que lo escriba bien, con método y con verificación. La propuesta de obra es ambiciosa: empaquetar una metodología completa de desarrollo de software en un conjunto de habilidades que el agente aplica automáticamente.

Si estás empezando con agentes de código, Superpowers es una forma excelente de adquirir buenos hábitos desde el principio. Si ya llevas tiempo usándolos, es una oportunidad para pasar de vibe coding a ingeniería asistida por IA con disciplina.

En IAcademy seguiremos analizando este tipo de herramientas porque creemos que marcan la diferencia entre equipos que usan IA y equipos que la usan bien. Superpowers, hoy, está claramente en el segundo grupo.

Founding Members: todo por 99 EUR

604 módulos, 23 especializaciones, acceso sin caducidad al contenido adquirido. Precio normal: 199 EUR. Garantía 30 días.

Ser Founding Member Ver todos los planes