Skills

Optimiza la configuración del contexto del agente.

Se activa cuando

• al iniciar una sesión
• la calidad de salida baja
• al cambiar de tarea

Úsala para

• Al iniciar una nueva sesión de programación
• La calidad de salida del agente está bajando
• Al cambiar entre partes de un código base
• Al configurar un proyecto nuevo para desarrollo asistido por IA

No la uses para

• Consultas puntuales sin necesidades de contexto
• Cambios triviales sin dependencias
• Ya estás en una sesión activa con contexto reciente

2 guíasSKILL.md

Define la filosofía de ingeniería universal para todas las skills de plataforma: descubrimiento, contratos, anti-slop y compuertas de calidad.

Se activa cuando

• Se carga desde todas las skills de plataforma

Úsala para

• Se carga desde todas las skills de plataforma. Nunca se invoca directamente.

No la uses para

• Implementación específica de plataforma (las skills de plataforma añaden detalles a esta base)

8 guíasSKILL.md

Captura las preferencias del usuario una vez y las conserva entre proyectos. Crea un perfil de usuario para personalizar todas las skills.

Se activa cuando

• primera sesión
• configurar preferencias

Úsala para

• Cualquier skill arranca y no existe ~/.config/opencode/user-profile.json
• user-profile.json tiene más de 90 días
• El usuario dice "configura mis preferencias", "recuerda mi stack" o "define los valores por defecto"

No la uses para

• El perfil existe y tiene menos de 90 días (usa la verificación rápida)
• El usuario dice "omitir" y el perfil existe
• Modo Turbo activo con un perfil existente

2 guíasSKILL.md

Refina ideas sin pulir hasta convertirlas en conceptos nítidos y accionables mediante pensamiento divergente y convergente.

Se activa cuando

• una idea es vaga o necesita validación

Úsala para

• La idea sigue siendo vaga o incompleta
• Necesitas poner a prueba los supuestos antes de comprometerte
• Quieres explorar alternativas antes de converger en una

No la uses para

• Los requisitos ya están claros y documentados
• Cambios triviales con alcance obvio

2 guíasSKILL.md

Extrae lo que el usuario realmente quiere mediante entrevistas de una pregunta a la vez.

Se activa cuando

• una petición está poco especificada

Úsala para

• La petición está poco especificada ("construye X" sin "para quién" ni "por qué ahora")
• El usuario dice "entrevístame", "interrógame" o "¿estamos seguros?"
• El agente se descubre a punto de completar en silencio requisitos ambiguos
• Antes de spec-driven-development para cualquier petición no trivial

No la uses para

• Los requisitos ya están claros y documentados
• Tareas triviales y bien definidas (arreglo de una línea, corrección de errata)
• Excepción: NOINTENT: motivo en el cuerpo del commit

2 guíasSKILL.md

Evalúa opciones de arquitectura con 2-3 alternativas antes de construir. Cuestiona supuestos y fija las decisiones en las especificaciones.

Se activa cuando

• stack
• arquitectura
• patrón

Úsala para

• Proyecto no trivial (varias páginas, varios módulos, necesidades de backend)
• Elegir entre frameworks, stacks o patrones
• El usuario dice "quiero X" sin justificación
• Evaluar microservicios frente a monolito, SSR frente a CSR, REST frente a GraphQL
• Decisión costosa de revertir
• Omite cuando: el stack está fijado en SPEC.md o es pura implementación. Ajustes puntuales. Proyectos de juguete.

No la uses para

• Detalles de implementación después de decidir la arquitectura
• Ajustes puntuales o proyectos de juguete
• Cuando el stack ya está fijado en SPEC.md

3 guíasSKILL.md

Gestiona la deprecación y la migración de sistemas, APIs y funciones antiguos. Cubre estrategias de retirada, compatibilidad hacia atrás y plazos.

Se activa cuando

• Eliminar o reemplazar un endpoint de API existente

Úsala para

• Eliminar o reemplazar un endpoint de API existente
• Migrar usuarios de una implementación a otra
• Decidir si mantener o retirar código existente
• Planificar transiciones compatibles hacia atrás
• Una API de terceros o dependencia de la que depende tu sistema anuncia su deprecación

No la uses para

• Construir funciones nuevas (usa las skills de implementación de funciones)
• Despliegue (usa shipping-and-launch)

2 guíasSKILL.md

Revisa cada decisión no trivial con una revisión adversarial de contexto fresco.

Se activa cuando

• importa la corrección
• las apuestas son altas
• el código no te resulta familiar

Úsala para

• Una decisión es no trivial cuando introduce lógica ramificada, cruza un límite de módulo, afirma propiedades no verificables (seguridad de hilos, idempotencia), tiene un radio de impacto irreversible (despliegue a producción, migración de datos, cambio de API pública) o depende de contexto que el futuro lector no puede ver.
• Aplícala cuando: estás a punto de tomar una decisión de arquitectura, confirmar código no trivial, afirmar un hecho no obvio o trabajar en código que no entiendes del todo.

No la uses para

• Operaciones mecánicas (renombrar, dar formato)
• Instrucciones claras e inequívocas
• Leer o resumir código existente
• Cambios de una línea o puro tooling

2 guíasSKILL.md

Construye funciones de forma incremental en porciones verticales finas.

Se activa cuando

• tocas varios archivos o una tarea parece demasiado grande para un paso

Úsala para

• Implementar cualquier cambio de varios archivos
• Construir una función nueva a partir de un desglose de tareas
• Refactorizar código existente
• Cada vez que te tienta escribir más de 100 líneas antes de probar

No la uses para

• Cambios de un solo archivo y una sola función cuyo alcance ya es mínimo

2 guíasSKILL.md

Orquesta varios agentes de programación con IA en modos paralelo, en pipeline o en enjambre.

Se activa cuando

• más de 2 agentes o refactors de varios archivos

Úsala para

• La tarea requiere más de 2 agentes (implementación en paralelo, investigación + construcción + revisión)
• Refactor de varios módulos (archivos que no se solapan, módulos independientes)
• Pipeline guiado por especificación con compuertas por fase (Spec → Implement → Test → Review)
• Exploración competitiva (modo enjambre para decisiones de arquitectura)

No la uses para

• Cambios de un solo archivo (un agente es suficiente)
• Tareas donde los archivos se solapan (provoca conflictos de fusión)
• CRUD simple o flujos lineales

1 guíaSKILL.md

Descompone el trabajo en tareas pequeñas y verificables con criterios de aceptación explícitos.

Se activa cuando

• una especificación necesita dividirse en pasos implementables

Úsala para

• Tienes una especificación y necesitas dividirla en unidades implementables
• Una tarea parece demasiado grande o vaga para empezar
• El trabajo debe paralelizarse entre varios agentes o sesiones
• El orden de implementación no es obvio

No la uses para

• Cambios de un solo archivo con alcance obvio
• La especificación ya contiene tareas bien definidas

2 guíasSKILL.md

Fundamenta cada decisión de implementación en la documentación oficial antes de escribir código.

Se activa cuando

• construyes con cualquier framework donde importa la corrección

Úsala para

• Usar cualquier framework, biblioteca, SDK o API
• Implementar contra una interfaz documentada
• Migrar entre versiones de una dependencia
• Cada vez que importa la corrección del uso de una API
• Usar una dependencia nueva por primera vez (verifica la superficie de la API antes de escribir código)
• Actualizar una versión mayor de una dependencia (se esperan cambios incompatibles: verifica contra la documentación nueva, no contra el conocimiento antiguo)

No la uses para

• Implementación pura de algoritmos o estructuras de datos
• Lógica de negocio sin dependencia externa
• Trabajo creativo o de diseño

2 guíasSKILL.md

Crea especificaciones completas a partir de las peticiones del usuario mediante investigación, análisis crítico y alineación con el usuario.

Se activa cuando

• proyecto nuevo
• función
• especificación
• plan

Úsala para

• Empezar cualquier proyecto o función nuevos
• Requisitos ambiguos o de una sola frase que necesitan aclaración
• Cambios que tocan más de 3 archivos o cruzan límites de módulo
• Decisiones de arquitectura o tecnología
• Cualquier tarea estimada en más de 30 minutos

No la uses para

• Correcciones de una línea, erratas, cambios realmente triviales (1 archivo, menos de 10 líneas, sin lógica). Para todo lo demás, ejecuta el pipeline.

3 guíasSKILL.md

Construye aplicaciones de escritorio de nivel producción con integración nativa del sistema operativo. Por defecto: Tauri v2. Adaptable: Electron, Flutter.

Se activa cuando

• Construye cualquier aplicación de escritorio con integración nativa del sistema operativo

Úsala para

• Construye cualquier aplicación de escritorio con integración nativa del sistema operativo.

No la uses para

• Aplicaciones solo web (usa frontend-web)
• Aplicaciones móviles (usa frontend-mobile)
• Herramientas CLI (usa el flujo de terminal)

3 guíasSKILL.md

Construye aplicaciones móviles de nivel producción con tokens de diseño nativos y cumplimiento de cada plataforma.

Se activa cuando

• app móvil
• React Native
• Flutter
• iOS
• Android

Úsala para

• Construye, diseña o rediseña cualquier interfaz de aplicación móvil.

No la uses para

• Tareas solo web (usa frontend-web)
• Aplicaciones web instalables (usa frontend-pwa)
• Tareas solo de backend

3 guíasSKILL.md

Construye aplicaciones web instalables y offline-first para todos los dispositivos, con migración nativa vía Capacitor.

Se activa cuando

• PWA
• offline
• instalable
• híbrida

Úsala para

• Aplicación web con funcionalidad sin conexión
• Experiencia instalable (añadir a la pantalla de inicio)
• Multi-dispositivo (teléfono, tableta, plegable, TV, escritorio)
• Distribución nativa futura vía Capacitor/Ionic

No la uses para

• Sitios de marketing simples sin necesidades offline (usa frontend-web)
• Aplicaciones puramente nativas (usa frontend-mobile)

4 guíasSKILL.md

Construye interfaces de nivel producción con arquitectura de componentes, gestión de estado y disciplina de maquetación.

Se activa cuando

• web
• móvil
• escritorio
• PWA

Úsala para

• Construir cualquier componente de cara al usuario
• Diseñar la arquitectura de componentes o la gestión de estado
• Implementar maquetación, navegación o patrones responsivos
• La referencian automáticamente las skills de plataforma

No la uses para

• Trabajo específico de plataforma (usa la skill de plataforma dedicada)
• Trabajo de API o backend (usa backend-api-mastery)

2 guíasSKILL.md

Construye interfaces web de nivel producción.

Se activa cuando

• sitio web
• landing page
• aplicación web
• Next

Úsala para

• Construye, diseña o rediseña cualquier interfaz web.

No la uses para

• Software solo de backend, CLI o no visual
• Móvil nativo (usa frontend-mobile)
• Aplicaciones instalables sin conexión (usa frontend-pwa)

8 guíasSKILL.md

Diseña APIs estables y límites de módulo con contratos claros.

Se activa cuando

• diseñar endpoints REST/GraphQL o definir contratos de tipos entre módulos

Úsala para

• Diseñar contratos de API entre frontend y backend
• Definir los límites de módulos en un código base
• Crear interfaces de tipos compartidas entre paquetes
• Establecer protocolos de comunicación entre servicios
• Añadir un endpoint público nuevo a una API existente
• Cambiar un endpoint de API existente (requiere decidir el versionado)
• Introducir un servicio nuevo que se comunica con servicios existentes
• Dividir un monolito en microservicios (descubrimiento de límites)
• Crear un SDK o biblioteca cliente para una API
• Revisar una API existente en busca de problemas de compatibilidad hacia atrás
• Empezar una función nueva que toca más de un módulo (primero el contrato, después el código)

No la uses para

• Implementación profunda de backend (usa backend-api-mastery)
• Trabajo específico de frontend (usa frontend-web, etc.)
• Diseño de esquemas de base de datos
• Cambios de API puramente operativos (añadir un campo a un endpoint existente, sin cambio de versionado)

2 guíasSKILL.md

Diseña APIs de nivel producción con una arquitectura intencional antes de escribir endpoints. Cubre protocolo, base de datos, autenticación, validación y pruebas.

Se activa cuando

• Construir cualquier capa de API (REST, GraphQL, tRPC, WebSocket, gRPC)

Úsala para

• Construir cualquier capa de API (REST, GraphQL, tRPC, WebSocket, gRPC)
• Añadir una base de datos o capa de persistencia a un proyecto
• Implementar autenticación o autorización
• Diseñar el manejo de errores, la validación o el límite de peticiones
• Crear modelos de datos, esquemas o migraciones
• spec-driven-development (si SPEC.md indica necesidades de backend)
• architecture-analysis (si se elige un backend no trivial)
• frontend-web o frontend-mobile (si el frontend necesita un backend para persistir datos)

No la uses para

• El proyecto es solo frontend sin persistencia (sitio estático, landing page)
• El backend ya está diseñado y documentado en API-DESIGN.md
• La tarea es puramente operativa (corregir un error en una API existente, añadir un campo)

5 guíasSKILL.md

Construye herramientas CLI de nivel producción con análisis de argumentos, códigos de salida, salida con color, progreso y manejo de errores.

Se activa cuando

• CLI
• terminal
• script de shell

Úsala para

• Construir una herramienta o comando CLI nuevos
• Añadir una interfaz CLI a un proyecto o servicio existente
• Refactorizar scripts ad-hoc en una CLI formal (análisis de argumentos, códigos de salida, composabilidad)
• Crear tooling para desarrolladores: andamios, generadores de código, linters, formateadores, herramientas de migración
• Construir una herramienta de varios comandos (subcomandos estilo git: tool <sustantivo> <verbo>)
• Implementar automatización que necesita códigos de salida fiables y salida canalizada (CI/CD, scripts)
• El usuario dice: "construye una CLI", "app de terminal", "herramienta de línea de comandos", "haz una herramienta que...", "crea un comando"

No la uses para

• Aplicaciones con GUI (escritorio, web, móvil)
• Scripts de shell puntuales y simples (usa un script de shell directamente)
• Aplicaciones TUI de pantalla completa (interfaces interactivas estilo emacs, vim)

2 guíasSKILL.md

Prueba interfaces en navegadores reales: inspecciona el DOM, captura errores de consola, analiza peticiones de red y verifica la salida visual. Las herramientas disponibles varían según la plataforma.

Se activa cuando

• Depurar comportamiento específico del navegador

Úsala para

• Depurar comportamiento específico del navegador
• Verificar la salida visual con datos reales de ejecución
• Capturar errores de consola o problemas de peticiones de red
• Perfilar el rendimiento del frontend

No la uses para

• Pruebas unitarias o de integración (usa test-driven-development)
• Pruebas de backend
• Análisis estático o linting
• Entornos que no son navegador

1 guíaSKILL.md

Depura de forma sistemática mediante análisis de causa raíz.

Se activa cuando

• fallan las pruebas
• se rompe la compilación
• el comportamiento no coincide

Úsala para

• Una prueba falla después de un cambio de código
• La compilación se rompe o produce errores
• Error en tiempo de ejecución en desarrollo o producción
• El comportamiento no coincide con lo esperado
• El rendimiento se degrada de forma inesperada
• El usuario reporta un error

No la uses para

• Revisión de código o evaluación de calidad (usa code-review-and-quality)
• Construir funciones nuevas (usa las skills de implementación de funciones)
• Depuración especulativa sin evidencia
• Primera prueba inestable sin pasos de reproducción

5 guíasSKILL.md

Detén la depuración especulativa tras 3 intentos fallidos con el mismo error. Diagnostica de forma sistemática antes de escribir código.

Se activa cuando

• los arreglos repetidos fallan

Úsala para

• La misma prueba falla en 3 o más commits consecutivos (disparador mecánico de STRIKES_LOG)
• El mismo componente se arregló dos veces con causas raíz distintas
• Etiqueta bug- repetida en el cuerpo del commit para el mismo problema
• Escalado desde debugging-and-error-recovery tras varios intentos de arreglo

No la uses para

• Primera aparición de un error (usa debugging-and-error-recovery)
• Inestabilidad puntual de una prueba o fallo dependiente de la red
• Componentes distintos que fallan de forma independiente (no es la misma causa raíz)

0 guíasSKILL.md

Escribe las pruebas primero con el ciclo RED-GREEN-REFACTOR.

Se activa cuando

• implementar lógica
• corregir errores
• probar que el código funciona

Úsala para

• Implementar cualquier lógica o comportamiento nuevos
• Corregir cualquier error (el patrón Prove-It)
• Modificar funcionalidad existente
• Añadir manejo de casos límite
• El usuario dice "añade pruebas" o "asegúrate de que funciona"

No la uses para

• Cambios puros de configuración, actualizaciones de documentación o cambios de contenido estático

6 guíasSKILL.md

Revisa el código en 5 ejes (corrección, legibilidad, arquitectura, seguridad, rendimiento) antes de fusionar.

Se activa cuando

• código de cualquier autor

Úsala para

• Antes de fusionar cualquier PR o cambio
• Después de completar la implementación de una función
• Cuando otro agente o modelo produjo código que necesitas evaluar
• Al refactorizar código existente
• Después de cualquier corrección de error (revisa tanto el arreglo como la prueba de regresión)

No la uses para

• Código en curso que aún no está listo para revisión
• Comentarios de diseño o visuales (usa critique-skill o polish)
• Investigación de rendimiento o seguridad sin cambio de código (usa las skills dedicadas)

3 guíasSKILL.md

Simplifica el código para ganar claridad sin cambiar el comportamiento.

Se activa cuando

• refactorizar código más difícil de leer o mantener

Úsala para

• El código es correcto pero más difícil de leer de lo necesario
• Las abstracciones no justifican su complejidad
• Las funciones o componentes son demasiado grandes
• Hay lógica duplicada que podría unificarse
• Después de que una revisión de código revele problemas de complejidad

No la uses para

• El comportamiento debe cambiar (usa las skills de implementación de funciones)
• Solo hay problemas de formato o linting (usa el formateador o linter)
• El código ya es tan simple como puede ser

2 guíasSKILL.md

Audita el entorno de desarrollo (herramientas CLI, runtimes) antes de escribir código. Propone instalaciones con justificación.

Se activa cuando

• empezar un proyecto

Úsala para

• Empezar un proyecto nuevo (después de la especificación, antes de construir)
• El usuario pregunta "qué necesito instalar" o "configura el entorno"
• Antes de construir si falta docs/DEV-ENVIRONMENT.md o está desactualizado
• El proyecto requiere herramientas de prueba, despliegue o diseño
• La invocan: spec-driven-development Fase 7, shipping-and-launch, frontend-* (si faltan MCPs)

No la uses para

• DEV-ENVIRONMENT.md reciente (menos de 7 días) con todas las herramientas verificadas (omite la auditoría)
• Tarea puramente de documentación sin necesidades de tooling

4 guíasSKILL.md

Documenta decisiones de arquitectura, cambios de API y funciones.

Se activa cuando

• algo necesita un registro escrito

Úsala para

• Tomar una decisión de arquitectura significativa
• Elegir entre enfoques en competencia
• Añadir o cambiar una API pública
• Entregar una función que cambia el comportamiento de cara al usuario
• Incorporar a nuevos miembros del equipo o agentes

No la uses para

• Documentar código obvio o prototipos desechables

3 guíasSKILL.md

Instrumenta el código para que el comportamiento en producción sea visible: logging estructurado, métricas, trazas y alertas.

Se activa cuando

• entregar funciones que necesitan evidencia

Úsala para

• Añadir logging, métricas, trazas o alertas
• Entregar funciones que se ejecutan en producción
• Se reportan problemas de producción pero no puedes saber qué pasó
• Configurar paneles de monitoreo
• Después de un postmortem de incidente (cubrir los vacíos de observabilidad descubiertos en el análisis)
• Antes de un lanzamiento público o una versión mayor (asegurar la preparación para el lanzamiento)

No la uses para

• Planificación de despliegue o reversión (usa shipping-and-launch)
• Trabajo previo a producción

2 guíasSKILL.md

Optimiza el rendimiento de la aplicación más allá del frontend: Core Web Vitals, tiempos de carga, respuesta del servidor, consultas de base de datos, caché y perfilado.

Se activa cuando

• Se superan los presupuestos de rendimiento

Úsala para

• Se superan los presupuestos de rendimiento
• Hay que mejorar los Core Web Vitals
• Los tiempos de carga o el Time-to-Interactive son demasiado lentos
• El perfilado revela cuellos de botella de backend o infraestructura
• Después de una actualización mayor de dependencias o migración de framework (riesgo de regresión)
• Al prepararte para un pico de tráfico (lanzamiento, oferta, campaña)

No la uses para

• Rendimiento de diseño de frontend (usa optimize-skill)
• Optimización prematura sin mediciones

2 guíasSKILL.md

Audita proyectos existentes antes de empezar trabajo nuevo.

Se activa cuando

• entrar en un código base por primera vez o tras un parón

Úsala para

• El proyecto tiene código Y no hay HEALTH-CHECK.md en los últimos 7 días.
• El usuario pide una auditoría, un chequeo de salud o una revisión de deuda técnica.
• Regresas tras un parón de más de 3 días.
• Antes de un "cambio significativo" (más de 3 archivos o una función nueva).

No la uses para

• Proyecto inicializado en esta sesión (ya cumple)
• Arreglo de una línea en un proyecto auditado con HEALTH-CHECK.md reciente

2 guíasSKILL.md

Refuerza el código frente a vulnerabilidades: prevención OWASP, validación de entrada, autenticación, almacenamiento de datos y seguridad de terceros.

Se activa cuando

• Manejar entrada de usuario o subidas de archivos

Úsala para

• Manejar entrada de usuario o subidas de archivos
• Implementar autenticación o gestión de sesiones
• Almacenar datos sensibles (claves, tokens, PII)
• Integrar servicios de terceros
• Construir cualquier función o endpoint de API de cara al público
• Procesar pagos o datos financieros
• Manejar subidas de archivos de fuentes no confiables

No la uses para

• Accesibilidad o mecánica de validación de entrada (usa hard-skill)
• Optimización de rendimiento (usa performance-optimization u optimize-skill)

0 guíasSKILL.md

Corrige problemas de maquetación responsiva, comportamiento móvil ausente, objetivos táctiles y manejo del viewport.

Se activa cuando

• la maquetación se rompe entre breakpoints

Úsala para

• La maquetación se rompe entre los breakpoints definidos
• Lo móvil parece un añadido (pestañas, tarjetas a ancho completo, objetivos diminutos)
• Las interacciones táctiles no funcionan
• Desbordamiento con scroll horizontal
• El usuario dice "esto no funciona en mi teléfono"
• Después de añadir la revisión responsiva a un pipeline de entrega

No la uses para

• Crear maquetaciones responsivas nuevas desde cero (usa las skills de construcción)
• Animaciones (usa delight u optimize)
• Escalado de tipografía (usa typeset)
• Rendimiento (usa optimize)

2 guíasSKILL.md

Audita el código en 5 dimensiones (accesibilidad, rendimiento, tematización, responsividad, anti-patrones) con puntuación de severidad P0-P3.

Se activa cuando

• entregar

Úsala para

• Antes de entregar a producción
• Durante un sprint de calidad
• Cuando el tech lead dice "deberíamos revisar [accesibilidad/rendimiento]"
• Después de que una función esté funcionalmente completa pero sin revisar

No la uses para

• Evaluación de calidad de diseño (usa critique-skill)
• Ajustes visuales puntuales (usa directamente las skills de corrección individuales)
• Funciones incompletas (la auditoría encuentra problemas que solo son trabajo sin terminar)

4 guíasSKILL.md

Reescribe textos de UX confusos para que las interfaces se expliquen por sí mismas: etiquetas, botones, errores, estados vacíos y tooltips.

Se activa cuando

• los usuarios no entienden los campos

Úsala para

• La redacción se siente plantillada o genérica, sin una voz deliberada
• Los usuarios no entienden un campo o un flujo
• Los mensajes de error culpan al usuario o no explican la solución
• El texto del botón es ambiguo ("Enviar", "Aceptar", "Haz clic aquí")
• Los estados vacíos dicen "No hay elementos" sin contexto
• Los tooltips repiten la etiqueta
• Los diálogos de confirmación no nombran las consecuencias

No la uses para

• Textos de marketing o de landing page (necesitan un redactor)
• Mejoras de voz o personalidad (usa delight)
• Estrategia de contenido o arquitectura de la información

4 guíasSKILL.md

Evalúa interfaces con una revisión de diseño en dos pasadas: puntuación, pruebas de persona, detección de AI slop, heurísticas de Nielsen y 25 anti-patrones.

Se activa cuando

• Revisar un plan de diseño antes de escribir código (usa la Fase 0)

Úsala para

• Revisar un plan de diseño antes de escribir código (usa la Fase 0)
• La página está funcionalmente completa, antes de entregar (usa las Fases 1-3)
• "¿Se siente bien?": necesitas una segunda opinión honesta
• El usuario señala señales de IA, maquetación genérica o diseño descuidado
• Antes de pasar a la fase de pulido

No la uses para

• Calidad técnica o errores de implementación (usa audit-skill)
• Trabajo incompleto o en borrador (primero usa shape o craft)
• Ejecutar la Fase 0 sobre código construido (usa las Fases 1-3)
• Ejecutar las Fases 1-3 sobre un plan sin código (usa la Fase 0)

3 guíasSKILL.md

Añade microinteracciones, transiciones, estados hover y animaciones de retroalimentación.

Se activa cuando

• la UX se siente rígida o sin vida

Úsala para

• La interfaz se siente rígida o sin vida
• No hay retroalimentación al pasar el cursor, tocar o completar una acción
• El usuario dice "haz que se sienta más receptivo"
• Las transiciones se sienten bruscas o instantáneas (sin duración)
• Los estados de carga están en blanco o parpadean
• Después de completar la funcionalidad, antes del pulido

No la uses para

• Optimización de rendimiento (usa optimize y después delight encima)
• Cambios estructurales (usa las skills de construcción)
• Reemplazar estados ausentes (usa harden primero)

4 guíasSKILL.md

Corrige de forma determinista problemas críticos y de alta severidad de accesibilidad, entrada y estado. Multiplataforma: web, móvil, escritorio, PWA.

Se activa cuando

• Después de que la auditoría encuentre elementos P0/P1

Úsala para

• Después de que la auditoría encuentre elementos P0/P1
• El usuario dice "haz que esto sea accesible"
• El usuario dice "maneja mejor los casos límite"
• Antes de entregar a producción
• Después de que un escaneo automático de accesibilidad (axe-core, Lighthouse) revele violaciones

No la uses para

• Decisiones de diseño (usa polish, redesign)
• Correcciones de rendimiento (usa optimize)
• Reescribir textos (usa clarify)
• Funciones nuevas (usa las skills de construcción)

4 guíasSKILL.md

Corrige problemas de rendimiento: tamaño del bundle, animaciones, reflows, carga diferida, optimización de imágenes y bloqueo del renderizado.

Se activa cuando

• el perfilado revela cuellos de botella

Úsala para

• Después de que el perfilado revele un cuello de botella específico
• El usuario dice "esta página es lenta"
• La puntuación de Lighthouse / PageSpeed está por debajo del objetivo
• El usuario dice "las animaciones se traban" o "el scroll se entrecorta"
• El tamaño del bundle supera el presupuesto (500 KB de JS en la ruta crítica)
• Las imágenes se cargan a resolución completa en móvil

No la uses para

• Optimización especulativa (mide primero)
• Cambios de diseño que casualmente mejoran el rendimiento
• Preoptimización durante la construcción inicial (primero construye limpio, optimiza después)

4 guíasSKILL.md

Corrige problemas de detalle de diseño: espaciado, alineación, consistencia y cumplimiento de tokens.

Se activa cuando

• la auditoría o cuando se detectan inconsistencias visuales

Úsala para

• Después de que la auditoría encuentre problemas P1-P2 de tematización o consistencia
• Cuando los componentes se ven "mal" pero funcionan estructuralmente
• El usuario dice "haz que esto se vea más pulido"
• Durante el QA de diseño antes de entregar
• Cuando existen tokens de diseño pero no se aplican de forma consistente

No la uses para

• Problemas técnicos (usa harden)
• Problemas de flujo de UX (usa redesign, distill)
• Rediseño estructural (usa redesign)
• Reescribir textos (usa clarify)

2 guíasSKILL.md

Corrige problemas de tipografía y ritmo de lectura: tipografía, peso, tamaño, interlineado, espaciado y escala tipográfica.

Se activa cuando

• el texto se siente apretado o inconsistente

Úsala para

• El texto se siente apretado o demasiado aireado
• Los encabezados y el cuerpo no se sienten coordinados
• Los tamaños de texto no siguen una escala consistente
• El interlineado es inconsistente entre textos similares
• Los pesos de fuente varían sin motivo
• El espaciado entre letras es aleatorio o falta
• Después de cambiar la escala tipográfica o introducir una variante nueva

No la uses para

• Elegir una tipografía nueva (decisión de diseño, no pulido)
• Reescribir textos (usa clarify)
• Problemas de color o tokens (usa polish)
• Problemas de espaciado o maquetación (usa polish)

2 guíasSKILL.md

Diseña interfaces mecánicas y crudas con estética de impresión tipográfica suiza y terminal militar: cuadrículas rígidas, escala tipográfica extrema y color utilitario.

Se activa cuando

• el usuario elige una dirección de diseño brutalista / militar / industrial / táctica

Úsala para

• El usuario elige una dirección de diseño brutalista / militar / industrial / táctica.
• Arquitectura de interfaces web que sintetiza el diseño suizo de mediados de siglo, los manuales industriales y las terminales aeroespaciales retrofuturistas.

No la uses para

• Interfaces suaves, pulidas o de consumo
• Interfaces que requieren esquinas redondeadas o degradados

0 guíasSKILL.md

Diseña UI de producto editorial inspirada en Notion y Linear: paleta monocromática cálida, contraste tipográfico, cuadrículas bento planas y acentos pastel apagados.

Se activa cuando

• UI de producto, sitios de documentación, paneles SaaS, maquetaciones editoriales

Úsala para

• UI de producto, sitios de documentación, paneles SaaS, maquetaciones editoriales. No para marcas de consumo divertidas ni sitios de agencia experimentales.

No la uses para

• Estéticas industriales, brutalistas o deliberadamente crudas
• Marcas de consumo divertidas o sitios de agencia experimentales

0 guíasSKILL.md

Evita marcadores de posición, código truncado y salidas a medio terminar del agente.

Se activa cuando

• el agente entrega trabajo incompleto

Úsala para

• Antes de entregar cualquier salida de código a un usuario
• Después de completar una fase de implementación (antes de marcarla como terminada)
• Cuando los límites de contexto obligan a respuestas truncadas
• Después de cualquier generación de código que involucra varios archivos

No la uses para

• Código de borrador o desechable
• Salida solo exploratoria o de investigación
• Salida que se eliminará o sobrescribirá de inmediato

2 guíasSKILL.md

Mejora códigos base existentes de forma sistemática: escanea la UI, diagnostica problemas en 8 categorías y corrige por orden de prioridad. Nunca rompe la funcionalidad existente.

Se activa cuando

• mejorar el diseño visual de un código base existente

Úsala para

• Mejorar el diseño visual de un código base existente. No para proyectos desde cero.

No la uses para

• Proyectos desde cero (usa las skills de construcción)
• Migraciones de framework o cambios de stack
• Optimización de rendimiento sin cambios visuales

0 guíasSKILL.md

Diseña UI pulidas, serenas y premium con contraste suave, espacio en blanco generoso, tipografías premium y movimiento con muelle.

Se activa cuando

• el usuario elige una dirección de diseño premium / de lujo / serena

Úsala para

• El usuario elige una dirección de diseño premium / de lujo / serena.
• Construir experiencias digitales de nivel de agencia de más de 150 000 USD. Profundidad háptica, ritmo espacial cinematográfico y microinteracciones obsesivas.

No la uses para

• Estéticas industriales, brutalistas o mecánicas crudas
• UI editoriales minimalistas o de documentación

0 guíasSKILL.md

Inicializa y configura Git antes de escribir código. Decide mono-repositorio frente a multi-repositorio, crea .gitignore/.env.example y define la estrategia de ramas.

Se activa cuando

• Después de que existan SPEC.md y DESIGN.md, antes de empezar la fase de construcción

Úsala para

• Después de que existan SPEC.md y DESIGN.md pero antes de empezar la fase de BUILD
• Cuando el usuario dice "empieza el proyecto", "configura el repositorio" o "git init"
• Antes de npm install, create-next-app o cualquier herramienta que genere archivos

No la uses para

• El proyecto ya tiene un repositorio Git con .gitignore y .env.example
• La tarea es solo confirmar cambios en un repositorio existente (usa git-workflow-and-versioning)

6 guíasSKILL.md

Gestiona las prácticas de flujo de trabajo con git: ramas, commits, resolución de conflictos y flujos paralelos.

Se activa cuando

• hacer cualquier cambio de código

Úsala para

• Hacer cualquier cambio de código (todo cambio pasa por git)
• Confirmar, subir, fusionar o hacer rebase
• Resolver conflictos de fusión
• Organizar flujos de trabajo paralelos
• Configurar el flujo de git de un proyecto nuevo

No la uses para

• Inicialización del repositorio o configuración de .gitignore (usa git-init-and-versioning)
• Despliegue o ramas y etiquetas de versión (usa fullstack-shipping)
• Decisiones de revisión de código o aprobación de PR (usa code-review-and-quality)

3 guíasSKILL.md

Automatiza la configuración de pipelines de CI/CD, compuertas de calidad y despliegue.

Se activa cuando

• configurar ejecutores de pruebas o pipelines de compilación

Úsala para

• Configurar o modificar pipelines de CI/CD
• Configurar compuertas de calidad automatizadas
• Automatizar los procesos de compilación y despliegue
• Añadir ejecutores de pruebas a CI

No la uses para

• Estrategia completa de despliegue con monitoreo y reversión (usa fullstack-shipping)
• Lista de verificación previa al despliegue

2 guíasSKILL.md

Construye, prueba y despliega con CI/CD, pruebas, orquestación y monitoreo de nivel producción.

Se activa cuando

• desplegar
• entregar
• lanzar
• pipeline
• producción

Úsala para

• Prepararte para desplegar cualquier proyecto a producción o staging
• Configurar pipelines de CI/CD por primera vez
• Añadir infraestructura de pruebas a un proyecto existente
• Planificar una versión o un lanzamiento
• Configurar monitoreo, alertas o estrategias de reversión
• El usuario dice "sal a producción", "entrégalo" o "despliega a producción"
• frontend-web o frontend-mobile Fase 7 (compuertas de QA antes de la entrega)
• backend-api-mastery Fase 7 (documentación y versionado antes de la versión)
• spec-driven-development Fase 8 (compuerta de implementación antes del despliegue)

No la uses para

• Desarrollo local o prototipado sin intención de producción
• Hotfixes donde el CI/CD ya está establecido y el arreglo es trivial
• Cambios solo de documentación sin impacto en el código

3 guíasSKILL.md

Instrumenta un repo con puertas mecánicas para que un agente no pueda commitear código sin tests. Instala hooks locales, una puerta TDD y un check de CI requerido, y prueba que la puerta se dispara.

Se activa cuando

• el agente de IA envía código sin tests o sin revisión
• se piden puertas, enforcement o un check de CI requerido
• un repo tiene prompts pero sin enforcement mecánico

Úsala para

• El usuario dice que su agente de IA envía código sin tests o sin revisión
• Quieren una puerta TDD, una puerta pre-commit o un check de CI requerido
• Piden 'agregar enforcement', 'bloquear commits malos' o 'hacer que el agente lo pruebe'
• Un repo tiene prompts (CLAUDE.md, .cursorrules, AGENTS.md) pero sin enforcement mecánico

No la uses para

• El repo ya tiene puertas activas (verifícalo primero)
• Proyectos que no usan git (sin VCS no hay hooks)
• Scripts de una sola vez donde una puerta es puro ruido

2 guíasSKILL.md

Prepara lanzamientos a producción con listas de verificación, monitoreo, despliegue gradual y estrategias de reversión.

Se activa cuando

• cualquier despliegue significativo

Úsala para

• Desplegar una función a producción por primera vez
• Publicar un cambio significativo para los usuarios
• Migrar datos o infraestructura
• Cualquier despliegue que conlleva riesgo (todos)

No la uses para

• Desarrollo local o prototipado
• Configuración de CI/CD previa a producción (usa ci-cd-and-automation)

2 guíasSKILL.md

Registra métricas de calidad empíricas entre proyectos: tasa de compilaciones correctas, retrabajo, cobertura, tiempo de descubrimiento y tasa de aprobación de compuertas. Se ejecuta automáticamente en segundo plano.

Se activa cuando

• Automáticamente en segundo plano tras cada acción significativa

Úsala para

• Automáticamente en segundo plano tras cada acción significativa. No requiere invocación directa.

No la uses para

• Recolección manual de datos o consultas puntuales (se ejecuta automáticamente)
• Invocación directa (solo como skill en segundo plano)

2 guíasSKILL.md

Edita o crea la configuración propia de OpenCode.

Se activa cuando

• configurar OpenCode en sí mismo

Úsala para

• Crear o editar opencode.json / opencode.jsonc
• Añadir, modificar o eliminar servidores MCP
• Cambiar las reglas de permisos de los agentes
• Instalar o deshabilitar plugins
• Editar rutas de skills o definiciones de agentes

No la uses para

• El código de tu aplicación (usa la skill de plataforma adecuada)
• Cualquier proyecto que no consista en configurar OpenCode en sí mismo

2 guíasSKILL.md

Audita y corrige problemas del proyecto mediante un bucle de automejora: detectar, diagnosticar, proponer y ejecutar con aprobación humana. Máximo 3 iteraciones por sesión.

Se activa cuando

• Después de una sesión en la que se hicieron varios commits

Úsala para

• Después de una sesión en la que se hicieron varios commits
• Cuando el usuario dice "ejecuta el bucle de automejora" o "audita el proyecto"
• Al inicio de la sesión si audit-project.sh no se ejecutó en 7 o más días

No la uses para

• Ediciones puntuales o desarrollo activo (usa las skills de implementación de funciones)
• Configuración inicial de un proyecto

4 guíasSKILL.md

Genera skills de agente nuevas a partir de la descripción de un flujo de trabajo: SKILL.md con frontmatter, flujo, ejemplos y casos de evaluación.

Se activa cuando

• crear a partir de una descripción

Úsala para

• Necesitas una skill nueva y no quieres escribir SKILL.md desde cero
• Tienes una descripción clara del flujo de trabajo que la skill debe ejecutar
• Quieres una skill con casos de evaluación incluidos desde el principio
• Prototipado rápido de capacidades nuevas

No la uses para

• Modificar una skill existente (usa skill-improver)
• Tareas puntuales que no se reutilizarán como skills
• Crear skills para flujos triviales (mejor escribirlas a mano)

2 guíasSKILL.md

Analiza casos de evaluación fallidos y propone mejoras. Lee resultados de evaluación, identifica patrones de fallo y produce un diff. No aplica cambios automáticamente.

Se activa cuando

• run-evals.sh muestra fallos de activación en una skill

Úsala para

• run-evals.sh muestra fallos de activación en una skill
• run-golden.sh muestra problemas de calidad de salida
• run-adversarial.sh muestra vacíos de robustez
• La descripción de una skill es demasiado estrecha o demasiado amplia
• La cobertura de evaluación es parcial y necesita ampliarse

No la uses para

• Crear una skill nueva (usa skill-creator)
• La skill aún no tiene casos de evaluación (añádelos primero)
• El arreglo es obvio (edita directamente el SKILL.md)
• El fallo de evaluación proviene de un error en el propio caso de evaluación

2 guíasSKILL.md