Superpowers de Claude Code: framework de skills para un desarrollo de IA estructurado

Claude Code puede escribirte tan ricamente mil líneas de código que no has pedido.

La mayoría de las veces solo necesitas un pequeño ajuste, pero te devuelve un refactor, lógica "mejorada", tres archivos nuevos y tests que pasan porque no comprueban nada. El agente nunca preguntó qué querías construir realmente ni se paró a revisar su propio trabajo. Ese es el comportamiento por defecto de muchos asistentes de código, y por eso tantas sesiones se alargan dos horas para tareas de 15 minutos.

Superpowers es un plugin de Claude Code creado por Jesse Vincent que soluciona esto al mostrarle a Claude un flujo de trabajo de ingeniería disciplinado. Cubre la lluvia de ideas, el desarrollo guiado por pruebas (TDD), la depuración sistemática, el desarrollo con subagentes, la revisión de código y la autoría de skills, para que Claude se comporte más como una persona ingeniera en la que puedes confiar.

En este artículo, te explico qué es Superpowers, cómo funcionan sus skills y cómo usarlo para un desarrollo asistido por IA con estructura.

Si estás empezando con la IA generativa, apúntate a nuestro curso Generative AI Concepts: te dará una base sólida en una tarde.

¿Qué es Claude Code Superpowers?

Superpowers es un framework de skills que intenta convertir a Claude Code en una ingeniera disciplinada.

Es un plugin creado por Jesse Vincent y el equipo de Prime Radiant, distribuido a través del marketplace oficial de plugins de Claude. El plugin instala una biblioteca de skills componibles que cubren todo el ciclo de vida del desarrollo de software, desde afinar requisitos hasta fusionar una rama terminada.

Cada skill es una metodología estructurada para un tipo de tarea. Algunas cubren planificación y diseño, otras son para implementación, depuración, pruebas o revisión. Funcionan en conjunto, así que Claude puede encadenarlas en un flujo completo en lugar de tratar cada petición como algo aislado.

Con Superpowers, tienes un agente de código que se detiene a pensar, escribe los tests antes del código, depura desde la causa raíz en lugar de adivinar y revisa su propio trabajo antes de darlo por finalizado.

Cómo funciona Claude Code Superpowers

Superpowers cambia el comportamiento de Claude dándole un conjunto de skills a las que puede recurrir, además de comandos con barra para ejecutar flujos de trabajo específicos.

Una skill es un pequeño archivo markdown con una metodología clara escrita para que Claude la siga. Cuando una tarea encaja con la finalidad de una skill, Claude la lee y aplica los pasos. No tienes que memorizar qué hace cada skill. Claude comprueba si hay skills relevantes antes de empezar cualquier tarea y las incorpora automáticamente.

También puedes disparar flujos con comandos de barra. Por ejemplo, describir lo que quieres construir activa automáticamente la sesión de diseño socrático de la skill de brainstorming. Una vez aprobado el diseño, la skill writing-plans lo descompone en tareas pequeñas y verificables, y executing-plans o subagent-driven-development ejecuta ese plan con puntos de control de revisión integrados.

El patrón general sigue siempre tres pasos:

1. Invoques una skill describiendo la tarea o ejecutando un comando de barra.
2. Claude sigue la metodología de la skill paso a paso, en lugar de improvisar. Para depuración, eso significa un proceso de causa raíz en cuatro fases. Para TDD, significa escribir un test que falle antes de cualquier código de implementación.
3. Los puntos de control o revisiones guían la tarea. Algunas skills se detienen para pedir tu aprobación antes de continuar. Otras lanzan un nuevo subagente para revisar el trabajo respecto al plan y señalar incidencias por gravedad.

El agente no espera a que escribas el prompt perfecto porque ya conoce el proceso y lo recorre, pidiendo tu input solo cuando hay decisiones que realmente te necesitan. Esto hace que el framework se sienta distinto al uso normal de Claude Code.

Skills clave en Claude Code Superpowers

Superpowers viene con una biblioteca de skills, pero solo necesitas conocer unas pocas que hacen la mayor parte del trabajo.

Brainstorming

La skill brainstorming se activa antes de escribir una sola línea de código.

Fuerza un diálogo socrático que afina lo que realmente quieres, en vez de dejar que Claude salte directo a una solución. Claude hace preguntas incisivas y explora alternativas que quizá no habías considerado.

El resultado es un documento de diseño dividido en secciones pequeñas que puedes leer y verificar. Nada avanza hasta que apruebas el diseño, lo que corta de raíz el problema de "Claude construyó lo que no era".

Desarrollo guiado por pruebas

La skill test-driven-development impone el ciclo clásico RED-GREEN-REFACTOR.

• RED: Claude escribe primero un test que falle y lo ejecuta para confirmar que falla por el motivo correcto.
• GREEN: Claude escribe el mínimo código necesario para que el test pase.
• REFACTOR: Una vez que el test está en verde, Claude limpia la implementación sin cambiar el comportamiento.

Los tests deben fallar antes de escribir cualquier código de implementación. Si Claude escribe código antes de que exista un test, la skill le indica que lo borre y empiece de nuevo. Es una regla estricta.

Depuración sistemática

La skill systematic-debugging sustituye los parches aleatorios por un proceso en cuatro fases.

1. Investigación de la causa raíz: Claude reproduce el bug y lo rastrea hasta su origen real en lugar de trabajar sobre el primer síntoma que encuentra.
2. Análisis de patrones: Claude busca problemas relacionados en otras partes del código que compartan la misma causa.
3. Prueba de hipótesis: Claude formula una teoría explícita sobre la corrección y la valida antes de cambiar nada.
4. Implementación: Solo después de las tres fases anteriores Claude escribe la solución.

La skill también incorpora un mecanismo de seguridad. Si fallan tres intentos de arreglo consecutivos, Claude deja de mirar el código y ejecuta una revisión arquitectónica. Así evita el bucle de pequeños parches cuando el problema requiere replantear el diseño.

Desarrollo con subagentes

La skill subagent-driven-development reparte el trabajo entre subagentes nuevos en lugar de hacerlo todo en un contexto largo.

Para cada tarea del plan, Claude crea un subagente. Ese subagente implementa la tarea y, después, un subagente de revisión independiente ejecuta una comprobación en dos etapas: primero contra las especificaciones y luego contra la calidad del código. Si alguna verificación falla, la tarea vuelve a corrección antes de pasar a la siguiente.

Cada subagente solo ve lo que necesita para su tarea específica, y el paso de revisión detecta desvíos antes de que se conviertan en un problema.

Autoría de skills

La skill writing-skills te permite crear nuevas skills para Superpowers.

Claude te guía para escribir la metodología de la skill, probarla en escenarios reales y refinarla según su desempeño. Se aplica la misma disciplina TDD: defines lo que debe hacer la skill, escribes tests para ese comportamiento y solo entonces escribes las instrucciones de la skill.

Esto hace que Superpowers sea extensible. Puedes codificar las convenciones específicas de tu equipo o tus checklists de revisión, y Claude las seguirá como cualquier otra parte del framework.

Comandos con barra de Superpowers

Los comandos con barra sirven para decirle a Claude qué flujo de trabajo ejecutar.

Puedes describir una tarea en inglés sencillo y dejar que Claude elija la skill adecuada, o tener control directo con los comandos de barra. Son útiles cuando sabes exactamente en qué fase del flujo quieres estar y no quieres que Claude adivine.

Los comandos se mapean a puntos concretos del ciclo de vida del desarrollo. Algunos ejecutan un flujo desde cero, otros un paso concreto dentro de uno mayor.

Una sesión típica podría ser así:

• Empiezas con /superpowers:brainstorm para afinar requisitos de una nueva funcionalidad. Claude realiza una sesión de preguntas socráticas, saca a la luz casos límite y produce un documento de diseño para que lo apruebes.

• Una vez aprobado el diseño, ejecutas /superpowers:plan para dividirlo en tareas pequeñas y verificables con rutas de archivo exactas y cambios de código.

• Después, /superpowers:execute-plan recorre esas tareas con puntos de control integrados, creando subagentes y haciendo pausas para revisión según marque el plan.

• Tras la implementación, /superpowers:review lanza el agente revisor de código para detectar problemas antes de seguir.

Nota: Superpowers está en desarrollo muy activo. En el momento de escribir esto, acababa de publicar una nueva versión el día anterior, y los nombres exactos de los comandos pueden cambiar entre versiones, así que revisa el repositorio de GitHub del proyecto para ver la sintaxis actual.

Revisión de código en Superpowers

Después de que Claude implemente una tarea o un lote de tareas, el agente revisor de código se ejecuta como un subagente independiente con un contexto limpio. No ve el historial de la conversación que llevó a la implementación, solo el plan, el código y los criterios de revisión. Esto importa porque quieres que la revisión sea lo más imparcial posible.

El revisor comprueba tres cosas:

1. Implementación frente al plan: ¿Hace el código lo que el plan decía? ¿Faltan piezas o se han colado extras?
2. Estándares de codificación: ¿Sigue el código las convenciones del proyecto? Incluye nombrado, formato, gestión de errores y cualquier regla de tu archivo CLAUDE.md.
3. Consistencia arquitectónica: ¿Encaja el código en la estructura existente de la base de código o ha introducido Claude un patrón nuevo que no corresponde?

Los problemas se devuelven clasificados por gravedad. Las incidencias críticas bloquean el progreso hasta que se solucionan. Las de menor gravedad se reportan para que decidas qué abordar ahora y qué más adelante.

En resumen, Claude no puede dar una tarea por terminada solo porque compile o pasen los tests. Un agente separado debe confirmar que el trabajo se ajusta al plan y encaja en la base de código.

TDD con Claude Code Superpowers

La mayoría de asistentes de código tratan los tests como un "estaría bien".

Pides una funcionalidad, la escriben y los tests aparecen después, si es que aparecen. El resultado es código que "funciona" porque nadie ha demostrado lo contrario. Superpowers hace que el test sea lo primero que escribe Claude y el filtro para todo lo que viene después.

La skill test-driven-development guía a Claude por el ciclo RED-GREEN-REFACTOR en cada cambio.

Paso 1: escribir un test que falle

Claude escribe un test para el comportamiento que quieres y lo ejecuta.

El test debe fallar. Si pasa a la primera, significa que el comportamiento ya existe o que el test no comprueba lo que debería. En cualquier caso, Claude no avanza hasta que el test falle y el motivo del fallo esté claro.

Este paso también obliga a Claude a pensar qué significa "estar hecho" antes de implementar nada. El test es una especificación ejecutable.

Paso 2: implementar la corrección mínima

Claude escribe la menor cantidad de código que haga pasar el test que fallaba.

El objetivo es pasar de RED a GREEN con el mínimo código. Si Claude intenta hacer más, la skill lo limita. Aquí aparece YAGNI (You Aren't Gonna Need It). Claude solo construye lo que necesitas hoy, no lo que quizá necesites en el futuro.

Paso 3: refactorizar

Una vez que el test está en verde, Claude limpia el código sin cambiar lo que hace.

El paso de refactor es donde mejora la estructura. Claude puede extraer una ayuda o dividir una función larga, pero el test debe seguir pasando tras cada cambio. Si un refactor rompe el test, se revierte.

Paso 4: revisión

El agente revisor de código se ejecuta contra el nuevo código antes de empezar la siguiente tarea.

Comprueba la implementación frente al plan, el test frente al requisito y todo el cambio frente a los estándares del proyecto. Si algo falla, la tarea no está hecha.

La regla es que el código escrito antes de que exista un test se borra. Si Claude se adelanta e implementa algo sin un test fallando primero, la skill le indica que tire ese código y empiece el ciclo como es debido.

Depuración con Claude Code Superpowers

La depuración es un área donde las herramientas de IA aún cojean, incluso en 2026.

La skill systematic-debugging se diseñó para evitarlo.

En lugar de parches aleatorios, Claude recorre cuatro fases en orden. Primero, la investigación de la causa raíz: reproducir el bug de forma fiable y rastrearlo hasta el origen real, no el primer síntoma. Después, el análisis de patrones, donde Claude busca problemas relacionados que compartan la misma causa. Luego, la prueba de hipótesis, donde Claude expone una teoría explícita sobre la solución y la valida antes de modificar nada. Solo después llega la implementación.

Esto es más lento por intento pero mucho más rápido en conjunto. Pasas menos tiempo viendo a Claude adivinar y más arreglando el problema de verdad.

La skill también tiene un cortafuegos integrado cuando algo va mal. Si fallan tres intentos de arreglo seguidos, Claude deja de probar parches y ejecuta una revisión arquitectónica.

Varios fallos consecutivos indican que el problema no está donde creías o que el diseño es erróneo. Superpowers trata el tercer fallo como una señal de stop y obliga a dar un paso atrás para ver el conjunto.

Escritura de nuevas skills con Superpowers

Superpowers trae una buena biblioteca por defecto, pero lo mejor es que puedes ampliarla.

Cada equipo tiene convenciones que no encajan al 100% con las buenas prácticas públicas. De serie, Claude no conoce tus convenciones, así que acabas repitiéndolas en cada prompt. Las skills personalizadas evitan eso codificando tus reglas una vez para que Claude las siga siempre.

La skill writing-skills te guía en la creación de una nueva skill. Aplica la misma disciplina TDD que Superpowers usa para el código: define qué debe hacer la skill, escribe tests para ese comportamiento y solo entonces escribe la propia skill.

Escribir una skill

Una skill es un archivo markdown con una metodología que Claude puede seguir.

Empiezas describiendo el problema que resuelve la skill y el disparador que debe activarla. Luego escribes los pasos que debe seguir Claude, las comprobaciones que debe ejecutar y las reglas que nunca debe romper. El formato es texto estructurado, no código, así que cualquiera del equipo puede leerlo y editarlo.

La skill writing-skills te ayuda a evitar las trampas habituales. Las skills demasiado vagas se ignoran y las demasiado rígidas suelen fallar en los casos límite. Las skills que solapan con otras existentes hacen que Claude elija la metodología equivocada.

Probar una skill

Superpowers trata las pruebas de una skill como una tarea de ingeniería. Escribes escenarios que la skill debe cubrir, ejecutas a Claude contra esos escenarios con la skill cargada y compruebas si el comportamiento coincide con lo especificado. Si Claude hace lo incorrecto, hay que ajustar la skill.

Esto aborda la brecha entre lo que quisiste decir y lo que escribiste. Una skill que a ti te parece clara puede ser ambigua para Claude, y la única forma de saberlo es probarla en casos reales.

Mejorarla con el tiempo

La primera versión de una skill suele dejar fuera casos límite que no habías pensado. Quizá Claude sigue la metodología pero se salta un paso que dabas por obvio. Quizá la skill se activa donde no debería. Cada hueco te indica cómo refinarla.

Con el tiempo, tu biblioteca de skills se convierte en el registro de cómo trabaja realmente tu equipo. Contiene los errores que ya habéis pagado y las reglas que surgieron de ellos. Las personas que se incorporan no necesitan aprender tus convenciones porque Claude ya las sigue.

Esto es lo que hace de Superpowers un framework y no solo un plugin.

Las skills por defecto son un punto de partida. El valor real aparece cuando tratas la biblioteca de skills como código que tu equipo posee, revisa y mejora como cualquier otra cosa del repo.

Claude Code Superpowers vs Claude Code estándar

Claude Code estándar es un agente de código de propósito general. Le dices lo que quieres y decide cómo hacerlo.

Esa flexibilidad es la gracia. Puedes pedirle refactorizar un archivo, depurar una función, escribir tests o explicar un trozo de código, y se adapta. Pero la calidad depende de lo bien que lo orientes. Un prompt vago obtiene una respuesta vaga; uno detallado, con restricciones y ejemplos, suele acercarse más a lo que buscas.

Superpowers es todo eso con estructura añadida. Las skills definen cómo aborda Claude tareas específicas, para que no tengas que detallar la metodología cada vez. TDD ya tiene un flujo. La depuración ya tiene un proceso. La revisión de código ya tiene criterios. Te viene hecho de serie.

Aquí tienes una vista comparativa:

Claude Code frente a Superpowers

Claude Code estándar sigue siendo útil porque no toda tarea requiere un flujo, y forzar estructura en un arreglo de cinco líneas es excesivo. Usa Superpowers cuando el trabajo sea mayor de lo que un solo prompt puede describir bien.

Claude Code Superpowers vs otros plugins de Claude

Superpowers no es el único plugin del marketplace de Claude, pero es de los pocos que se centra en el cómo trabajas.

Otros plugins populares resuelven problemas más concretos.

• Frontend Design genera frontends con una estética distintiva, para que tu UI no parezca otra página cualquiera hecha por IA.
• Code Review ejecuta agentes de revisión especializados en pull requests con filtrado por confianza, útil si solo quieres mejorar la fase de revisión.
• Context7 trae documentación y ejemplos de código vivos y específicos de versión desde los repos a tu contexto en Claude, lo que soluciona el problema de "Claude usa APIs desactualizadas".
• Skill Creator te ayuda a crear, evaluar y comparar skills individuales.

Cada uno hace muy bien una cosa. Instalas Frontend Design cuando quieres mejor código de UI. Instalas Context7 cuando quieres documentación actual en contexto.

Superpowers es lo contrario. No añade una capacidad nueva a Claude, cambia cómo aborda todo el ciclo de desarrollo. Lluvia de ideas, planificación, implementación, pruebas, depuración, revisión y merge tienen metodología definida. Las skills trabajan juntas en lugar de ser funciones sueltas.

Puedes usar Superpowers junto con los demás.

Context7 dentro de una sesión de Superpowers significa que Claude sigue un flujo disciplinado y usa documentación actual. Frontend Design dentro de Superpowers significa que tu UI se construye con el mismo ciclo planificar-implementar-revisar que el resto.

¿Quién debería usar Claude Code Superpowers?

Superpowers es más útil cuando el trabajo es lo bastante complejo como para necesitar estructura.

Algunas situaciones concretas:

• Quieres flujos de trabajo de IA disciplinados: has sufrido que Claude produzca código seguro de sí mismo pero erróneo, y quieres un framework que haga que el agente se pare y piense antes de actuar.

• Tu equipo practica TDD: el plugin impone el ciclo, lo que significa que Claude siempre empezará por los tests y producirá el mínimo código para hacerlos pasar.

• Estás montando flujos complejos con Claude Code: las funcionalidades multietapa y los refactors que tocan muchos archivos se benefician de la planificación y la revisión.

• Quieres crear tus propias skills: si has estado escribiendo archivos CLAUDE.md largos para codificar las convenciones de tu equipo, las skills son una forma más limpia de conseguir lo mismo.

Probablemente Superpowers sea demasiado si:

• Quieres ayuda rápida tipo autocompletado: un arreglo de una línea no necesita un proceso de depuración en cuatro fases. Para esto, Claude Code estándar es más rápido.
• Estás escribiendo scripts sencillos de usar y tirar: el código desechable no justifica la sobrecarga de planificar, probar y revisar.

La frontera suele ser cuánto importará ese código después de hoy. Si nunca volverás a verlo, Superpowers es demasiado. Si alguien más lo leerá, ejecutará o mantendrá, probablemente sea una buena elección.

Ventajas y limitaciones

Aunque desarrolladores individuales y equipos de ingeniería pueden beneficiarse de Superpowers, tiene limitaciones y casos en los que quizá no compense la sobrecarga extra.

Ventajas

La metodología estructurada es su principal "reclamo". Claude sigue procesos definidos en tareas donde suele improvisar, lo que hace los resultados más consistentes entre sesiones y entre miembros del equipo.

Esto reduce el comportamiento caótico que frustra de las herramientas de IA para código. Se acabaron los parches aleatorios, las funcionalidades extra no deseadas, los tests omitidos y el "Claude construyó algo distinto a lo que pedí".

TDD y la depuración también merecen mención. Los tests van antes que el código. La depuración empieza en la causa raíz. El framework Superpowers lo impone.

El sistema de autoría de skills hace que el framework sea tuyo. Puedes codificar las convenciones de tu equipo y el conocimiento de tu proyecto en skills que Claude seguirá siempre.

Limitaciones

Hay una curva de aprendizaje. Debes entender qué hace cada skill, cuándo invocarla y cómo se conectan las fases del flujo. Las primeras sesiones te parecerán más lentas que con Claude Code a secas porque estás aprendiendo el framework a la vez que trabajas.

También puede sentirse pesado para tareas simples. No necesitas un proceso de cuatro fases para un arreglo pequeño. Tienes que coger el punto de cuándo usar el framework y cuándo prescindir de él.

Además, el framework depende de que sigas el flujo realmente. Si te saltas la fase de brainstorming, pierdes el documento de diseño del que depende la planificación. Si te saltas la planificación, la ejecución no tiene nada contra lo que ejecutar. Las skills están diseñadas para encadenarse, y romper la cadena rompe el valor.

Ninguna de estas es un impedimento, solo algo a tener en cuenta. Superpowers premia a quienes quieren trabajar así en proyectos grandes. En proyectos pequeños o de demo no es donde brilla.

Conclusión

Superpowers es un plugin que le da a Claude una metodología definida, la misma que seguiría un equipo de ingeniería experimentado: diseño, implementación, pruebas, depuración y revisión.

El valor central es la disciplina. Con Superpowers, Claude deja de adivinar y empieza a seguir procesos que funcionan, lo que significa menos repeticiones por tu parte, menos sesiones desperdiciadas, menos retrabajo y código en el que puedes confiar sin releer cada línea.

Si quieres que Claude se comporte menos como un chatbot y más como una verdadera pareja de ingeniería, Superpowers merece la pena probarlo.

¿Funciona la IA generativa en un entorno empresarial? Apúntate a nuestro curso Generative AI for Business para ver su valor en pymes y grandes empresas.