Ir a la guía de uso
web-design-reviewerpor GitHub

Web Design Reviewer Skill.

Un skill de Claude Code y Codex para revisión de diseño: inspecciona visualmente un sitio web en ejecución y localiza y corrige problemas de maquetación.

  • Revisión de Diseño y Accesibilidad
  • Informe de revisión
github/awesome-copilot · skills/web-design-reviewer/SKILL.mdSKILL.md
--- name: web-design-reviewer description: This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level. --- ## Scope of Application ## Prerequisites ## Step 1: Information Gathering Phase ## Step 2: Visual Inspection Phase ## Step 3: Issue Fixing Phase ## Step 4: Re-verification Phase
Encabezado y títulos de sección leídos del archivo original el 14 de septiembre de 2026 · 10.577 caracteres en total

01 Qué hace

Qué hace el skill web-design-reviewer 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

Web Design Reviewer conduce un sitio web en ejecución a través de una herramienta de automatización de navegador, lo inspecciona visualmente y repara lo que encuentra en el código fuente. Cubre sitios estáticos, SPAs en React, Vue, Angular o Svelte, frameworks full-stack como Next.js y Nuxt, plataformas CMS como WordPress y Drupal, y cualquier otra aplicación web.

El flujo de trabajo consta de cuatro fases: reunir contexto y detectar automáticamente el framework y el método de estilos, inspeccionar las páginas según una lista de verificación visual, corregir problemas priorizados de P1 a P3, y luego reverificar y repetir. Los hallazgos se agrupan en diseño, responsividad, accesibilidad y consistencia visual, cada uno con una severidad. Las correcciones siguen principios de cambio mínimo y terminan en un informe de revisión en markdown.

Qué produce

  • Un informe de resultados de revisión en markdown titulado Web Design Review Results.
  • Una tabla resumen que cubre la URL objetivo, el framework detectado, los estilos, los viewports probados, los problemas detectados y los problemas corregidos.
  • Entradas por problema con prioridad, página, elemento, descripción, ruta del archivo corregido, detalles de la corrección y capturas de pantalla antes/después.
  • Una sección de problemas sin corregir que indica el motivo por el que se dejó cada problema y una acción recomendada para el usuario, además de recomendaciones generales.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Reunir Contexto y Detectar el Stack

    Solicita la URL si no se proporciona ninguna, luego intenta la detección automática a partir de archivos del workspace como package.json, tsconfig.json, tailwind.config, next.config, vite.config y nuxt.config, y pregunta qué páginas están dentro del alcance.

  2. 02
    Navegar y Capturar

    Abre la URL objetivo, toma capturas de pantalla, obtiene la estructura del DOM o un snapshot cuando es posible, y recorre páginas adicionales a través de la navegación del sitio.

  3. 03
    Inspeccionar según la Lista de Verificación Visual

    Los problemas de maquetación, capacidad de respuesta, accesibilidad y consistencia visual se comprueban recorriendo una lista de verificación de referencia, que se vuelve a usar después de aplicar las correcciones.

  4. 04
    Localizar el Origen de Cada Problema

    Los elementos problemáticos se rastrean hasta su origen buscando en el código base nombres de clase o IDs, localizando el componente a partir del texto o la estructura del elemento, y filtrando patrones de archivos de estilos, componentes y páginas.

  5. 05
    Corregir y Volver a Verificar

    Las correcciones se aplican siguiendo las indicaciones específicas del framework; después se recarga el navegador o se espera al HMR del servidor de desarrollo, se vuelven a capturar capturas de pantalla de las áreas corregidas y se comparan el antes y el después.

02 Encuentra tu caso de uso

Cuándo Usar el Skill web-design-reviewer

Usa el skill web-design-reviewer en Claude Code o Codex cuando el trabajo sea revisión de diseño de este tipo. El alcance y límites se toman del propio archivo del skill.

Buen caso de uso

  • Revisión de un sitio estático construido con HTML, CSS y JS puro.
  • Revisión de una aplicación de una sola página con React, Vue, Angular o Svelte.
  • Revisión de una aplicación con framework full-stack como Next.js, Nuxt o SvelteKit.
  • Revisión de un sitio impulsado por un CMS, como una instalación de WordPress o Drupal.
  • Comprobación de un servidor de desarrollo local que se ejecuta en algo como http://localhost:3000 durante el desarrollo.

Conozca los límites

  • Los entornos de producción solo se admiten para revisiones de solo lectura, por lo que allí no se pueden aplicar cambios.
  • Las correcciones requieren que el código fuente del proyecto exista dentro del workspace, por lo que un sitio remoto sin código local no se puede reparar.
  • La refactorización a gran escala sin confirmación del usuario se indica explícitamente como algo que no se debe hacer.
  • Las correcciones que ignoran el rendimiento se indican como un antipatrón.

Qué proporcionar

  • La URL del sitio que se va a revisarEs obligatoria para la navegación; si el usuario no la proporciona, el skill la solicita, usando http://localhost:3000 como formato de ejemplo.
  • Framework y ubicación de los estilosEl skill pregunta qué framework y método de estilos se usan y dónde se encuentran los archivos de estilos y los componentes, para poder localizar el objetivo de edición correcto.
  • Alcance de la revisiónEl usuario indica si la revisión abarca solo páginas específicas o todo el sitio.

03 Dentro del skill

Reglas que el Skill web-design-reviewer le da 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. Detenerse Después de Tres Intentos

    El skill establece un límite de iteraciones: si un problema específico necesita más de 3 intentos de corrección, debe consultar al usuario en lugar de seguir intentando.

  2. Un Problema a la Vez

    Cada problema se corrige individualmente y se verifica antes de continuar, en lugar de agrupar los cambios.

  3. Capturar Pantalla Antes de Tocar el Código

    Siempre deben guardarse capturas de pantalla del estado con errores antes de aplicar correcciones, para poder comparar el antes y el después.

  4. Solo Cambios Mínimos

    El principio de corrección es realizar solo el cambio mínimo necesario para resolver el problema, respetando el estilo de código existente y evitando cambios que rompan otras partes.

  5. Trabajar con la Matriz de Prioridades

    Los problemas de diseño que afectan la funcionalidad son P1 y se corrigen de inmediato, los problemas visuales que degradan la UX son P2 y se corrigen a continuación, las inconsistencias visuales menores son P3 y se corrigen si es posible.

  6. Probar Cuatro Viewports

    Las comprobaciones responsivas se ejecutan en 375px (Mobile, iPhone SE/12 mini), 768px (Tablet, iPad), 1280px (Desktop) y 1920px (Wide).

  7. Respetar los Patrones Existentes

    Las correcciones deben seguir el estilo de código ya utilizado en el proyecto en lugar de introducir una convención nueva.

  8. Confirmar Antes de Cambios Mayores

    No se realizan refactorizaciones a gran escala de forma unilateral: se le pide al usuario que confirme antes de cambios mayores, y no se corrigen varios problemas a la vez porque eso es difícil de verificar.

04 Ponlo a trabajar

Instalar web-design-reviewer 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.

Agregar web-design-reviewer 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/github/awesome-copilot --skill web-design-reviewer

Formato genérico de la CLI skills para skills/web-design-reviewer/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
Review the design of the website running at http://localhost:3000. It is a [Next.js] app styled with [Tailwind CSS], please check the [home and pricing] pages at mobile and desktop widths. Find the layout, responsive and accessibility problems like element overflow, weak contrast or tiny touch targets, then fix them in the source and verify the fixes.

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:

  • Recargue el navegador o espere al HMR del servidor de desarrollo, luego capture capturas de pantalla de las áreas corregidas.
  • Compare las capturas de pantalla antes y después para cada elemento corregido.
  • Ejecute pruebas de regresión para verificar que las correcciones no hayan afectado otras áreas.
  • Confirme que la visualización responsiva sigue intacta después del cambio.
  • Lea los mensajes de la consola del navegador para detectar errores de JavaScript, mediante la herramienta browser_console_messages en la configuración de referencia de Playwright.

En OpenDesign importe web-design-reviewer desde su enlace SKILL.md: Plugins → Add → Skill → Import from link, y luego 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
GitHub
Archivo de skill
skills/web-design-reviewer/SKILL.md Suma de verificación de contenido registrada en la verificación; commit 1899b18
License
MIT De LICENSE.
Estrellas del repositorio
38,981 Instantánea de GitHub tomada el 2026-09-14 para todo el repositorio github/awesome-copilot, que contiene 6 skills en este catálogo. No es una calificación ni un recuento de uso para web-design-reviewer.
Verificado por OpenDesign
14/09/2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. No incluido en OpenDesign principal (verificado el 28/08/2026); no se ha registrado una ejecución en vivo en esta página.

Dentro del SKILL.md

  1. Ámbito de AplicaciónEnumera sitios estáticos, SPA y frameworks full-stack, plataformas CMS y otras aplicaciones web que cubre.
  2. Requisitos PreviosUn sitio de destino en ejecución, automatización del navegador con acceso a capturas de pantalla y al DOM, y código fuente para las correcciones.
  3. Paso 1: Fase de Recopilación de InformaciónConfirma la URL, pregunta sobre el framework, los estilos y el alcance, y detecta automáticamente los archivos de configuración y el método de estilos.
  4. Paso 2: Fase de Inspección VisualRecorre las páginas, toma capturas de pantalla y comprueba problemas de diseño, responsividad, accesibilidad y consistencia en cuatro viewports.
  5. Paso 3: Fase de Corrección de ProblemasPrioriza de P1 a P3, encuentra los archivos fuente por selector, componente o patrón, y aplica correcciones mínimas específicas del framework.
  6. Paso 4: Fase de ReverificaciónRecarga, vuelve a tomar capturas de pantalla, compara antes y después, ejecuta pruebas de regresión y repite el ciclo si quedan problemas.
  7. Formato de SalidaDefine la plantilla del informe de revisión en markdown con tabla de resumen, problemas, elementos sin corregir y recomendaciones.
  8. Capacidades necesariasTabula la navegación, las capturas de pantalla, el análisis de imágenes, la obtención del DOM, la lectura y escritura de archivos y la búsqueda de código.
  9. Implementación de referenciaMapea capacidades a herramientas MCP de Playwright, ofrece una configuración de servidor MCP y enumera otras herramientas compatibles.
  10. Buenas prácticasListas de qué hacer y qué no: guardar capturas de pantalla, corregir una a la vez, sin refactorización masiva sin confirmación.
  11. Solución de problemasCubre archivos de estilo no encontrados, correcciones no reflejadas y correcciones que afectan a otras áreas.
La descripción propia del Skill
"Este skill permite la inspección visual de sitios web en ejecución local o remota para identificar y corregir problemas de diseño. Se activa con solicitudes como "revisar diseño del sitio web", "verificar la UI", "corregir el layout", "encontrar problemas de diseño". Detecta problemas con diseño responsivo, accesibilidad, consistencia visual y roturas de layout, luego realiza las correcciones a nivel de código fuente."

Descripción del encabezado del SKILL.md. El archivo completo tiene aproximadamente 10,577 caracteres. Lee el archivo completo en GitHub.

06 Antes de instalar

Preguntas sobre el Skill web-design-reviewer

Las respuestas provienen del SKILL.md tal como se leyó el 2026-09-14, no de una ejecución registrada.

¿El sitio tiene que estar en ejecución antes de empezar?

Sí. El primer requisito necesario es un objetivo en funcionamiento, ya sea un servidor de desarrollo local, un entorno de staging o producción para revisiones de solo lectura.

También se requiere automatización de navegador con captura de pantalla, navegación de páginas y obtención del DOM, y las correcciones necesitan que el proyecto exista en el espacio de trabajo.

¿Modifica mi código o solo informa de los problemas?

Realiza correcciones a nivel de código fuente, editando la capa que corresponda al método de estilizado del proyecto: className en componentes para Tailwind, archivos CSS de módulo para CSS Modules, archivos CSS o SCSS planos, y archivos JS/TS para styled-components y Emotion. Si no puede corregir algo, el informe indica el motivo y una acción recomendada.

¿Qué herramienta de automatización de navegador necesita?

Se recomienda Playwright MCP como implementación de referencia, con herramientas para navegación, snapshot, captura de pantalla, clic, redimensionado y mensajes de consola. El workflow también funciona con Selenium, Puppeteer, Cypress o WebDriver BiDi, siempre que estén disponibles la navegación, las capturas de pantalla y la obtención del DOM.

Web Design Reviewer

Ejecutar web-design-reviewer en una Tarea Real de Revisión de Diseño.

Descarga OpenDesign, importa web-design-reviewer desde su enlace SKILL.md, pega el prompt de arriba y lee el plan antes del resultado.

Terminal
npx skills add https://github.com/github/awesome-copilot --skill web-design-reviewer

OpenDesign Desktop

Un sistema de diseño. Tu marca, coherente en cada resultado

En el Vibe Design Workspace completo, aplica las mismas reglas de marca a sitios web, presentaciones, prototipos interactivos, dashboards, imágenes y vídeo HTML. Conecta Codex, Claude Code, Cursor y otros agentes de código locales y crea gratis.

  • Web, presentaciones, prototipos, dashboards, imágenes y vídeo
  • Más de 140 sistemas de diseño y la biblioteca completa de plantillas y skills
  • Codex local y más de 21 agentes de código · Gratis
Descargar gratis

Disponible para macOS y Windows