Superpowers: El Framework de Skills de Claude Code Distribuido como Markdown

Superpowers en un Párrafo

Superpowers (de obra/superpowers) es el plugin de Claude Code, y framework multi-host de skills agénticas, que distribuye una cultura de ingeniería opinada en forma de una carpeta de archivos markdown. La misma carpeta funciona en Claude Code, Cursor, OpenAI Codex, GitHub Copilot CLI, Gemini CLI y OpenCode. Sin modelo afinado, sin SDK propietario, sin plataforma de agentes. Solo un skills/, catorce archivos SKILL.md y un hook de sesión que le dice al agente que los lea antes de hacer cualquier otra cosa.

Creado por Jesse Vincent en octubre de 2025, el proyecto ha acumulado más de 174.000 estrellas en GitHub en siete meses y se publicó como plugin del marketplace de Anthropic a principios de 2026. La popularidad no es lo que lo hace interesante. La apuesta de fondo es que lo que les falta a los agentes de programación de IA no es capacidad, sino disciplina, y que esa disciplina se puede distribuir como texto plano.

Por Qué un Agente Necesita Esto

Un agente de programación moderno es impresionantemente capaz. También falla de formas notablemente consistentes:

• Escribe primero el código, luego el test y se olvida de ejecutarlo.
• Declara que el bug está corregido porque el ejemplo que fallaba ahora parece funcionar.
• Parchea el síntoma y nunca investiga la causa raíz.
• Afirma que el build pasa sin haber ejecutado nunca el build.
• Y cuando se le confronta, sabe perfectamente que debería haberlo hecho de otro modo.

No son lagunas de conocimiento. El agente ya tiene los conceptos correctos en su entrenamiento. Pídele que te dé una clase magistral sobre TDD y lo hará. Lo que le falta es un mecanismo que le obligue a aplicarlos cuando los atajos son más fáciles. Ese es el hueco que Superpowers intenta rellenar.

Qué Es el Framework de Skills de Superpowers

Superpowers es inusualmente pequeño. Consta de tres piezas:

1. Un directorio con catorce skills, cada uno un único archivo SKILL.md con frontmatter YAML y unos pocos cientos de palabras de instrucciones para una práctica de ingeniería: TDD, debugging, brainstorming, escritura de planes, code review, verificación antes de dar algo por terminado.
2. Un hook de inicio de sesión que inyecta un breve documento de bootstrap, según se informa de menos de dos mil tokens, que le dice al agente que invoque la skill relevante antes de hacer cualquier otra cosa.
3. Manifiestos de plugin específicos para cada host que permiten a cada agente descubrir las mismas skills a su manera.

Esa es toda la carga útil. Cultura de ingeniería, distribuida como un repositorio de git que puedes hojear en una hora.

La Metodología en un Solo Ciclo

Una tarea típica pasa por brainstorming, un git worktree, un plan escrito, implementación dirigida por subagentes con TDD por dentro, una pasada de code review desde un agente recién arrancado y un paso de cierre que finaliza la rama. Cada fase tiene su propia skill, y la siguiente fase no empieza hasta que la anterior está terminada. El workflow son las skills, en orden.

Esta es la capa de disciplina para una tarea cada vez. Lo que se monta encima cuando empiezas a ejecutar muchos de estos ciclos en paralelo es una subida aparte, que dejé esbozada en los niveles que faltan en desarrollo asistido por IA.

Un Recorrido por las Skills Representativas

El repositorio incluye catorce skills. Seis de ellas cargan con la mayor parte del peso:

• brainstorming: se niega a escribir código hasta que el agente ha hecho preguntas de clarificación y ha propuesto un diseño que puedas aceptar.
• writing-plans: descompone una funcionalidad en tareas de dos a cinco minutos, con rutas de archivos y tests escritos antes de tocar una sola línea de código.
• test-driven-development: aplica el clásico red/green/refactor y trata el ya escribiré el test después como motivo para borrar la implementación y empezar de cero.
• systematic-debugging: un proceso de cuatro fases que prohíbe explícitamente arreglar lo que aún no has entendido.
• subagent-driven-development: delega la implementación real en un subagente recién arrancado que solo tiene el plan y los tests, y luego envía un segundo agente a revisar el resultado.
• verification-before-completion: obliga al agente a ejecutar el comando de verificación él mismo y a leer la salida antes de afirmar que algo está terminado.

Las ocho restantes cubren git worktrees, ejecución de planes, solicitar y recibir code review, despacho de agentes en paralelo, finalización de ramas, la propia skill de bootstrap using-superpowers, y la meta-skill de escribir nuevas skills.

Skills Multi-Host: No Solo Claude Code

Aunque el marketplace de plugins de Anthropic es el canal de distribución más visible, Superpowers no es un proyecto exclusivo de Claude. El mismo directorio skills/ alimenta a Cursor, OpenAI Codex (CLI y app), GitHub Copilot CLI, Gemini CLI (vía extensión) y al harness open source OpenCode. Cada host recibe un manifiesto ligero como .claude-plugin/, .cursor-plugin/, .codex-plugin/, .opencode/ o gemini-extension.json que apunta su propio mecanismo de descubrimiento al mismo markdown. Las skills en sí son agnósticas al host. Superpowers es cultura de ingeniería portable, no una funcionalidad de un único agente.

Las Leyes de Hierro: Disciplina como Anti-Racionalización

Lee suficientes archivos de skill y emerge un patrón. Cada skill rígida abre con una regla en mayúsculas, no negociable, una Iron Law, seguida de una tabla de red flags: las racionalizaciones que el agente es más probable que use para saltarse la regla.

La skill de TDD abre con:

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST

La Iron Law de verificación es:

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

Y la de debugging:

NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST

Las red flags que las acompañan no perdonan. TDD señala los tests que pasan a la primera, conservar el código borrado como referencia y el eterno solo por esta vez. Verificación señala las palabras should, probably y seems to.

No son pósters motivacionales. Se leen como el feedback de code review de un ingeniero senior codificado en forma de instrucciones. El objetivo no es enseñarle al agente, porque ya conoce las reglas. El objetivo es impedir que el agente se autoconvenza de no seguirlas.

Qué Observar a Continuación

Superpowers se actualiza rápido. Vincent ha sacado varias entregas en su blog desde el post original, incluyendo una quinta versión mayor en marzo de 2026 y un post sin filtros sobre el problema del PR slop agéntico que el proyecto ha sacado a la luz a medida que ha escalado.

La pregunta interesante no es si el enfoque de la disciplina puede funcionar. Los archivos de skill sugieren con bastante claridad que sí. La pregunta más interesante es qué otras partes de una cultura de ingeniería, como el estilo de code review, los runbooks de on-call, la postura de seguridad o la gestión de releases, resultan ser representables como markdown que se puede obligar a seguir a un agente de programación. Una vez que cada agente corre con este tipo de disciplina, coordinar a muchos de ellos pasa a ser la siguiente preocupación, que es exactamente para lo que se construyó el dashboard de agentes de codificación de IA.