claude-code-superpowers-how-i-actually-use-it.html
< BACK Imagen destacada para Cómo uso realmente obra/superpowers — la capa de metodología que le falta a Claude Code

Cómo uso realmente obra/superpowers — la capa de metodología que le falta a Claude Code

Si tus sesiones de Claude Code todavía se sienten como si estuvieras cuidando a un ingeniero junior que se niega a planificar antes de escribir, no estás solo. La versión honesta de trabajar con agentes de código en 2026 es que el agente es rápido, capaz y estructuralmente optimista. Se saltará la lluvia de ideas, ignorará la prueba, escribirá la abstracción equivocada y desplegará el bug. La solución no es un mejor prompt. La solución es una capa de metodología encima del agente.

Esa capa, para mí, es obra/superpowers — el framework de habilidades agentivas de Jesse Vincent para Claude Code. Acercándose a 180,000 estrellas en GitHub a partir de mayo de 2026, actualmente en v5.1.0. No es una plantilla de prompt, no es un paquete de comandos slash, no es una vibra. Es una metodología de desarrollo completa que se dispara automáticamente según el contexto, obliga al desarrollo dirigido por pruebas y divide el trabajo en tareas de 2-5 minutos con especificaciones explícitas.obra/superpowers — Jesse Vincent's agentic skills framework for Claude Code. Approaching 180,000 GitHub stars as of May 2026, currently at v5.1.0. It is not a prompt template, not a slash command pack, not a vibe. It is a complete development methodology that triggers automatically based on context, enforces test-driven development, and breaks work into 2-5 minute tasks with explicit specifications.

He estado ejecutando Superpowers en cada proyecto que toco durante los últimos seis meses — el sitio personal en el que estás leyendo esto, mi trabajo de consultoría en Seahawk Media, el directorio HostList, producción de contenido para el blog y una buena cantidad de trabajo de diseño y herramientas puntuales. La toma honesta, después de tanto uso: es el cambio de productividad más grande en mi flujo de trabajo de Claude Code desde que el agente mismo se lanzó. Este post es el desglose real — qué es, cómo lo uso para las cinco categorías en las que trabajo, y las partes que aún necesitan trabajo.

Qué es realmente Superpowers, en 90 segundos

Superpowers se envía como un plugin de marketplace para Claude Code. Un comando de instalación:

/plugin install superpowers@claude-plugins-official

Después de eso, tu agente Code de Claude tiene acceso a una biblioteca de habilidades componibles. Cada habilidad es un archivo markdown en el directorio del plugin que describe cuándo y cómo aplicar un flujo de trabajo específico — TDD, envío paralelo de agentes, revisión de código, lluvia de ideas, escritura de planes, depuración, y docenas más. Claude lee los metadatos de la habilidad, reconoce la situación en tu conversación, e incorpora automáticamente la habilidad relevante al contexto. La mayoría de las veces no invocas habilidades manualmente. Describes el problema y Claude se enruta a sí mismo.

El modelo mental que finalmente me hizo entender: es lo que solía ser el conocimiento tribal de cada equipo de ingeniería senior — las reglas no escritas sobre cómo este equipo planifica, prueba, revisa y lanza — excepto que ahora es una biblioteca portátil que puedes instalar en cualquier proyecto y el agente la lee antes de cada tarea.

El flujo de trabajo de siete etapas que hace el trabajo pesado

La mayoría del valor proviene de un flujo de trabajo central que Superpowers aplica por defecto. Etapas, en orden, con el nombre de la habilidad entre corchetes:

  • Lluvia de ideas — refina la idea mediante preguntas antes de escribir código. (brainstorming)
  • Aislamiento de worktree — cada tarea no trivial se ejecuta en un git worktree, no en tu rama principal. (using-git-worktrees)
  • Escritura de planes — divide el trabajo en tareas discretas de 2-5 minutos con especificaciones exactas, antes de tocar código. (writing-plans)
  • Desarrollo dirigido por subagentes — subagentes frescos por tarea con revisión de dos etapas, para que el agente principal se mantenga orientado y los agentes trabajadores se mantengan enfocados. (subagent-driven-development)
  • Desarrollo dirigido por pruebas — RED-GREEN-REFACTOR es obligatorio, no opcional. (test-driven-development)
  • Revisión de código — revisión basada en severidad con bloqueo explícito en problemas críticos. (requesting-code-review)
  • Finalización de rama — decisión estructurada de fusión o PR cuando el trabajo está completo. (finishing-a-development-branch)

En la práctica no ejecutas los siete pasos manualmente para una edición de 10 líneas. El framework decide qué etapas aplican según la complejidad de la tarea y salta las que serían excesivas. Una corrección de typo ejecuta la skill de planificación brevemente y salta TDD. Una feature nueva en un directorio de 25,000 páginas ejecuta la secuencia completa.

Cómo uso Superpowers para escribir blog y SEO

Este es el caso de uso del que nadie habla porque el framework fue construido para código, pero la producción de contenido a escala es el mismo problema disfrazado: planificación estructurada, ejecución paralela y revisión antes de publicar. Los cinco patrones concretos que uso:

1. Brainstorming de un post antes de redactar

Cada post comienza con la skill de brainstorming. Describo el tema en una o dos líneas y Claude ejecuta un interrogatorio real: quién lee esto, qué ya saben, cuál es el ángulo contrario, qué señales específicas de mi propio trabajo pertenecen al borrador. La mayoría de posts que solían tomar una sesión de outline de 90 minutos ahora toman 15 minutos de preguntas guiadas y producen un brief más ajustado.

2. Plan-writing para posts en cluster

Los clusters de contenido multi-post (el cluster HIPAA que lancé esta semana es el ejemplo más reciente) usan la skill writing-plans. Describo el tema padre, Claude planifica los 3-5 posts de apoyo con sus ángulos, estructura de enlaces internos y keywords objetivo. El plan va a un archivo markdown en el proyecto. Cada post se convierte en una tarea discreta de 30-45 minutos. El cluster se lanza en un día en lugar de una quincena.

3. Despacho paralelo de agentes para keyword research

La habilidad de dispatching-parallel-agents es lo que hace que proyectos grandes de investigación SEO sean viables. Para un análisis de competencia necesito SERPs de DataForSEO para 8 palabras clave, auditorías de contenido para 4 competidores que ranking, y verificaciones de citas de AI Overview para el tema principal. Tres agentes paralelos salen, cada uno regresa con hallazgos estructurados, el agente principal sintetiza. Lo que solía ser media jornada de búsqueda manual de SERPs es ahora 10 minutos de análisis estructurado.

4. Compuertas de calidad de contenido impulsadas por pruebas

Suena contraintuitivo pero funciona: mi pipeline de contenido tiene una suite de pruebas. Conteo de palabras, puntuación Flesch-Kincaid, longitud de meta descripción 140-155, verificación de palabras prohibidas, mínimo de enlaces internos, validez de schema, completitud de hreflang. Cada borrador pasa por la compuerta. La habilidad TDD de Superpowers la refuerza — si un artículo falla la compuerta, el borrador no se publica hasta que el fallo sea resuelto. RED-GREEN-REFACTOR para prosa.

5. Aislamiento de worktree para reescrituras de contenido en todo el sitio

Cuando reescribí 17 copias de hero este mes para alineación TRIBE v2, la habilidad worktree mantuvo la reescritura aislada de la rama principal hasta que todo el lote fue completado y revisado. Ninguna copia de hero a medio terminar en producción. La habilidad está tan integrada ahora que noto cuando otros proyectos no la tienen.

Cómo uso Superpowers para trabajo de diseño

El diseño a través de Claude Code es una forma diferente de problema — Figma no está en las manos del agente, pero todo lo que la rodea sí: tokens de diseño, especificaciones de componentes, copy, espaciado, auditorías de accesibilidad, presentaciones. Tres patrones en los que me apoyo:

1. Arquitectura de tokens desde un brief de marca

Brainstorming + writing-plans en un brief de marca producen una especificación de design tokens completa — capa primitiva, capa semántica, capa de componentes — en una sesión. Claude enruta a través de la habilidad de diseño (cuando está en alcance) y la habilidad writing-plans en paralelo. El resultado son variables CSS listas para el codebase, no un archivo Figma que alguien tenga que traducir después.

2. Generación de especificación de componentes

Los agentes Receiving-code-review y dispatching-parallel-agents manejan el trabajo de especificación de componentes. Yo describo un componente (una tarjeta de precios, un bloque de centro de servicios, una tabla de comparación) y Claude escribe la especificación completa — props, variantes, estados, notas de accesibilidad — que un ingeniero u otro agente puede implementar. La especificación es revisada por un agente paralelo antes de que se entregue.

3. Producción de presentaciones

Todo mi trabajo de presentaciones ahora pasa por Superpowers. Lluvia de ideas sobre la narrativa, planes de escritura para la estructura de diapositivas, agentes paralelos para generación de gráficos y refinamiento de texto. Una presentación de 25 diapositivas que antes tomaba un día de trabajo ahora son dos horas de sesión guiada — y las diapositivas se entregan en HTML con Chart.js, no en un binario que alguien tenga que recrear después.

Cómo uso Superpowers para desarrollo web

Este es el caso de uso original y donde se ve la profundidad del framework. Dos ejemplos de esta semana:

La herramienta WordPress Stack Advisor

Construí WordPress Stack Advisor — una herramienta gratuita que toma una URL, obtiene el sitio, detecta el CMS y más de 30 plugins, y devuelve una recomendación de stack generada por Claude — en aproximadamente 8 horas de trabajo de sesión. La habilidad de lluvia de ideas produjo la especificación de entrada/salida y el enfoque del prompt del sistema. Los planes de escritura dividieron la construcción en tareas discretas: módulo de detección, integración de Claude, página de UI, cableado de CSP, prueba de humo. El desarrollo impulsado por subagentes entregó cada tarea de forma aislada con un contexto de agente nuevo, mientras que el agente principal mantuvo la imagen arquitectónica. TDD en el módulo de detección atrapó dos bugs de regex antes de que llegaran a producción. Todo se lanzó como un PR limpio con un historial de commits real.the WordPress Stack Advisor — a free tool that takes a URL, fetches the site, detects the CMS and 30+ plugins, and returns a Claude-generated stack recommendation — in roughly 8 working hours of session time. The brainstorming skill produced the input/output spec and the system prompt approach. Writing-plans broke the build into discrete tasks: detection module, Claude integration, UI page, CSP wiring, smoke test. Subagent-driven development delivered each task in isolation with a fresh agent context, while the main agent kept the architectural picture. TDD on the detection module caught two regex bugs before they landed in production. The whole thing went out as a clean PR with a real commit history.

El cluster de blog HIPAA

Tres artículos, completamente interconectados, con imágenes hero, marcado de schema y estructura de enlaces internos al post HIPAA-compatible existente de Next.js. La lluvia de ideas reveló el análisis de brechas (qué AccountableHQ no cubre, dónde los hilos de Reddit están desactualizados). Los planes de escritura estructuraron el cluster: actualización de post padre, dos nuevos posts de apoyo (Supabase + Vercel BAA, AI HIPAA), esqueleto compartido de enlaces internos. Agentes paralelos obtuvieron SERPs de DataForSEO e investigación web en vivo sobre Vercel, Supabase, OpenAI, Anthropic, y precios HIPAA de Azure. El desarrollo impulsado por subagentes produjo cada post. El cluster se lanzó en una sesión enfocada.HIPAA-compliant Next.js post. Brainstorming surfaced the gap analysis (what AccountableHQ doesn't cover, where Reddit threads are out of date). Writing-plans structured the cluster: parent post upgrade, two new supporting posts (Supabase + Vercel BAA, AI HIPAA), shared internal-link skeleton. Parallel agents pulled DataForSEO SERPs and live web research on Vercel, Supabase, OpenAI, Anthropic, Azure HIPAA pricing. Subagent-driven development produced each post. The cluster shipped in one focused session.

Cómo uso Superpowers para proyectos personales

El framework se adapta sorprendentemente bien a problemas fuera del trabajo. Tres ejemplos honestos:

Investigación de viajes

Planificación de vacaciones familiares: lluvia de ideas para el brief real (qué tolerarán los niños, cuál es el presupuesto real, qué fechas funcionan), agentes paralelos para investigación de restaurantes, análisis de alojamiento, y puntuación de itinerarios. El resultado es un plan de una página con citas a fuentes reales, no una lista genérica. Solo la habilidad de lluvia de ideas vale la pena instalar — te fuerza a tener la conversación que la mayoría de la planificación familiar se salta.

Finanzas y decisiones

Las decisiones financieras personales más grandes (refinanciar una hipoteca, comprar una propiedad, un coche) reciben el mismo trato de redacción de plan que el trabajo comercial. El resultado es una comparación estructurada con los trade-offs explícitos, no una recomendación basada en intuiciones. La habilidad de recibir revisión de código — adaptada a revisiones no técnicas — atrapa los análisis faltantes que me habría saltado.

Contenido para mi propia práctica de escritura

Los ensayos personales (el blog fuera de pantalla, la escritura en la cafetería, las reflexiones técnicas) todos pasan por lluvia de ideas primero. La mayoría de mi mejor escritura personal comenzó como una conversación de 30 minutos con Superpowers que sacó a la luz un ángulo desde el que no habría escrito por mi cuenta. La habilidad actúa como un editor comprensivo que no te dejará escribir la versión aburrida.

Dónde Superpowers aún no da sus frutos

  • Ediciones triviales — cambios de CSS de una línea, una corrección de una sola falta de ortografía, un ajuste de copia de un párrafo. El overhead de Superpowers se convierte en fricción aquí. Desactiva las etapas del workflow o invoca el agente directamente.
  • Exploración pura — cuando genuinamente no sabes qué estás construyendo aún y necesitas probar cinco prototipos rápidos. La habilidad de redacción de plan intenta estructurar demasiado temprano; el modo manual es más rápido.
  • Debugging bajo presión de tiempo — la producción está caída, tienes 10 minutos, el reflejo plan-first del framework es el reflejo equivocado. Usa la habilidad de debugging sistemático si acaso y salta el flujo de siete etapas.
  • Otras personas en el equipo sin el framework. Si tu colaborador está en Claude Code puro y tú estás en Superpowers, los artefactos (archivos de plan, ramas de worktree, commits estructurados) confunden el flujo de trabajo en lugar de aclararlo. O todos lo ejecutan o nadie lo hace.

Instalación y las primeras 24 horas

Si estás en Claude Code, la instalación es un comando:

/plugin install superpowers@claude-plugins-official

Después de la instalación, las habilidades se cargan automáticamente según el contexto. No necesitas memorizarlas — Claude se auto-direcciona. Lo más útil en las primeras 24 horas es elegir deliberadamente un proyecto real (no un juguete) y dejar que el framework funcione. El flujo de siete etapas en una característica real es lo que te enseña la cadencia. Leer el README no es suficiente; el valor se compone con el uso.

Dos consejos de configuración que me tomó una semana aprender a la fuerza: mantén el directorio worktree en un SSD rápido (la habilidad worktree crea muchos de ellos), y agrega el plugin de habilidades a tu dotfiles para que viaje entre máquinas. No hay nada peor que iniciar una sesión en una laptop nueva y echar de menos el flujo de trabajo que has construido como hábito.

FAQ

¿Es Superpowers gratuito?

Sí. El framework es código abierto bajo una licencia permisiva. La instalación es a través del marketplace oficial del plugin de Claude Code sin costo. Aún pagas a Anthropic por el uso de Claude Code a tarifas estándar — Superpowers no cambia eso, pero tiende a usar más tokens por tarea porque ejecuta planes más ricos y agentes paralelos. En la práctica eso ha sido un intercambio positivo para mí: más tokens, menos sesiones desperdiciadas.

¿Reemplaza los skills integrados de Claude Code?

No. Superpowers es aditivo. El propio sistema de skills de Claude Code (skills a nivel de proyecto, plugins del marketplace) sigue funcionando igual. Superpowers se integra como una capa metodológica — el flujo de siete etapas, la aplicación de TDD, el despacho de agentes en paralelo — que orquesta cómo se usan los skills subyacentes.

¿Funcionará para tareas sin código?

Sí, con limitaciones. El framework fue construido para desarrollo de software, y los skills de TDD y revisión de código obviamente están orientados al código. Pero el brainstorming, la planificación de escritura, el despacho de agentes en paralelo, y los skills de worktree se generalizan limpiamente a producción de contenido, diseño, investigación y proyectos personales. Aproximadamente el 40% de mi uso de Superpowers ahora es sin código, y la ganancia de productividad es comparable.

¿Cómo se compara con otros frameworks agénticos?

Las comparaciones más cercanas son el modo agent de Cursor, Cline, y los flujos de planificación de Aider. El diferenciador de Superpowers es la profundidad de la librería de skills y la aplicación de TDD. Cursor y Cline son excelentes a nivel IDE; Superpowers opera a nivel metodológico. Son complementarios, no competitivos — ejecuto Superpowers dentro de Claude Code mientras mantengo Cursor para edición en vivo en tareas más pequeñas.

¿Cuál es la trampa?

Dos reales. Primero, tienes que usarlo realmente; leer el README sin ejecutar el flujo te deja con el mismo Claude Code que tenías antes. Segundo, el reflejo plan-first del framework es incorrecto para algunas tareas (exploración pura, debugging urgente). Saber cuándo desactivar el flujo es parte de la curva de aprendizaje. Después de aproximadamente dos semanas de uso regular, el ritmo se vuelve habitual y dejas de pensar en qué skills se están ejecutando.

Lecturas relacionadas

Claude Code para WordPress: el flujo que mi agencia ejecuta en 2026 — el flujo más amplio de agencia de Claude Code, con Superpowers integrado como la capa metodológica. — the broader Claude Code agency workflow, with Superpowers slotting in as the methodology layer.

WordPress Stack Advisor — una herramienta funcional que construí usando Superpowers en aproximadamente 8 horas de tiempo de sesión, de principio a fin. — a working tool I built using Superpowers in roughly 8 hours of session time, end to end.

Alternativas a WordPress 2026: cuándo no-code no es la respuesta — el artículo cluster que el flujo de trabajo de planes de escritura + investigación paralela de Superpowers produjo en una única sesión. — the cluster post that the Superpowers writing-plans + parallel-research workflow produced as a single session.

El agente es rápido. El agente es capaz. El agente es estructuralmente optimista. La metodología es lo que detiene el optimismo de ser enviado a producción.

Si quieres hablar sobre cómo integrar Superpowers en un equipo de ingeniería o contenido real — los problemas de personas, el diseño de flujos de trabajo, la economía de costos — agenda una llamada de 30 minutos. Lo ejecuto en cada proyecto en Seahawk Media ahora y los patrones se generalizan en equipos de cualquier tamaño.book a 30-minute call. I run this on every project at Seahawk Media now and the patterns generalise across team sizes.

< BACK