Ir a la guía de uso
design-reviewpor Garry Tan

Design Review Skill.

Un skill de Claude Code y Codex para revisión de diseño: QA con ojo de diseñador de una página construida: inconsistencias, espaciado, jerarquía, patrones descuidados; luego los corrige.

  • Revisión de Diseño y Accesibilidad
  • Informe de revisión
garrytan/gstack · design-review/SKILL.mdSKILL.md
--- name: design-review description: Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
Encabezados de sección y metadatos leídos del archivo original el 14/09/2026 · 126.647 caracteres completos

01 Qué hace

Qué Hace el Skill design-review en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

QA con ojo de diseñador de un sitio en vivo. Abre las páginas en el propio navegador del usuario, las captura a 375, 768 y 1440, califica diez categorías desde la jerarquía visual hasta los estados de interacción, y luego edita el código fuente para corregir lo encontrado, un commit por cada corrección, reverificando con capturas de antes y después.

La profundidad por defecto es de 5 a 8 páginas; sin una URL en una rama de funcionalidad, se vuelve consciente del diff. Los lectores obtienen dos calificaciones principales, un Design Score ponderado y un AI Slop Score independiente, además de 30 reglas de detección con nombre, como [kicker-above-heading] y [gradient-text], detrás de los juicios de valor.

Qué produce

  • Un informe de auditoría en markdown estructurado en el directorio de la ejecución.
  • Un archivo design-baseline.json escrito para la comparación de regresión en ejecuciones posteriores.
  • Pares de capturas de antes y después para cada corrección aplicada.
  • Un DESIGN.md opcional escrito a partir de las observaciones extraídas, si el usuario acepta la propuesta de la Fase 2.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Reaccione Antes de Analizar

    La Fase 1 abre el objetivo y toma una captura de escritorio de página completa, luego escribe una primera impresión estructurada que indica hacia dónde va la mirada primero.

  2. 02
    Extraiga el Sistema Renderizado

    La Fase 2 examina las fuentes, los colores, la escala de encabezados y los objetivos táctiles dentro de la página, y luego ofrece guardar los hallazgos como un DESIGN.md.

  3. 03
    Audite Página por Página

    La Fase 3 ejecuta un hook de consola, una instantánea interactiva y una captura anotada por página, y luego repite el proceso en tres anchos de viewport.

  4. 04
    Sienta los Flujos

    La Fase 4 recorre 2-3 flujos de usuario, comparando la instantánea después de cada acción y siguiendo una puntuación de buena voluntad para la fricción y la reparación.

  5. 05
    Corrija un Hallazgo a la Vez

    La Fase 8 realiza el cambio mínimo, lo confirma por separado y vuelve a probar antes de pasar al siguiente hallazgo.

  6. 06
    Califique Dos Titulares

    El Design Score es un promedio ponderado de diez categorías, mientras que la calificación de AI slop se mantiene independiente.

02 Encuentra tu caso de uso

Cuándo usar el skill design-review

Usa el skill design-review en Claude Code o Codex cuando el trabajo sea revisión de diseño de este tipo. El alcance y límites a continuación están tomados del propio archivo del skill.

Buen caso de uso

  • Una auditoría previa al lanzamiento o posterior a un rediseño, donde todo el sitio necesita una revisión sistemática, no un chequeo puntual.
  • Trabajar en una rama de funcionalidad que cambia la UI, donde solo deben auditarse las rutas afectadas.
  • Cuando mencione inconsistencias visuales o quiera pulir un sitio en vivo, el skill debería sugerirse por sí mismo.
  • Determinar si una página ya publicada se percibe como generada por IA, algo que la mayoría de los desarrolladores no puede evaluar por sí mismos.
  • Una revisión rápida cuando no hay tiempo para el barrido completo: página de inicio más dos páginas clave y una lista de verificación abreviada.

Conozca los límites

  • Revisar un diseño antes de construirlo: eso es un skill de modo de planificación independiente.
  • Los problemas que están fuera del código fuente, como widgets de terceros o textos que deben provenir del equipo, se marcan como diferidos en lugar de corregidos.
  • No tocará su configuración de CI, y las pruebas existentes son intocables; solo pueden crearse nuevos archivos de pruebas de regresión.

Qué proporcionar

  • La URL de destinoUna dirección activa, localhost incluido. Sin ella, el skill la detecta automáticamente o, en main, se lo pregunta.
  • Una anulación de alcanceLimite el barrido a una sola página o área cuando no desee el recorrido completo.
  • Un indicador de profundidadEl valor predeterminado es standard; --quick lo reduce a tres páginas y --deep lo amplía a un barrido completo previo al lanzamiento.
  • Su DESIGN.md, si existeLos documentos de diseño en la raíz del repositorio se leen primero, de modo que cada decisión se calibra frente al sistema declarado y las desviaciones se evalúan con mayor rigor.
  • Una sesión de navegador ya autenticadaLa auditoría funciona dentro de la sesión que el usuario ya tiene, por lo que las páginas autenticadas no requieren un flujo de inicio de sesión.

03 Dentro del skill

Reglas que la skill design-review ofrece a Claude Code y Codex

8 instrucciones concretas, valores por defecto y límites que SKILL.md fija para el agente: la parte del archivo que cambia el resultado.

  1. Juzgue el Render, no el Repositorio

    La auditoría nunca lee archivos de implementación: los hallazgos deben provenir de la página renderizada. La única excepción es escribir DESIGN.md a partir de observaciones extraídas.

  2. Un Commit por Corrección

    Cada corrección se confirma sola con el formato de mensaje style(design): FINDING-NNN más una breve descripción.

  3. Árbol Limpio Antes de Empezar

    Un árbol de trabajo sucio detiene la ejecución: el agente debe preguntar si desea confirmar, guardar en stash o abortar antes de que exista cualquier commit de corrección.

  4. Preguntar Antes de Actuar en una Cuenta Real

    En un destino no local, las acciones que modifican datos requieren una pregunta de consentimiento por ejecución que enumere exactamente lo que se hará; las rutas de cierre de sesión y eliminación nunca se siguen.

  5. Las Credenciales Nunca Llegan al Agente

    La sesión ya autenticada se usa tal cual. Las contraseñas, códigos de un solo uso, datos de pago, cookies, tokens y localStorage quedan todos fuera de los límites.

  6. Capturas de Pantalla Respaldan Cada Hallazgo

    Un hallazgo sin al menos una captura de pantalla no cuenta, y las imágenes se copian y se leen para que el usuario las vea integradas.

  7. Revertir en el Momento en que Empeora

    Cualquier regresión desencadena un git revert HEAD inmediato y el hallazgo se marca como diferido en lugar de parcheado.

  8. Detener a las 30 correcciones

    El bucle escala cada cinco correcciones y se detiene por completo en cuanto el riesgo de la corrección de diseño supera el 20% o el número de correcciones llega a 30.

04 Ponlo a trabajar

Instala design-review en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Añade design-review a Claude Code, Codex o tu agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

Terminal
npx skills add https://github.com/garrytan/gstack --skill design-review

Forma genérica de la CLI de skills para design-review/SKILL.md; el repositorio puede documentar su propia ruta.

Dale al skill una primera tarea de revisión de diseño

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su material.

Starter prompt
Audit the design of [https://myapp.com/dashboard] at standard depth. Focus on the settings page. I'm signed in as [[email protected]] in Aside. Flag the AI slop patterns and anything that breaks the spacing scale, then fix what you can.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

  • Vuelva a probar la página afectada después de cada corrección y confirme que la lista de errores de consola está vacía o no es peor que la línea base.
  • Cuando se generó un mockup objetivo, compare la captura corregida con él y registre si pasa o falla.
  • Cada corrección se clasifica: verificada cuando la nueva prueba la confirma sin errores nuevos.
  • La fase 9 vuelve a auditar las páginas afectadas y advierte claramente si las calificaciones finales quedaron por debajo de la línea base.
  • El informe indica el recuento del detector como una diferencia de principio a fin, o señala que el detector no estaba instalado o estaba desactivado.

En OpenDesign design-review viene incluido: Plugins → Skills, selecciónelo en la barra superior.

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Author
Garry Tan
Repository
github.com/garrytan/gstack Rama main
Archivo de skill
design-review/SKILL.md Checksum del contenido registrado en la verificación; commit 71f6048
License
MIT De LICENSE.
Estrellas del repositorio
132,921 Instantánea de GitHub tomada el 2026-09-14 para todo el repositorio garrytan/gstack, que contiene 7 skills en este catálogo. No es una calificación ni un conteo de uso para design-review.
Verificado por OpenDesign
14-09-2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. Incluido en OpenDesign main (verificado el 28-08-2026); no se ha registrado una ejecución real en esta página.

Dentro del SKILL.md

  1. ConfiguraciónAnaliza la URL, el alcance, la profundidad y la autenticación; verifica DESIGN.md, árbol limpio, navegador, pruebas.
  2. ModosLos alcances completo, rápido, profundo, con conciencia de diferencias y de regresión determinan qué páginas se visitan.
  3. Fase 1: Primera impresiónCaptura de pantalla de escritorio de página completa, seguida de una reacción instintiva estructurada y una prueba de áreas de la página.
  4. Fase 2: Extracción del sistema de diseñoAnaliza tipografías, colores, escala de encabezados y áreas táctiles, y ofrece guardar un DESIGN.md.
  5. Fase 3: Auditoría visual página por páginaCapturas, tomas anotadas y responsivas, prueba de tronco de navegación y luego una lista de verificación de 10 categorías.
  6. Fase 4: Revisión del flujo de interacciónRecorre 2-3 flujos, compara cada paso y puntúa un medidor de buena voluntad a partir de 70.
  7. Fase 5: Consistencia entre páginasCompara navegación, pie de página, componentes, tono y ritmo de espaciado entre páginas.
  8. Fase 6: Compilar informeCalifica cada categoría de A a F y redacta el informe junto con design-baseline.json.
  9. Fase 7: TriajeOrdena los hallazgos por impacto y deja en espera lo que las ediciones de código fuente no pueden corregir.
  10. Fase 8: Bucle de correcciónLocaliza el origen, realiza la corrección mínima, confirma el cambio, vuelve a probar, clasifica y se autorregula.
  11. Fase 9: Auditoría de diseño finalVuelve a auditar las páginas afectadas, recalcula las puntuaciones y los recuentos del detector, y advierte sobre regresiones.
  12. Fase 10: InformeRedacta el informe completo, el resumen del índice del proyecto, la línea de PR y la diferencia del detector.
La descripción propia del Skill
"QA con ojo de diseñador: encuentra inconsistencias visuales, problemas de espaciado, problemas de jerarquía, patrones de contenido generado por IA y interacciones lentas — y luego los corrige. (gstack)"

Descripción del front-matter de SKILL.md. El archivo completo tiene aproximadamente 126,647 caracteres. Lee el archivo completo en GitHub.

Design Review

Ejecuta design-review en una tarea real de revisión de diseño.

El skill design-review viene incluido en OpenDesign. Descarga la aplicación, selecciona el skill en Plugins → Skills, pega el prompt anterior y lee el plan antes del resultado.

Terminal
npx skills add https://github.com/garrytan/gstack --skill design-review