Introducción a Superpowers: instalación, flujo de trabajo y prueba

Superpowers empaqueta una metodología completa basada en especificaciones en habilidades de Claude instalables, imponiendo la lluvia de ideas, la planificación, la implementación dirigida por subagentes y una estricta TDD (Desarrollo Dirigido por Pruebas), en lugar de dejar esa estructura a tu criterio.

La mayoría de las configuraciones de SDD (Desarrollo Dirigido por Especificaciones) en Claude Code fallan de la misma manera: alguien escribe una sólida habilidad de specify-plan-implement una vez, la usa diligentemente durante una semana y, luego, deriva silenciosamente hacia el prompting no estructurado la primera vez que un plazo se acerca. Nada en una habilidad creada a mano impide realmente que eso ocurra. Superpowers es una respuesta directa a ese problema de disciplina: un paquete de habilidades creado por Jesse Vincent y el equipo de Prime Radiant que trata la lluvia de ideas, la planificación, la revisión por subagentes y la TDD de rojo-verde-refactorizar como pasos obligatorios que el agente verifica antes de cada tarea, y no como sugerencias opcionales que puede omitir bajo presión.

Lo que lo hace digno de una mirada dedicada en lugar de una nota al pie es el proceso de instalación. Superpowers se distribuye con manifiestos de plugins para Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid y Hermes Agent, de modo que la misma metodología te acompaña a través de diferentes herramientas de ejecución (harnesses) en lugar de vivir en la carpeta .claude/skills/ de un solo repositorio. Esta guía cubre qué es realmente, cómo instalarlo y verificarlo en el agente que utilices, cómo se ve una primera ejecución de principio a fin y dónde encaja junto a otras herramientas de desarrollo dirigido por especificaciones.

¿Qué es Superpowers?

Superpowers se describe a sí mismo como “una metodología completa de desarrollo de software para tus agentes de codificación, construida sobre un conjunto de habilidades componibles y algunas instrucciones iniciales que aseguran que tu agente las use”. Esa última cláusula es la parte que importa. Existen muchas colecciones de habilidades; el diferenciador aquí es la instrucción de arranque que obliga al agente a buscar habilidades relevantes antes de comenzar cualquier tarea, de modo que el flujo de trabajo se active automáticamente en lugar de requerirte recordar un comando con barra diagonal.

La filosofía detrás de esto se enuncia claramente en los propios documentos del proyecto:

• Desarrollo Dirigido por Pruebas (TDD) – escribir pruebas primero, siempre
• Sistemático por encima de ad-hoc – proceso por encima de suposiciones
• Reducción de la complejidad – la simplicidad como objetivo principal
• Evidencia por encima de afirmaciones – verificar antes de declarar éxito

En la práctica, esa filosofía se manifiesta como una secuencia de habilidades que se entregan entre sí. Si has leído Habilidades de Claude y SKILL.md para desarrolladores, la mecánica te resultará familiar: Superpowers es un conjunto grande y opinado de exactamente ese tipo de directorio SKILL.md, distribuido como un plugin instalable en lugar de algo que tú mismo autores.

Instalando Superpowers en Agentes de Codificación

La instalación es específica de cada herramienta de ejecución (harness), y el proyecto es explícito al indicar que se debe instalar por separado para cada agente que utilices: no existe una instalación global única.

Claude Code

Superpowers se distribuye a través de dos mercados para Claude Code:

# Mercado oficial de plugins de Anthropic
/plugin install superpowers@claude-plugins-official

O a través del mercado dedicado de Superpowers, que también incluye algunos plugins relacionados:

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

Cursor

/add-plugin superpowers

También puedes buscar “superpowers” directamente en la interfaz del mercado de plugins de Cursor.

Otros agentes

Algunos detalles de la instalación merecen atención antes de ejecutar una tarea real:

• Antigravity ejecuta automáticamente el gancho de inicio de sesión del plugin, por lo que Superpowers está activo desde el primer mensaje; reinstala con el mismo comando para actualizar.
• Pi carga las habilidades a través de una pequeña extensión que inyecta el arranque de using-superpowers al inicio de la sesión y después de la compactación del contexto, y no requiere la herramienta de compatibilidad Skill de Pi ya que Pi tiene soporte nativo para habilidades.
• Hermes Agent no tiene un gancho pos-compactación: una sesión muy larga que compacte sobre su primer turno puede perder el arranque, por lo que inicia una sesión nueva si las habilidades dejan de activarse.
• OpenCode trata esto como una ruta de instalación completamente separada de cualquier otra herramienta de ejecución que ya uses, incluso en la misma máquina.

Verificar la instalación

Una vez instalado, pregúntale directamente al agente en lugar de confiar en un mensaje de éxito silencioso:

¿Qué habilidades están disponibles?

Si Superpowers se instaló correctamente, el agente debería listar habilidades como brainstorming, writing-plans, test-driven-development y subagent-driven-development entre los resultados. Este es el mismo control de descubrimiento recomendado para depurar habilidades de Claude que no se activan: si la habilidad existe pero nunca se activa, casi siempre el problema es la descripción de enrutamiento, no el modelo.

El Flujo de Trabajo de Superpowers: De la Lluvia de Ideas al Código Entregado

Superpowers documenta siete habilidades como “el flujo de trabajo básico”, cada una activándose en un punto específico y entregando a la siguiente:

⬇

1. brainstorming se activa antes de escribir cualquier código. Refina una idea vaga a través de preguntas, explora alternativas y presenta el diseño en fragmentos cortos y revisables en lugar de un documento largo: luego guarda el resultado como un artefacto de diseño.
2. using-git-worktrees se activa una vez que apruebas el diseño. Crea un espacio de trabajo aislado en una nueva rama, ejecuta la configuración del proyecto y verifica una línea base de pruebas limpia antes de que comience la implementación.
3. writing-plans divide el diseño aprobado en tareas de tamaño pequeño: Superpowers apunta a dos a cinco minutos de trabajo por tarea – con rutas de archivo exactas, código completo donde sea relevante y pasos de verificación explícitos.
4. subagent-driven-development (iteración rápida) o executing-plans (ejecución por lotes con puntos de control humanos) despacha un subagente nuevo por tarea, con una revisión de dos etapas: primero la conformidad con la especificación, luego la calidad del código.
5. test-driven-development impone un estricto rojo-verde-refactorizar: escribe una prueba que falle, mírala fallar, escribe el código mínimo para que pase, mírala pasar, commit. El código escrito antes de que existiera una prueba que fallara para él se elimina, no se conserva.
6. requesting-code-review se activa entre tareas, revisando el diff contra el plan e informando problemas por severidad; los problemas críticos bloquean el progreso hacia la siguiente tarea.
7. finishing-a-development-branch se activa una vez que todas las tareas se completan. Verifica que las pruebas pasen, luego presenta opciones: fusionar, abrir una PR, mantener la rama o descartar – y limpia el worktree.

Esto se alinea estrechamente con el bucle de cinco fases neutral de herramientas en Flujo de Trabajo de Desarrollo Dirigido por Especificaciones: De Requisitos a Código: especificar se convierte en brainstorming, plan se convierte en writing-plans, tareas e implement se fusionan en subagent-driven-development, y validar se divide entre TDD y revisión de código. La diferencia es la imposición: Superpowers está diseñado para que el agente busque estas habilidades automáticamente en lugar de depender de que tú invoques cada fase.

Probándolo: Recorrido de una Primera Tarea

No apuntes Superpowers a tu característica más importante en la primera ejecución. Elige algo real pero acotado: un pequeño endpoint, una corrección de error focalizada, una refactorización de un solo módulo – e inicia una sesión en un proyecto que ya tenga un conjunto de pruebas, ya que la imposición de TDD es más visible allí.

Quiero agregar control de frecuencia (rate limiting) a nuestros endpoints de API pública.

Con Superpowers instalado, espera que la sesión se abra con preguntas de lluvia de ideas en lugar de código: qué endpoints, qué límite, por usuario o por clave, qué debería suceder cuando se alcance el límite. Esa fricción es intencional: es la misma disciplina de no-objetivos cubierta en Flujo de Trabajo de Desarrollo Dirigido por Especificaciones: De Requisitos a Código, solo que impuesta por la habilidad en lugar de dejarte a ti recordarlo. Una vez que apruebas el diseño en fragmentos, espera un plan con tareas pequeñas y numeradas antes de cualquier cambio de archivo, luego un subagente despachado por tarea con un diff que revisas en cada punto de control.

Dos cosas a vigilar en una primera ejecución:

• Confirma que la TDD se imponga realmente. Pide al agente que implemente una tarea y verifica si aparece una prueba que falle antes de la implementación. Si el código llega primero, la habilidad no se activó para ese paso, y vale la pena reejecutar el control de descubrimiento de la sección de instalación.
• Vigila la granularidad de la tarea. El tamaño de tarea de dos a cinco minutos es agresivo para algunos base de código. Si las tareas se sienten innecesariamente fragmentadas para tu proyecto, vale la pena señalarlo durante el punto de control de revisión de writing-plans en lugar de después.

Lo Que Hay Dentro: La Biblioteca de Habilidades

Más allá de las siete habilidades del flujo de trabajo, Superpowers incluye habilidades de soporte agrupadas por área:

dispatching-parallel-agents merece una mención aparte: cubre flujos de trabajo de subagentes concurrentes, que es el mismo terreno que Subagentes de Claude Code – contexto aislado, revisión independiente y un resumen reportado de vuelta a la sesión principal en lugar de inundarla con salida intermedia.

Cuando Superpowers Encaja (y Cuando No)

Buen ajuste:

• Ya te gusta el enfoque de habilidades de Claude Code para Desarrollo Dirigido por Especificaciones vs Vibe Coding pero sigues deslizándote hacia el prompting no estructurado porque nada impone las puertas de revisión.
• Trabajas con múltiples agentes de codificación y quieres una metodología que te acompañe en lugar de una habilidad exclusiva de Claude Code.
• Quieres una estricta imposición de TDD sin escribir tú mismo la lógica de imposición.
• Características de multi-sesión donde la deriva arquitectónica y las restricciones olvidadas son un riesgo real: el exacto modo de falla descrito en Desarrollo Dirigido por Especificaciones vs Vibe Coding.

Ajuste más débil:

• Scripts rápidos, prototipos desechables y automatización de una sola vez: la sobrecarga de lluvia de ideas y planificación es real, y no vale la pena pagarla por un cambio de cincuenta líneas.
• Equipos con una habilidad SDD específica del proyecto, ya existente y bien ajustada. Superpowers cambia esa personalización por una ceremonia impuesta y opinada; quizás prefieras mantener lo que ya funciona y tomar prestados solo ideas de habilidades individuales.
• Entornos donde la estricta granularidad de tareas de dos a cinco minutos o la TDD obligatoria entrarían en conflicto con un proceso de equipo establecido que no estás listo para cambiar.

Cómo Difiere Superpowers de Otras Herramientas de SDD

Superpowers no es un competidor de GitHub Spec Kit o AWS Kiro en el sentido usual: opera en la capa de habilidades de Claude Code / multi-agente en lugar de ser un CLI o IDE autónomo. Spec Kit te ofrece artefactos markdown portátiles e independencia de agentes; Kiro te ofrece una experiencia de IDE guiada e integrada; una habilidad de Claude Code hecha a mano te ofrece máxima flexibilidad con cero imposición. Superpowers se sitúa entre las dos últimas: el mismo mecanismo basado en habilidades que un flujo de trabajo de Claude Code hecho por ti mismo, pero con una imposición que se siente obligatoria y una distribución de plugins entre agentes que una habilidad local al repositorio no proporciona.

Para el desglose completo de portabilidad, fricción de configuración, puertas de revisión y dependencia tecnológica en Spec Kit, Kiro, habilidades de Claude Code, OpenSpec, BMAD-METHOD y Tessl – incluyendo dónde se ubica Superpowers en la tabla de comparación y el marco de decisión – mira GitHub Spec Kit vs Kiro vs Flujos de Trabajo SDD de Claude Code. Si quieres menos ceremonia impuesta y más libertad para iterar sobre una base de código existente (brownfield), la guía de inicio rápido de OpenSpec cubre la alternativa más ligera y centrada en el cambio. Y si los roles que te faltan son los que Superpowers no cubre – revisión de producto, QA de navegador, auditoría de seguridad, ingeniería de lanzamientos – gstack los empaqueta como un equipo de ingeniería virtual que puede combinarse con Superpowers, con Superpowers proporcionando la disciplina dentro de la fase de implementación.

Solución de Problemas y Cosas a Saber

Las actualizaciones son mayormente automáticas pero dependen del agente. Lo actual que se mantenga tu instalación depende de la herramienta de ejecución: Antigravity reejecuta el gancho de inicio de sesión al reinstalar, las instalaciones basadas en npm o Git requieren un comando de actualización explícito, y las instalaciones basadas en mercado suelen seguir el flujo de actualización de plugins propio del agente anfitrión.

La telemetría está activada por defecto pero es fácil de desactivar. El compañero visual opcional de la habilidad de brainstorming carga el logotipo de Prime Radiant desde su sitio web, que incluye tu versión de Superpowers pero no datos de proyecto, prompt o clics. Establece SUPERPOWERS_DISABLE_TELEMETRY a cualquier valor verdadero para desactivarla. Superpowers también respeta las exenciones propias de Claude Code DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Las contribuciones requieren la rama dev. Si quieres modificar o agregar habilidades, haz un fork del repositorio, cambia a dev y sigue la habilidad writing-skills para crear y probar cambios: las contribuciones de nuevas habilidades específicamente generalmente no son aceptadas, ya que cada habilidad debe funcionar de manera idéntica en todos los agentes soportados.

Si una habilidad no se activa, trátalo como cualquier otro problema de habilidad de Claude. Pregunta “¿Qué habilidades están disponibles?” para confirmar el descubrimiento, verifica que hayas instalado para el agente específico que estás usando actualmente (no para otro en la misma máquina), y recuerda que las sesiones de Hermes necesitan un inicio nuevo después de la compactación de sesión larga si el arranque se pierde silenciosamente.

Conclusión

Superpowers vale la pena instalarlo cuando la brecha entre tus intenciones de SDD y lo que realmente sucede en una sesión es el problema que estás intentando resolver. No introduce una nueva idea de especificar-planificar-implementar: ese bucle ya está bien cubierto por ¿Qué es el Desarrollo Dirigido por Especificaciones?: hace más difícil saltarse una idea existente y lo hace a través de más agentes de los que puede alcanzar una habilidad local al repositorio. Instálalo primero en la herramienta de ejecución que usas a diario, ejecuta una tarea pequeña y acotada a través del ciclo completo de lluvia de ideas a finalización, y decide desde allí si la ceremonia impuesta justifica su mantenimiento en tu carga de trabajo real.

Enlaces Útiles

• Repositorio de Superpowers – fuente, habilidades y manifiestos de plugins para cada agente soportado
• Mercado de Superpowers – Mercado de Claude Code para Superpowers y plugins relacionados
• GitHub Spec Kit vs Kiro vs Flujos de Trabajo SDD de Claude Code – comparación completa de herramientas y marco de decisión
• Habilidades de Claude y SKILL.md para desarrolladores – la mecánica subyacente de habilidades sobre la que Superpowers se construye
• Subagentes de Claude Code: Configuración, Ajustes y Cuándo Usarlos – revisión de contexto aislado, el mecanismo detrás de subagent-driven-development
• Flujo de Trabajo de Desarrollo Dirigido por Especificaciones: De Requisitos a Código – el proceso de cinco fases neutral de herramientas que Superpowers automatiza
• ¿Qué es el Desarrollo Dirigido por Especificaciones? La Especificación como Fuente de Verdad – conceptos y terminología básicos de SDD
• Instalación y configuración de Claude Code para Ollama, llama.cpp, precios – instala Claude Code en sí mismo antes de agregar Superpowers