Communitygithub.com

web-design-playbook

Habilidad de diseño. Flujo de trabajo para implementar diseño de sitios web, LP y maquetas HTML. Se usa al crear o rediseñar, o en solicitudes como «hazlo bonito», forzando el ciclo: capa de referencia → definición de dirección → implementación → verificación en dispositivo real → retroalimentación de aprendizajes. También se usa cuando el usuario comparte una URL de un sitio que le gusta o que quiere como referencia.

¿Qué es web-design-playbook?

Esta habilidad (skill) para agentes de IA como Claude Code, Cursor o Codex establece un flujo de trabajo estructurado y repetible para la implementación de diseño web. Su núcleo es un archivo de acumulación (`~/.claude/design-taste.md`) que almacena preferencias de diseño y sitios de referencia del usuario. A medida que se usa, la habilidad aprende de las reacciones del usuario, registrando qué patrones funcionan y cuáles no, y convirtiendo opiniones generales en un criterio de diseño personalizado y probado. El flujo obliga a cinco pasos: cargar referencias existentes, definir la dirección visual, implementar usando componentes prefabricados cuando sea posible (como Web Bento), verificar en dispositivos reales con anchos de 390/880/1280px, y finalmente registrar aprendizajes en el archivo de acumulación. Esto asegura consistencia y evita rediseños costosos al validar la dirección temprano con un único boceto de pantalla.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ry071702-prog/web-design-playbook/tree/HEAD/skills/web-design-playbook

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Web Design Playbook

Flujo de trabajo de implementación de diseño para reproducir la calidad con un método estructurado. El núcleo es la iteración con el siguiente «archivo de acumulación»: absorber buen diseño y escribir de vuelta las lecciones aprendidas, para que, cuanto más se use, más se convierta en un método personalizado para ese usuario.

Archivo de acumulación (el centro de esta skill)

Registro maestro de las preferencias de diseño y sitios de referencia de cada usuario. La ubicación es ~/.claude/design-taste.md. Si no existe, se crea con esta plantilla la primera vez:

# Design Taste — Acumulación de diseño personal

## Principios probados
<!-- Agregar una línea por cada «patrón que funciona / no funciona» basado en reacciones al diseño creado -->

## Colección de sitios de referencia
<!-- Agregar sitios que te gusten, con una breve explicación de qué los hace buenos -->
| Sitio | URL | Qué lo hace bueno |
|---|---|---|

Cuándo añadir (absorber)

  • Cuando el usuario comparta una URL diciendo «me gusta este sitio», «úsa esto como referencia» o «algo así», visitar el sitio inmediatamente y añadir una línea a la colección de referencia explicando qué lo hace bueno (diseño general, paleta de colores, tipografía, animaciones, arquitectura de información).
  • Cuando la reacción del usuario a un diseño muestre claramente «este patrón funciona / este no funciona», añadir una línea a los principios probados.

Cuándo leer (usar)

  • Leerlo siempre antes de empezar cualquier implementación de diseño (paso 1 del flujo de trabajo). Sirve como criterio para la dirección visual, paleta de colores y animaciones.

Flujo de trabajo

1. Cargar la capa de referencia (obligatorio antes de implementar)

Leer en este orden de prioridad:

  1. DESIGN.md en la raíz del proyecto — registro maestro específico del proyecto. Máxima prioridad.
  2. Archivo de acumulación ~/.claude/design-taste.md — preferencias probadas del usuario.
  3. «Principios de diseño (valores iniciales)» más abajo — valores por defecto si los dos anteriores no aplican.

2. Definir la dirección

  • Si el tono no está definido, presentar primero un borrador de una pantalla (hero + sección representativa) para acordar la dirección. Cambiar de dirección después de haber creado todas las páginas es lo más costoso.
  • Una vez definida la dirección, fijarla en el proyecto usando el formato DESIGN.md (tokens YAML + prosa de intención). Así, cualquier implementador futuro (persona o IA) podrá leerlo y mantener el tono consistente.

3. Implementación

  • Antes de crear componentes decorativos desde cero (botones, encabezados, tarjetas, cargadores, patrones de fondo, etc.), verificar si existen componentes prefabricados en Web Bento.
    • Páginas individuales: https://amix-design.com/tl/web-bento/parts/<slug>.html slug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table
    • Al reutilizar, adaptarlos a los colores, bordes redondeados y tipografía del proyecto (uso comercial permitido, sin crédito requerido. Solo está prohibida la redistribución como colección de componentes, por lo que no se deben incluir en el repositorio).
  • Considerar animaciones desde implementaciones ligeras: CSS / Framer Motion → Rive / Lottie → Three.js. Respetar siempre prefers-reduced-motion.

4. Verificación en dispositivo real (obligatorio antes del despliegue)

  • Tomar capturas de pantalla en el navegador con al menos 3 anchos: 390 / 880 / 1280px (usando Chrome DevTools MCP o similar). Que la compilación pase y que el diseño se vea bien son dos cosas distintas.
  • Revisión de japonés: comprobar que no haya saltos de línea incorrectos en encabezados (partículas aisladas al inicio de línea, palabras partidas), elementos recortados, o información que solo sea visible al hacer hover.
  • Manejo de saltos de línea en japonés: dividir en bloques nowrap por unidades de significado, usar word-break: auto-phrase, y envolver palabras que no deben separarse en spans con nowrap.

5. Retroalimentación de aprendizajes

  • Cuando la reacción del usuario muestre «este patrón funciona / este no funciona», añadir inmediatamente una línea a los «Principios probados» del archivo de acumulación.
  • Repitiendo esto, el criterio de diseño pasará de ser «opiniones generales» a «preferencias probadas de este usuario». Ese es el verdadero valor de este playbook.

Principios de diseño (valores iniciales)

Valores por defecto hasta que el archivo de acumulación tenga suficientes principios probados. Son solo iniciales; si no funcionan, se pueden cambiar:

  • Base blanca + un color de acento + tipografía grande + motivo concreto del tema. Los diseños multicolor u oscuros con dorado (lujo) suelen verse demasiado genéricos y como salidos de una IA.
  • Animaciones lúdicas que respondan a la interacción + sentido de evento, pero sin sacrificar la legibilidad de la información.
  • La emoción se comunica a través de la metáfora del tema (ejemplo: sitio de torneo de fútbol → portada de periódico; evento de proyección → festival cultural). No conformarse con la combinación genérica de gradiente + tarjeta de cristal.

Guía de personalización (cambia esto según tus necesidades)

AspectoCómo personalizarlo
Principios de diseño (valores iniciales)Una vez que tengas suficientes principios probados, el archivo de acumulación es la referencia principal. Elimina esta sección o reescríbela con tus propios principios.
Ubicación del archivo de acumulaciónSi trabajas en equipo, colócalo dentro del repositorio (ej. design/taste.md) y actualiza la ruta en el texto.
Anchos de verificación (390/880/1280px)Ajústalos a los breakpoints reales de tu proyecto.
Revisión de japonésSi el sitio es multilingüe, cambia a la revisión tipográfica del idioma correspondiente (guiones, etc.).
Fuentes de inspiraciónSi tienes diseñadores o escuelas que prefieras, añade sus referencias al paso 1 del flujo de trabajo.

Prohibiciones

  • No crear IPs, personajes o productos ficticios con generación de imágenes de IA (esto es especialmente problemático en contextos que tratan con IPs reales). La decoración debe limitarse a geometría abstracta, tipografía, colores de marca, activos oficiales y fotografías reales.
  • No incluir en el repositorio colecciones de materiales o contenido de terceros que no permitan redistribución (enlázalos en su lugar).

Recomendaciones de uso conjunto (opcional)

  • Taste Skill — control de calidad contra slop: npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend (+ high-end-visual-design / redesign-existing-projects)
  • Validación de DESIGN.md: npx @google/design.md lint

Skills relacionados