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

Superpowers empaqueta una metodología completa basada en especificaciones en habilidades (Skills) de Claude instalables, imponiendo la lluvia de ideas (brainstorming), la planificación, la implementación impulsada por subagentes y un TDD estricto, en lugar de dejar esa estructura a tu criterio.

La mayoría de las configuraciones de SDD (Spec-Driven Development) en Claude Code fallan de la misma manera: alguien escribe una sólida habilidad specify-plan-implement una vez, la usa diligentemente durante una semana y luego, la primera vez que un plazo se acerca, vuelve silenciosamente al prompting no estructurado. Nada en una habilidad hecha a mano impide realmente eso. 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 el TDD rojo-verde-refactorizar como pasos obligatorios que el agente verifica antes de cada tarea, no como sugerencias opcionales que puede saltar bajo presión.

Lo que lo hace digno de una mirada dedicada y no solo de una nota al pie es su historia de instalación. Superpowers incluye manifiestos de plugin 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 sigue a través de los diferentes entornos (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 utilizas, cómo se ve una primera ejecución de principio a fin y dónde encaja junto a otras herramientas de desarrollo basado en 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 (bootstrap) que obliga al agente a buscar habilidades relevantes antes de comenzar cualquier tarea, para que el flujo de trabajo se active automáticamente en lugar de requerir que recuerdes un comando con barra diagonal.

La filosofía detrás se enuncia con claridad en los propios documentos del proyecto:

• Desarrollo Guiado por Pruebas (Test-Driven Development) – escribe pruebas primero, siempre
• Sistemático sobre ad-hoc – proceso sobre suposiciones
• Reducción de complejidad – la simplicidad como objetivo principal
• Evidencia sobre afirmaciones – verifica antes de declarar éxito

En la práctica, esa filosofía se manifiesta como una secuencia de habilidades que se pasan el testigo entre sí. Si has leído Claude Skills and SKILL.md for Developers, los mecanismos te resultarán familiares: 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 redactes.

Instalación de Superpowers en distintos agentes de codificación

La instalación es específica de cada entorno (harness), y el proyecto es explícito en que debes instalarlo por separado para cada agente que uses; no existe una instalación global única.

Claude Code

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

# Mercado de plugins oficial 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

Hay algunos detalles de instalación que vale la pena señalar antes de ejecutar una tarea real:

• Antigravity ejecuta automáticamente el hook 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 bootstrap using-superpowers al inicio de la sesión y después de la compactación de contexto, y no requiere la herramienta de compatibilidad Skill de Pi, ya que Pi tiene soporte nativo para habilidades.
• Hermes Agent no tiene un hook post-compactación: una sesión muy larga que se compacte sobre su primer turno puede perder el bootstrap, 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 otro entorno 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:

What skills are available?

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. Esta es la misma comprobación de descubrimiento recomendada para depurar Claude Skills 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 pasando el testigo a la siguiente:

⬇

1. brainstorming se activa antes de que se escriba cualquier código. Refina una idea aproximada mediante 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 manejable – 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 el cumplimiento de la especificación, luego la calidad del código.
5. test-driven-development impone un estricto rojo-verde-refactorizar: escribe una prueba que falle, observa que falle, escribe el código mínimo para que pase, observa que pase y hace el commit. El código escrito antes de que existiera una prueba fallida para él se elimina, no se conserva.
6. requesting-code-review se activa entre tareas, revisando el diff contra el plan e informando los 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 y luego presenta opciones: fusionar (merge), abrir una PR, mantener la rama o descartar – y limpia el worktree.

Esto se corresponde estrechamente con el ciclo de cinco fases neutro de herramientas en Spec-Driven Development Workflow From Requirements to Code: especificar se convierte en brainstorming, planificar en writing-plans, las tareas y la implementación se integran en subagent-driven-development, y validar se divide entre TDD y revisión de código. La diferencia es la aplicación forzada: 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: Un recorrido por 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 enfocada, un refactor de un solo módulo – y comienza una sesión en un proyecto que ya tenga un conjunto de pruebas, ya que la aplicación del TDD es más visible allí.

I want to add rate limiting to our public API endpoints.

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 pasar cuando se alcanza el límite. Esa fricción es intencional; es la misma disciplina de no-objetivos cubierta en Spec-Driven Development Workflow From Requirements to Code, solo que aplicada por la habilidad en lugar de dejada a tu memoria. Una vez que apruebes el diseño en fragmentos, espera un plan con tareas pequeñas y numeradas antes de que se cambie cualquier archivo, y luego un subagente despachado por tarea con un diff que tú revisas en cada punto de control.

Dos cosas a vigilar en una primera ejecución:

• Confirma que el TDD se aplique realmente. Pide al agente que implemente una tarea y verifica si aparece una prueba fallida antes de la implementación. Si el código aparece primero, la habilidad no se activó para ese paso, y vale la pena volver a ejecutar la comprobación de descubrimiento de la sección de instalación.
• Vigila la granularidad de las tareas. El dimensionado de tareas de dos a cinco minutos es agresivo para algunos bases de código. Si las tareas se sienten innecesariamente fragmentadas para tu proyecto, vale la pena mencionarlo durante el punto de control de revisión de writing-plans, en lugar de después de los hechos.

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 ser destacado por separado: cubre flujos de trabajo de subagentes concurrentes, que es el mismo terreno que Claude Code subagents – contexto aislado, revisión independiente y un resumen reportado de vuelta a la sesión principal en lugar de inundarla con salida intermedia.

Cuándo encaja Superpowers (y cuándo no)

Buen ajuste:

• Ya te gusta el enfoque de habilidades de Claude Code para Spec-Driven Development vs Vibe Coding, pero sigues volviendo al prompting no estructurado porque nada aplica 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 aplicación estricta del TDD sin escribir tú la lógica de aplicación.
• Características multi-sesión donde la deriva arquitectónica y las restricciones olvidadas son un riesgo real: el exacto modo de fallo descrito en Spec-Driven Development vs Vibe Coding.

Ajuste más débil:

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

Cómo difiere Superpowers de otras herramientas SDD

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

Para el desglose completo de portabilidad, fricción de configuración, puertas de revisión y dependencia (lock-in) a través de Spec Kit, Kiro, habilidades de Claude Code, OpenSpec, BMAD-METHOD y Tessl – incluyendo dónde se ubica Superpowers en la tabla comparativa y el marco de decisión – consulta GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Solución de problemas y cosas a saber

Las actualizaciones son en su mayoría automáticas pero dependen del agente. Qué tan actualizado se mantenga tu instalación depende del entorno: Antigravity vuelve a ejecutar el hook de inicio de sesión al reinstalar, las instalaciones basadas en npm o Git necesitan un comando de actualización explícito, y las instalaciones basadas en el mercado generalmente siguen el flujo de actualización de plugins del propio 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, lo que incluye tu versión de Superpowers pero ningún dato de proyecto, prompt o clic. Establece SUPERPOWERS_DISABLE_TELEMETRY a cualquier valor verdadero para desactivarlo. Superpowers también respeta las exclusiones propias de Claude Code DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Las contribuciones requieren la rama dev. Si deseas modificar o agregar habilidades, forkea el repositorio, cambia a dev y sigue la habilidad writing-skills para crear y probar cambios; las contribuciones de nuevas habilidades específicamente generalmente no se aceptan, ya que cada habilidad debe funcionar de manera idéntica en todos los agentes compatibles.

Si una habilidad no se activa, trátalo como cualquier otro problema de Claude Skill. Pregunta “What skills are available?” 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 sesiones largas si el bootstrap se pierde silenciosamente.

Conclusión

Superpowers vale la pena instalar 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 ciclo ya está bien cubierto por What Is Spec-Driven Development? – hace que una idea existente sea más difícil de saltarse, y lo hace a través de más agentes de los que una habilidad local del repositorio puede alcanzar. Instálalo primero en el entorno que usas a diario, ejecuta una pequeña tarea acotada a través del ciclo completo de brainstorming a finalización, y decide desde allí si el ceremonial aplicado vale la pena en tu carga de trabajo real.

Enlaces útiles

• Repositorio de Superpowers – código fuente, habilidades y manifiestos de plugin para cada agente compatible
• Mercado de Superpowers – mercado de Claude Code para Superpowers y plugins relacionados
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – comparación completa de herramientas y marco de decisión
• Claude Skills and SKILL.md for Developers – los mecanismos subyacentes de habilidades sobre los que Superpowers se construye
• Claude Code Subagents: Setup, Config, and When to Use Them – revisión con contexto aislado, el mecanismo detrás de subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – el proceso de cinco fases neutro de herramientas que Superpowers automatiza
• What Is Spec-Driven Development? The Spec as Source of Truth – conceptos y terminología centrales de SDD
• Claude Code install and config for Ollama, llama.cpp, pricing – instala Claude Code mismo antes de agregar Superpowers