Respuesta rápida
- Qué es
- web-design-guidelines es una skill de Vercel (licencia MIT) que le pide a Claude bajar las reglas de interfaz de Vercel en cada revisión y comparar contra ellas el código de tu web.
- Qué le das
- Los archivos o la carpeta de tu web que quieres revisar
- Qué te devuelve
- Una lista breve de hallazgos agrupados por archivo, con el formato archivo:línea
- Autor
- Vercel
- Licencia
- MIT
- Repositorio
- vercel-labs/agent-skills
- En GitHub
- 34,1 mil estrellas · actualizada el
- Revisada por Claura
Instálala en una línea para todos tus proyectos, en Claude Code, Cursor, Codex y más:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g
Funciona en
~/.claude/skills/~/.agents/skills/~/.agents/skills/~/.agents/skills/Pedidos para probarla
Con la skill instalada, copia uno y pégaselo a tu agente tal cual, o cambia los datos por los tuyos.
Revisa los archivos de app/contacto con las reglas de interfaz de Vercel y dime qué incumple, archivo por archivo y línea por línea.
Pasa el formulario de reservas por las reglas de accesibilidad y formularios antes de publicarlo.
Revisa todo src/components y ordena los hallazgos de lo más grave a lo menos grave.
#Qué hace
web-design-guidelines es una skill de Vercel, la empresa detrás de Next.js. Su SKILL.md es corto a propósito: describe un procedimiento de cuatro pasos (bajar las reglas, leer los archivos indicados, comparar contra todas las reglas y devolver los hallazgos) y apunta a un único archivo fuente, command.md, en el repositorio vercel-labs/web-interface-guidelines. Le pide al agente que lo descargue fresco antes de cada revisión con su herramienta de lectura web. Si no le dices qué archivos revisar, te lo pregunta.
Lo que se descarga es la lista de las Web Interface Guidelines, unas cien reglas cortas en 17 grupos. Algunos ejemplos tal como vienen: los botones que solo tienen un ícono necesitan aria-label; nunca quitar el contorno de foco sin dar otro; los campos llevan autocomplete, el type correcto y nunca bloquean pegar; los errores van junto al campo y el foco salta al primero al enviar; las imágenes llevan width y height para que la página no salte; se anima solo transform y opacity; las acciones destructivas piden confirmación o dan tiempo para deshacer; los estados de carga terminan en «…». Cierra con una lista de malas prácticas que siempre se marcan.
El formato de salida también lo define ese archivo: hallazgos agrupados por archivo con la forma archivo:línea, que en editores como VS Code se abre con un clic, y una redacción seca, más cerca de una lista de tareas que de un informe.
#Cómo aplicarla a tu negocio
Caso de ejemplo: un ecommerce de cosmética natural de Bogotá tiene su tienda en Next.js. Las ventas desde el móvil son flojas y nadie sabe si es el diseño o el checkout.
- Acota la revisión. No le pidas "revisa toda la web". Empieza por donde se pierde plata: "revisa
app/checkoutycomponents/formscon web-design-guidelines". - Lee los hallazgos por archivo. Sale algo como
components/forms/direccion.tsx:42campo de teléfono sintype="tel"(en el móvil abre el teclado de letras),:58el botón de pagar se desactiva antes de que empiece el pedido,:71el error aparece arriba de la página y no junto al campo (ejemplo). - Conviértelos en tareas. Pídele a Claude que ordene los hallazgos por impacto en la compra y arregle primero los de formularios y foco. Vuelve a correr la revisión sobre los mismos archivos para confirmar que quedaron en cero.
- Hazlo rutina antes de publicar. Cada vez que tocas una página clave, una pasada de esta skill toma minutos y evita que un cambio rompa el teclado o el foco.
La revisión cubre reglas técnicas, no si el diseño convence. Para eso suma impeccable, y para que el texto de la página venda, improved-copywriting.
#Cómo instalarla
El mismo SKILL.md corre en cualquier agente que pueda leer páginas web.
- Con una línea, para cualquier agente:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -gla deja instalada en todos tus proyectos. - A mano: copia la carpeta
skills/web-design-guidelines/del repo a~/.claude/skills/para Claude Code, o a~/.agents/skills/para Cursor, Codex y Gemini CLI (las tres leen esa carpeta). - App de Claude: comprime la carpeta en un ZIP y súbela desde Customize, Skills, «Upload a skill».
No necesita claves de API ni programas. Sí necesita conexión a internet en cada revisión, porque baja las reglas desde raw.githubusercontent.com, y un agente con permiso para leer páginas web.
El SKILL.md completo (con la licencia y la fuente) está más abajo.
El SKILL.md completo
Skill original de Vercel (MIT). Fuente: github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines.
El archivo original está en inglés y va tal cual, sin traducir. Lo de arriba de esta ficha es el resumen en español: qué hace, cómo aplicarla y cómo instalarla.
Leer el archivo (46 líneas)
Web Interface Guidelines
Review files for compliance with Web Interface Guidelines.
How It Works
- Fetch the latest guidelines from the source URL below
- Read the specified files (or prompt user for files/pattern)
- Check against all rules in the fetched guidelines
- Output findings in the terse
file:lineformat
Guidelines Source
Fetch fresh guidelines before each review:
https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.
Usage
When a user provides a file or pattern argument:
- Fetch guidelines from the source URL above
- Read the specified files
- Apply all rules from the fetched guidelines
- Output findings using the format specified in the guidelines
If no files specified, ask the user which files to review.
Copiar el archivo tal cual
--- name: web-design-guidelines description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices". metadata: author: vercel version: "1.0.0" argument-hint: <file-or-pattern> --- <!-- Skill original: web-design-guidelines, de Vercel (https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines) Licencia: MIT. Reproducida con atribución según los términos de la licencia. Copia publicada en claura-ai.com/skills. --> # Web Interface Guidelines Review files for compliance with Web Interface Guidelines. ## How It Works 1. Fetch the latest guidelines from the source URL below 2. Read the specified files (or prompt user for files/pattern) 3. Check against all rules in the fetched guidelines 4. Output findings in the terse `file:line` format ## Guidelines Source Fetch fresh guidelines before each review: ``` https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md ``` Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions. ## Usage When a user provides a file or pattern argument: 1. Fetch guidelines from the source URL above 2. Read the specified files 3. Apply all rules from the fetched guidelines 4. Output findings using the format specified in the guidelines If no files specified, ask the user which files to review.
Preguntas frecuentes sobre la skill web-design-guidelines
¿Qué es la skill web-design-guidelines y para qué sirve?
web-design-guidelines es una skill de Vercel (github.com/vercel-labs/agent-skills, licencia MIT) que se activa cuando le pides a Claude "revisa mi interfaz", "chequea la accesibilidad" o "audita el diseño". No diseña nada: revisa código. Baja la lista vigente de las Web Interface Guidelines de Vercel, lee los archivos que le indicas y devuelve cada incumplimiento con el archivo y la línea, para que vayas directo al lugar. Cubre unas cien reglas concretas: botones sin etiqueta para lectores de pantalla, formularios que bloquean pegar, imágenes sin medidas que hacen saltar la página, animaciones que ignoran a quien pidió menos movimiento.
¿Por qué baja las reglas de internet en cada revisión?
Porque el archivo de la skill casi no trae contenido: es un procedimiento de cuatro pasos y una dirección. Las reglas viven en otro repositorio de Vercel (web-interface-guidelines) y la skill le pide al agente que las descargue frescas antes de cada revisión, así siempre usas la última versión sin reinstalar nada. Tiene dos consecuencias prácticas. Necesitas conexión y un agente que pueda leer páginas web (Claude Code, Cursor, Codex y Gemini CLI pueden). Y lo que se revisa puede cambiar de un mes a otro si Vercel edita la lista; si necesitas un criterio fijo para todo un equipo, guarda una copia del archivo de reglas con fecha.
¿En qué se diferencia de pedirle a Claude que revise mi web sin la skill?
Sin la skill, Claude revisa con lo que recuerda y suele quedarse en lo obvio (contraste, textos alternativos). Con ella tiene una lista cerrada y verificable de 17 grupos: accesibilidad, foco del teclado, formularios, animación, tipografía, imágenes, rendimiento, navegación, pantallas táctiles, modo oscuro, idiomas, entre otros, más una lista de malas prácticas a marcar siempre. Y el formato de salida es parejo: corto, por archivo y con línea, fácil de convertir en tareas. Si lo que buscas es mejorar el aspecto y no cumplir reglas, la indicada es impeccable.
¿Sirve si no programo o si mi web está en WordPress?
Sirve sobre código: archivos HTML, componentes de React o Next y hojas de estilo. Si tu web es un proyecto con código fuente, cualquiera puede correrla con un pedido simple y leer los hallazgos, aunque arreglarlos pide algo de manejo técnico o pedírselo al mismo Claude. En WordPress o un constructor visual no tienes esos archivos a mano y la skill pierde gran parte del sentido. Las reglas están en inglés; pídele el informe en español y lo traduce. Para ordenar el resto del trabajo de tu web, mira las skills para diseño web.
Más skills de Contenido

content-calendar: arma tu calendario de contenido con IA (skill de Claura)
Convierte una lista de ideas o piezas en un calendario fechado, con cadencia, mix de formatos y preview antes de cargar nada.

viral-hooks: generar hooks que paran el scroll (skill de Claura)
Genera hooks y títulos que frenan el scroll en cualquier red, con un framework de 6 tipos y validaciones contra clickbait.

ad-creative: escribir y renovar las creatividades de tus anuncios
Escribe titulares, textos y variaciones de anuncios para Google, Meta, LinkedIn y TikTok, y los renueva a partir de lo que ya rinde en tu cuenta.
Para seguir con este tema
- Guía de WebEl orden para empezar y las notas de este tema.Guía
- Skills de Claude y ChatGPT para diseño webLas skills de Claude para diseño web y páginas web: cuál usar para cada parte, qué le das, qué te devuelve y cómo usarlas en Claude y en ChatGPT.Skill
- Cliente misterioso con Claude: probá tu web antes que tu clienteHacé que Claude en Chrome entre a tu web como un cliente que pide presupuesto y te diga en qué paso se trabó. Prompt completo, atajo y revisión semanal.Nota
AI KID
RE/MAX Patagon
Mateo Caño