Agent-almanac review-web-design

install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/es/skills/review-web-design" ~/.claude/skills/pjt222-agent-almanac-review-web-design-fb6dcd && rm -rf "$T"
manifest: i18n/es/skills/review-web-design/SKILL.md
source content

Revisar Diseño Web

Evaluar un diseño web en cuanto a calidad visual, consistencia y efectividad en distintos dispositivos.

Cuándo Usar

  • Revisar una maqueta o prototipo de diseño antes del desarrollo
  • Evaluar un sitio web o aplicación web implementada en cuanto a calidad de diseño
  • Proporcionar retroalimentación sobre diseño visual durante una sesión de revisión
  • Evaluar la consistencia de marca en múltiples páginas o secciones
  • Verificar el comportamiento del diseño responsivo en distintos puntos de quiebre

Entradas

  • Obligatorio: Diseño a revisar (URL, archivos de maqueta, capturas de pantalla o código fuente)
  • Opcional: Directrices de marca o documentación del sistema de diseño
  • Opcional: Descripción de la audiencia objetivo
  • Opcional: Diseños de referencia o ejemplos de la competencia
  • Opcional: Áreas específicas de preocupación

Procedimiento

Paso 1: Evaluar la Jerarquía Visual

La jerarquía visual guía el ojo del usuario a través del contenido en orden de importancia.

  • Punto focal claro: ¿Hay un punto de entrada obvio en cada página/pantalla?
  • Jerarquía de encabezados: ¿Descienden los encabezados lógicamente (H1 → H2 → H3)?
  • Contraste de tamaño: ¿Son los elementos importantes más grandes que los elementos de soporte?
  • Contraste de color: ¿Son las llamadas a la acción y acciones clave visualmente prominentes?
  • Espacio en blanco: ¿El espaciado separa eficazmente los grupos lógicos?
  • Flujo de lectura: ¿Sigue el diseño un patrón de lectura natural (patrón F, patrón Z)?
## Evaluación de Jerarquía Visual
| Página/Sección | Punto Focal | ¿Jerarquía Clara? | Problemas |
|---------------|-------------|------------------|----------|
| Inicio | CTA en el hero | Sí | El CTA secundario compite con el principal |
| Página de producto | Imagen del producto | En su mayoría | El precio no es lo suficientemente prominente |
| Formulario de contacto | Botón de envío | No | El título del formulario tiene el mismo tamaño que el texto del cuerpo |

Esperado: Cada página/sección principal evaluada en cuanto a jerarquía visual clara. En caso de fallo: Si las maquetas no están disponibles, evalúe desde el código en vivo usando las herramientas de desarrollo del navegador.

Paso 2: Evaluar la Tipografía

  • Selección de fuentes: ¿Son las fuentes apropiadas para la marca y el tipo de contenido?
  • Combinación de fuentes: ¿Se complementan las fuentes de encabezado y cuerpo (máximo 2-3 familias)?
  • Escala tipográfica: ¿Existe una escala consistente (p. ej., segunda mayor 1.25, cuarta perfecta 1.333)?
  • Altura de línea: El texto del cuerpo tiene altura de línea 1.4-1.6; los encabezados tienen 1.1-1.3
  • Longitud de línea: La longitud de línea del texto del cuerpo es de 45-75 caracteres (óptimo ~66)
  • Peso de fuente: Las variaciones de peso usadas consistentemente para indicar jerarquía
  • Tamaño de fuente: El tamaño base de fuente es al menos 16px para el texto del cuerpo
/* Ejemplo de escala tipográfica bien estructurada (ratio 1.25) */
:root {
  --text-xs: 0.64rem;    /* 10.24px */
  --text-sm: 0.8rem;     /* 12.8px */
  --text-base: 1rem;     /* 16px */
  --text-lg: 1.25rem;    /* 20px */
  --text-xl: 1.563rem;   /* 25px */
  --text-2xl: 1.953rem;  /* 31.25px */
  --text-3xl: 2.441rem;  /* 39.06px */
}

Esperado: Tipografía evaluada en cuanto a consistencia, legibilidad y jerarquía. En caso de fallo: Si el diseño usa más de 3 familias de fuentes, recomiende una consolidación.

Paso 3: Revisar el Uso del Color

  • Coherencia de paleta: ¿Es la paleta de colores intencional y limitada (típicamente 3-5 colores + neutros)?
  • Alineación con la marca: ¿Coinciden los colores con las directrices de marca?
  • Ratios de contraste: El texto cumple WCAG AA (4.5:1 para texto normal, 3:1 para texto grande)
  • Color semántico: ¿Se usan los colores consistentemente para transmitir significado (rojo=error, verde=éxito)?
  • Daltonismo: ¿Se transmite la información por más medios que solo el color?
  • Modo oscuro/claro: Si se admite, ambos modos mantienen la legibilidad y consistencia de marca
## Evaluación de Color
| Uso | Color | Ratio de Contraste | WCAG AA | Notas |
|-----|-------|-------------------|---------|-------|
| Texto del cuerpo sobre blanco | #333333 | 12.6:1 | Pasa | Bien |
| Texto de enlace sobre blanco | #2563eb | 5.2:1 | Pasa | Bien |
| Texto atenuado sobre gris claro | #9ca3af sobre #f3f4f6 | 2.1:1 | FALLA | Aumentar contraste |
| Texto del botón CTA | #ffffff sobre #22c55e | 3.1:1 | FALLA para texto pequeño | Usar verde más oscuro o texto más grande |

Esperado: Paleta de colores revisada en cuanto a coherencia, accesibilidad y consistencia semántica. En caso de fallo: Use una herramienta de verificación de contraste (WebAIM) para verificar los ratios exactos.

Paso 4: Evaluar el Diseño y el Espaciado

  • Sistema de cuadrícula: ¿Se usa una cuadrícula consistente (12 columnas, auto-diseño o personalizada)?
  • Escala de espaciado: ¿El espaciado es sistemático (base 4px/8px, o escala similar a Tailwind)?
  • Alineación: ¿Los elementos están alineados a la cuadrícula (sin elementos "casi alineados")?
  • Densidad: ¿Es la densidad de información apropiada para el tipo de contenido (datos pesados vs. marketing)?
  • Espacio en blanco: ¿Se usa el espacio en blanco intencionalmente para agrupar y separar?
  • Consistencia: ¿Las secciones similares tienen el mismo espaciado?

Auditoría de espaciado:

## Verificación de Consistencia de Espaciado
| Par de Elementos | Brecha Esperada | Brecha Real | ¿Consistente? |
|-----------------|----------------|-------------|--------------|
| Título de sección a contenido | 24px | 24px | Sí |
| Tarjeta a tarjeta | 16px | 16px/24px | No — inconsistente |
| Etiqueta de formulario a entrada | 8px | 4px/8px/12px | No — varía |

Esperado: El diseño usa una cuadrícula sistemática y una escala de espaciado consistentemente. En caso de fallo: Si el espaciado es inconsistente, recomiende adoptar una escala de espaciado (p. ej.,

space-*
de Tailwind).

Paso 5: Evaluar el Diseño Responsivo

Probar en los puntos de quiebre clave:

Punto de QuiebreAnchoRepresenta
Móvil375pxiPhone SE / teléfonos pequeños
Móvil L428pxiPhone 14 / teléfonos grandes
Tableta768pxiPad en portrait
Escritorio1280pxPortátil estándar
Ancho1536px+Monitor de escritorio

Verificar en cada punto de quiebre:

  • Adaptación del diseño: ¿El diseño se reordena apropiadamente (apilado en móvil, lado a lado en escritorio)?
  • Objetivos táctiles: ¿Son los elementos interactivos de al menos 44x44px en móvil?
  • Legibilidad del texto: ¿El tamaño de fuente es apropiado para la ventana gráfica?
  • Escalado de imágenes: ¿Cambian de tamaño las imágenes sin distorsión ni desbordamiento?
  • Navegación: ¿Es la navegación móvil accesible (hamburguesa, navegación inferior, etc.)?
  • Sin scroll horizontal: El contenido no desborda horizontalmente la ventana gráfica
## Revisión Responsiva
| Punto de Quiebre | Diseño | Objetivos Táctiles | Texto | Imágenes | Navegación | Problemas |
|-----------------|--------|-------------------|-------|---------|-----------|---------|
| 375px | OK | OK | OK | Desbordamiento en hero | Hamburguesa | La imagen hero se recorta |
| 768px | OK | OK | OK | OK | Hamburguesa | Ninguno |
| 1280px | OK | N/A | OK | OK | Navegación completa | Ninguno |
| 1536px | OK | N/A | Línea demasiado larga | OK | Navegación completa | Agregar max-width al contenido |

Esperado: Diseño probado en todos los puntos de quiebre clave con problemas documentados. En caso de fallo: Si las herramientas de prueba responsiva no están disponibles, revise las media queries de CSS para cobertura.

Paso 6: Verificar la Consistencia de Marca

  • Uso del logotipo: Logotipo renderizado correctamente (tamaño, espaciado, zona de exclusión)
  • Precisión del color: Los colores de marca coinciden con las especificaciones (valores hex, no "suficientemente parecido")
  • Correspondencia de tipografía: Las fuentes coinciden con las directrices de marca
  • Tono/voz: El texto de la interfaz coincide con la personalidad de la marca
  • Iconografía: Los iconos son de un conjunto consistente (estilo, peso, cuadrícula)
  • Estilo fotográfico: Las imágenes coinciden con las directrices de marca (si aplica)

Esperado: Elementos de marca verificados frente a las directrices con desviaciones específicas anotadas. En caso de fallo: Si no existen directrices de marca, anote esto como recomendación y evalúe la consistencia interna en su lugar.

Paso 7: Redactar la Revisión de Diseño

## Revisión de Diseño Web

### Impresión General
[2-3 oraciones: calidad general, aspectos más fuertes y más débiles]

### Jerarquía Visual: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Tipografía: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Color: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Diseño y Espaciado: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Diseño Responsivo: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Consistencia de Marca: [Puntuación/5]
[Hallazgos clave con referencias específicas]

### Mejoras Prioritarias
1. [Cambio más impactante — específico y accionable]
2. [Segunda prioridad]
3. [Tercera prioridad]

### Notas Positivas
1. [Lo que funciona bien y debe preservarse]

Esperado: La revisión proporciona retroalimentación específica con referencias visuales y mejoras priorizadas. En caso de fallo: Si la puntuación parece arbitraria, use un sistema más simple de pasa/preocupación/falla en su lugar.

Validación

  • Jerarquía visual evaluada para todas las páginas/secciones principales
  • Tipografía evaluada en cuanto a legibilidad, consistencia y escala
  • Contraste de color verificado frente a los mínimos WCAG AA
  • Diseño y espaciado verificados en cuanto a consistencia de cuadrícula
  • Diseño responsivo probado en 3+ puntos de quiebre
  • Consistencia de marca verificada frente a directrices (o consistencia interna evaluada)
  • La retroalimentación es específica con referencias visuales (página, sección, elemento)

Errores Comunes

  • Subjetividad sin razonamiento: "No me gusta el color" no es accionable. Explique por qué (contraste, desajuste con la marca, accesibilidad).
  • Ignorar la accesibilidad: La revisión de diseño visual debe incluir verificaciones de contraste WCAG. Los diseños hermosos que excluyen usuarios no son buenos diseños.
  • Revisar solo maquetas: Pruebe el comportamiento responsivo, los estados al pasar el cursor y las transiciones — no solo los diseños estáticos.
  • Prescribir soluciones: Describa el problema ("el texto es difícil de leer sobre este fondo") en lugar de dictar una solución específica ("use #333").
  • Olvidar el contexto: Una aplicación bancaria y un sitio de juegos tienen estándares de diseño diferentes. Revise según el contexto apropiado.

Habilidades Relacionadas

  • review-ux-ui
    — usabilidad, patrones de interacción y accesibilidad (complementario al diseño visual)
  • setup-tailwind-typescript
    — implementación de Tailwind CSS para sistemas de diseño
  • scaffold-nextjs-app
    — andamiaje de aplicaciones Next.js