Modo
Agendar llamada

web-design-guidelines: revisar tu web con las reglas de interfaz de Vercel

Revisa el código de tu web contra las reglas de interfaz que publica Vercel y te dice, archivo por archivo y línea por línea, qué incumple.

web-design-guidelines: revisar tu web con las reglas de interfaz de Vercel

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
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 CodeEn ~/.claude/skills/
CursorEn ~/.agents/skills/
CodexEn ~/.agents/skills/
Gemini CLIEn ~/.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.

  1. Acota la revisión. No le pidas "revisa toda la web". Empieza por donde se pierde plata: "revisa app/checkout y components/forms con web-design-guidelines".
  2. Lee los hallazgos por archivo. Sale algo como components/forms/direccion.tsx:42 campo de teléfono sin type="tel" (en el móvil abre el teclado de letras), :58 el botón de pagar se desactiva antes de que empiece el pedido, :71 el error aparece arriba de la página y no junto al campo (ejemplo).
  3. 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.
  4. 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 -g la 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

  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.

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

Para seguir con este tema

Elegí qué cookies usamos