Guía de inicio rápido de Superpowers: instalación, flujo de trabajo y prueba

Superpowers empaqueta una metodología completa basada en especificaciones en habilidades de Claude instalables, aplicando lluvia de ideas, planificación, implementación dirigida por subagentes y TDD estricto, en lugar de dejar esa estructura a tu criterio.

La mayoría de las configuraciones de SDD 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, en cuanto se acerca un plazo, regresa de forma silenciosa al prompting desestructurado. Nada en una habilidad hecha a mano detiene 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 de rojo-verde- refactorizar como pasos obligatorios que el agente verifica antes de cada tarea, no como sugerencias opcionales que puede omitir bajo presión.

Lo que lo hace digno de una revisión detallada en lugar de una nota al margen es la historia de la 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 distintos entornos de trabajo, 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 usas, 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 programación, construida sobre un conjunto de habilidades componibles y algunas instrucciones iniciales que se aseguran de que tu agente las utilice”. Esa última cláusula es la parte que importa. Existen muchas colecciones de habilidades; el diferenciador aquí es la instrucción de arranque que fuerza 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 requerir que recuerdes un comando de barra.

La filosofía detrás de esto se enuncia claramente en la propia documentación del proyecto:

• Desarrollo Orientado a Pruebas – escribe pruebas primero, siempre
• Sistemático sobre ad-hoc – proceso sobre conjeturas
• Reducción de complejidad – la simplicidad como objetivo principal
• Evidencia sobre afirmaciones – verifica antes de declarar el éxito

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

Instalación de Superpowers en varios agentes de programación

La instalación es específica de cada entorno de trabajo, 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 de plugins para Claude Code:

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

O a través del mercado de plugins 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

Varios detalles de la instalación conviene señalarlos 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 la instrucción inicial 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 de habilidades.
• Hermes Agent no tiene un hook de pos-compactación: una sesión muy larga que se compacta sobre su primer turno puede perder la instrucción inicial, 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 de trabajo que ya uses, incluso en la misma máquina.

Verificar la instalación

Una vez instalado, pregunta 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. Esta es la misma comprobación de descubrimiento recomendada 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 se activa en un punto específico y pasa el testigo a la siguiente:

⬇

1. brainstorming se activa antes de que se escriba 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 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 cada tarea, con una revisión de dos etapas: primero cumplimiento de la especificación, luego calidad del código.
5. test-driven-development impone un estricto rojo-verde-refactorizar: escribir una prueba que falle, verla fallar, escribir el código mínimo para pasar, verla pasar, confirmar los cambios. El código escrito antes de que existiera una prueba que fallara para él se elimina, no se mantiene.
6. requesting-code-review se activa entre tareas, revisando el diff contra el plan y reportando problemas por gravedad; los problemas críticos bloquean el progreso hacia la siguiente tarea.
7. finishing-a-development-branch se activa una vez que todas las tareas están completadas. Verifica que las pruebas pasen y luego presenta opciones: fusionar, abrir una solicitud de pull, mantener la rama o descartar; y limpia el worktree.

Esto se corresponde estrechamente con el ciclo de cinco fases neutral con respecto a herramientas en Flujo de trabajo de Desarrollo Basado en Especificaciones: de los Requisitos al Código: especificar se convierte en lluvia de ideas, planificar se convierte 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: Superpowers está diseñado para que el agente busque estas habilidades automáticamente, en lugar de depender de que tú invoques cada fase.

Prueba práctica: recorrido por una primera tarea

No apuntes a la función más importante con tu primera ejecución. Elige algo real pero acotado: un pequeño endpoint, una corrección de errores enfocada, una refactorización de un solo módulo; e inicia una sesión en un proyecto que ya tenga una suite de pruebas, ya que la aplicación del TDD es más visible allí.

Quiero agregar limitación de tasa a nuestros puntos finales de API pública.

Con Superpowers instalado, espera que la sesión comience 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 objetivos no cubiertos descrita en Flujo de trabajo de Desarrollo Basado en Especificaciones: de los Requisitos al Código, solo que aplicada por la habilidad en lugar de dejada a tu memoria. Una vez que apruebes el diseño por fragmentos, espera un plan con tareas pequeñas y numeradas antes de cualquier cambio de archivo, y luego un subagente despachado por cada 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 está aplicando 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 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.
• Observa la granularidad de las tareas. El dimensionado de tareas de dos a cinco minutos es agresivo para algunas bases de código. Si las tareas se sienten innecesariamente fragmentadas para tu proyecto, eso vale la pena mencionarlo durante el punto de control de revisión de writing-plans, en lugar de después de los hechos.

Qué 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 vale la pena mencionarse por separado: 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.

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

Buen ajuste:

• Ya te gusta el enfoque de habilidades de Claude Code para el Desarrollo Basado en Especificaciones vs Vibe Coding, pero sigues deslizándote hacia el prompting desestructurado porque nada aplica las puertas de revisión.
• Trabajas con varios agentes de programación y quieres una metodología que te acompañe, en lugar de una habilidad solo para Claude Code.
• Quieres una aplicación estricta de TDD sin escribir la lógica de aplicación tú mismo.
• Funciones de múltiples sesiones donde la deriva arquitectónica y las restricciones olvidadas son un riesgo real: el modo de falla exacto descrito en Desarrollo Basado en Especificaciones vs Vibe Coding.

Ajuste más débil:

• Scripts rápidos, prototipos desechables y automatización puntual: el sobrecosto de la lluvia de ideas y la planificación es real, y no vale la pena pagarlo en un cambio de cincuenta líneas.
• Equipos con una habilidad SDD específica del proyecto ya existente y bien ajustada. Superpowers intercambia esa personalización por una ceremonia opinada y obligatoria; es posible que prefieras mantener lo que ya funciona y solo tomar prestadas ideas individuales de habilidades.
• Entornos donde la granularidad estricta 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 se diferencia Superpowers de otras herramientas 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 / agentes cruzados en lugar de ser un CLI independiente o un IDE. Spec Kit te ofrece artefactos de markdown portables e independencia del agente; 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 aplicación. Superpowers se sitúa entre los dos últimos: 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 entre agentes 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 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 de comparación y el marco de decisión: consulta GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows. Si quieres menos ceremonia aplicada y más libertad para iterar en una base de código existente, la guía de inicio rápido de OpenSpec cubre la alternativa más ligera y centrada en el cambio.

Solución de problemas y cosas a saber

Las actualizaciones son en su mayoría automáticas, pero dependen del agente. Qué tan actualizada permanece tu instalación depende del entorno de trabajo: 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 de plugins 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 lluvia de ideas carga el logotipo de Prime Radiant desde su sitio web, lo que incluye tu versión de Superpowers pero no datos de proyecto, prompt o clics. 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 quieres modificar o agregar habilidades, haz una bifurcación del repositorio, cambia a dev y sigue la habilidad writing-skills para crear y probar cambios: las contribuciones de nuevas habilidades en particular 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átala como cualquier otro problema de habilidades de Claude. Pregunta “¿Qué habilidades están disponibles?” para confirmar el descubrimiento, verifica que instalaste para el agente específico que estás usando actualmente (no otro diferente 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 la instrucción inicial 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 ¿Qué es el Desarrollo Basado en Especificaciones?: hace que una idea existente sea más difícil de omitir, y lo hace en más agentes de los que una habilidad local del repositorio puede alcanzar. Instálalo primero en el entorno de trabajo que usas a diario, ejecuta una pequeña tarea acotada a través del ciclo completo de lluvia de ideas a finalización, y decide desde allí si la ceremonia obligatoria 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 plugins de Superpowers – mercado de plugins 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 y SKILL.md para desarrolladores – las mecánicas subyacentes de habilidades sobre las que se construye Superpowers
• Subagentes de Claude Code: configuración, instalación y cuándo usarlos – revisión de contexto aislado, el mecanismo detrás de subagent-driven-development
• Flujo de trabajo de Desarrollo Basado en Especificaciones: de los Requisitos al Código – el proceso neutral con respecto a herramientas de cinco fases que Superpowers automatiza
• ¿Qué es el Desarrollo Basado en Especificaciones? La Especificación como Fuente de Verdad – conceptos y terminología centrales de SDD
• Instalación y configuración de Claude Code para Ollama, llama.cpp, precios – instala Claude Code en sí antes de agregar Superpowers