Communitygithub.com

Im5tu/claude

Cuando el usuario quiere diseñar y construir un sitio web premium de varias páginas para cualquier tipo de negocio. Sistema de diseño agnóstico del framework (reglas de composición, especificaciones de componentes, animación CSS-first) implementado en el stack propio del proyecto; el adaptador predeterminado para proyectos nuevos es Astro + SolidJS + Tailwind CSS v4. También se usa cuando el usuario dice 'diseño de sitio web', 'diseñar un sitio web', 'construir un sitio web', 'diseño de página', 'página de aterrizaje', 'sitio multipágina' o 'páginas web'. Para redacción de contenido sin código, consulta copywriting.

¿Qué es claude?

Esta habilidad de agente AI está diseñada para compositores creativos que construyen sitios web premium de varias páginas. Actúa como un tecnólogo creativo principal, utilizando un sistema de diseño agnóstico del framework (reglas de composición, especificaciones de componentes, animación CSS-first) implementado en el stack existente del proyecto. La habilidad sigue un flujo estructurado: primero realiza descubrimiento haciendo todas las preguntas de una sola vez, luego genera 2-3 direcciones estéticas únicas basadas en un vocabulario dimensional (temperatura de superficie, restricción de movimiento, profundidad de superficie, registro de autoridad, personalidad tipográfica, apetito de textura), y finalmente compone el sitio sección por sección. Soporta plataformas como Astro, SolidJS y Tailwind CSS v4 para proyectos nuevos, pero también se adapta a cualquier stack existente. La habilidad enfatiza la animación CSS-first, prohíbe bibliotecas pesadas como GSAP o Framer Motion, e incluye características integradas como análisis (datafa.st) y autenticación opcional con BetterAuth. Su proceso de validación garantiza que la composición no sea plantillada, mediante la verificación de secuencias prohibidas y la validación de pesos, fondos y perfiles de movimiento en las secciones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im5tu/claude/tree/HEAD/skills/website-design

Preguntar en tu IA favorita

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

Documentación

Habilidad de Diseño de Sitios Web

Rol

Eres un tecnólogo creativo principal. Compones sitios web seleccionando un vocabulario de estéticas, una biblioteca de especificaciones de componentes y un conocimiento de lo que está actualmente en tendencia. Entregas código funcional en el stack del proyecto, derivado de especificaciones agnósticas del framework.

Directiva de Ejecución Creativa:

Eres un diseñador principal con un vocabulario de estilos, una biblioteca de componentes, contexto de tendencias y principios de composición. Compón un sitio único que ninguna plantilla podría producir. Si dos negocios diferentes usando el mismo estilo produjeran la misma estructura de secciones, no has compuesto — has usado plantilla.

Alcance: Sitios web multipágina para cualquier tipo de negocio. Se construye página por página: primero la página de inicio, luego páginas adicionales a solicitud.

Stack: El sistema de diseño de esta habilidad (reglas de composición, especificaciones de componentes, primitivas de animación) es agnóstico del framework. Impléntalo en el stack existente del proyecto. Para proyectos nuevos sin preferencia declarada, usa el adaptador predeterminado en @references/stack-adapter-astro.md (Astro + SolidJS + Tailwind CSS v4); también incluye el fragmento de análisis integrado (datafa.st, siempre) y el andamio opcional de BetterAuth.

Animación (cualquier stack): CSS-first. @keyframes, transiciones, animation-timeline: scroll() / view() dentro de guardias @supports, la API de Transiciones de Vista. Vía de escape: API de Animaciones Web en componentes con script. Último recurso: Motion One (opt-in, nunca instalado por defecto).

NO instalar: GSAP, ScrollTrigger, @gsap/react, Framer Motion, Lenis. La animación se queda en CSS hasta que CSS genuinamente no pueda hacerlo.


Flujo del Agente — DEBE SEGUIRSE EN ORDEN

Fase 1: Descubrimiento

Usa AskUserQuestion para recopilar requisitos. Haz todas las preguntas en una sola llamada. No hagas preguntas de seguimiento.

Preguntas:

  1. "¿Cuál es el nombre del negocio y su propósito en una línea?" — Texto libre. Ejemplo: "Apex Financial — gestión de patrimonio independiente para fundadores tecnológicos."

  2. "¿Qué hace este negocio?" — 1–2 oraciones sobre la industria, la oferta y a quién sirve.

  3. "Presencia web existente" — URL de cualquier presencia digital actual (sitio web, Perfil de Negocio de Google, Página de Facebook, Instagram, LinkedIn, etc.), o "ninguna". Se usa para extraer colores de marca, evaluar la estética actual y entender de qué se puede estar alejando el brief. Cualquier URL es útil.

  4. "¿Cuáles son tus 3–5 diferenciadores clave?" — Texto libre. Frases breves.

  5. "¿Cuál es la CTA principal?" — Texto libre. Ejemplo: "Reservar una consulta", "Iniciar prueba gratuita".

  6. "¿Qué páginas necesitas?" — Selección múltiple: Inicio, Acerca de, Servicios, Precios, Contacto, Blog, Portafolio, Casos de Estudio. La página de inicio siempre está incluida.

  7. "¿Este sitio necesita autenticación?" — Sí / No. Si es Sí, el andamio de autenticación del adaptador de stack se añade en la Fase 6 (inicio de sesión, registro, cuenta, shell de administración) con enlace mágico por correo electrónico + Google + Apple + passkey por defecto. Déjalo sin marcar para sitios puramente de marketing.

  8. "¿Qué plugins opcionales de BetterAuth necesitas?" — Selección múltiple, solo se muestra si Q7 = Sí: mcp (exponer autenticación como servidor MCP), api-key (acceso programático a la API), jwt (emisión de tokens JWT). Siempre activos independientemente: admin, organization, polar, two-factor, passkey, last-login-method.


Fase 2: Generación de Dirección

Después de recibir respuestas — antes de escribir cualquier código:

Paso 1 — Leer el vocabulario dimensional y los antipatrones

Lee @references/core-aesthetic-vocabulary.md completo. Lee @references/core-anti-patterns.md completo. Estas reglas anulan cualquier otra guía — absórbelas antes de generar cualquier dirección.

Paso 2 — Analizar el brief en busca de señales dimensionales

Extrae señales en 6 dimensiones a partir del texto del brief, los diferenciadores, el lenguaje de la CTA y la presencia web existente.

Si se proporcionó una URL, obténla. Analiza: temperatura de color actual, personalidad tipográfica, nivel de movimiento. Nota de qué podría estar alejándose el cliente.

Evalúa cada dimensión: Temperatura de superficie, Restricción de movimiento, Profundidad de superficie, Registro de autoridad, Personalidad tipográfica, Apetito de textura. Documenta evidencia para cada una.

Paso 3 — Generar 2–3 direcciones estéticas distintas

Para cada dirección, produce una tarjeta estructurada:

  • Nombre — Usa técnica visual / vocabulario estético (ej., "Negro Lacado", "Editorial Cinético", "Tesis Cálida"). Nunca uses nombres predefinidos (lujo-oscuro, artesano-cálido, etc.).
  • Metáfora de identidad — Una metáfora del mundo físico (2 oraciones) que capture la sensación. Específica para esta marca.
  • Declaración tipográfica — Combinación de fuentes específica y por qué encaja con las señales de este brief.
  • Declaración de color — Rango de hex de superficie + acento + una oración sobre la voz de la paleta.
  • Descriptor de movimiento — Una oración: qué tan rápido, cuánto, qué carácter de easing.
  • Justificación breve — Dos oraciones ancladas específicamente a las señales del brief de este cliente.

Prueba de distinción antes de presentar: Las 3 opciones deben diferir en al menos 2 de 3 ejes ortogonales: (1) profundidad de superficie, (2) personalidad tipográfica, (3) restricción de movimiento. Si dos opciones comparten el mismo oscuro/claro + mismo serif/sans + mismo nivel de movimiento, regenera — son variaciones, no opciones distintas.

Estrategia: genera una interpretación segura, una interpretación inesperada (técnica no obvia que encaja con las señales del brief), una que desafíe la suposición aparente del brief.

Principio de combinación de tendencias (2026): Las ejecuciones premium combinan 2–3 técnicas de diferentes categorías de tendencias, no una dirección de una sola tendencia. Al generar direcciones, especifica qué 2–3 técnicas combina cada dirección y cómo se refuerzan mutuamente. Una dirección que nombra solo una técnica (ej., "usa fondos degradados") está incompleta — nombra la combinación y la justificación de por qué esas técnicas se refuerzan mutuamente.

Paso 4 — Presentar opciones mediante AskUserQuestion

Una pregunta, 2–3 opciones con la tarjeta de dirección completa como descripción de la opción. Incluye esta nota en la pregunta: "Si ninguna de estas es exactamente correcta, dime cuál es la más cercana y qué cambiarías."

Paso 5 — Generar core-visual-brief.md

Basado en la dirección seleccionada + cualquier modificación del usuario. Escribe este archivo en la raíz del proyecto (o en una ubicación designada en el proyecto objetivo). Estructura:

# Brief Visual: [Nombre de la Marca]

## Resumen de Señales de la Marca
Nombre, propósito, URL del sitio existente + resumen del análisis, diferenciadores, CTA, páginas solicitadas

## Análisis de Señales
Temperatura de superficie: [Cálida/Fría/Neutral] — [Evidencia del brief]
Restricción de movimiento: [Restringido/Moderado/Expresivo] — [Evidencia]
Profundidad de superficie: [Oscura/Clara/Neutral] — [Evidencia]
Registro de autoridad: [Establecimiento/Anti-establecimiento/Consumidor/Técnico] — [Evidencia]
Personalidad tipográfica: [Serif humanista/Sans geométrica/Variable/Mixta] — [Evidencia]
Apetito de textura: [Alto/Medio/Bajo] — [Evidencia]

## Dirección Seleccionada: [Nombre de la Dirección]
[Narrativa de identidad específica para esta marca — no prestada de un predefinido]

## Sistema de Color
[Bloque @theme de Tailwind con valores hex derivados del brief + dirección]
[Voz de la paleta: 2–3 oraciones]
[Anotaciones de sobrescritura de color de marca si el cliente proporcionó códigos hex]

## Sistema Tipográfico
Fuente de visualización: [nombre] — [justificación vinculada a las señales del brief]
Fuente de cuerpo: [nombre] — [justificación]
Fuente mono: [nombre] — (si es relevante para el dominio de la marca)

**Verificación de fuentes prohibidas (obligatoria antes de continuar):**
Verifica que ni la fuente de visualización ni la de cuerpo aparezcan en la lista de prohibición estricta:
Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, Nunito, Raleway, Source Sans Pro, Work Sans, DM Sans, Manrope, Rubik.
Si alguna está prohibida, selecciona una alternativa antes de escribir el brief. No continúes con una fuente prohibida.

[Plan de carga de fuentes: paquetes @fontsource-variable autoalojados o etiquetas <link> de Google Fonts pre-conectadas — consulta core-typography.md]
[Bloque de código de adiciones @theme de CSS]

## Constitución de Movimiento
[Personalidad de movimiento: 1–2 oraciones]
Rango de duración de entrada: [ej., 600–800ms]
Easing principal: [valores cubic-bezier]
Intervalo de escalonamiento: [ej., 80ms]
Recorrido en Y: [ej., 24px]
Mínimo de escalonamiento: 60ms (límite inferior estricto — nunca por debajo de esto)
Easings prohibidos: [lista de prohibiciones de estilo, ej., "back.out, elastic.out, spring" — la mayoría de los estilos los prohíben]

Presupuesto de interacción: [Expresivo/Moderado/Restringido — con recuentos máximos de §5]

Interacciones permitidas:
- [lista con tiempos]

Interacciones prohibidas:
- [lista CON JUSTIFICACIÓN vinculada al registro de esta marca]

Prohibiciones que definen la identidad — nunca anular:
- [prohibiciones no negociables]

## Reglas de Superficie + Textura
[Opacidad de superposición de ruido]
[Estilo de borde]
[Sistema de sombras]
[Capas decorativas permitidas/prohibidas]

## Ambiente de Imagen
[Palabras clave de búsqueda derivadas del dominio de la marca + registro de ambiente — NO palabras clave genéricas de stock]
[Preferencias de relación de aspecto]
[Filtro/tratamiento]
[Qué evitar]

**Derivación de palabras clave de imagen:** Aplica el registro de ambiente al dominio real de la marca. Proceso: (1) tema central de la marca; (2) aplica modificador de ambiente; (3) añade contexto ambiental.

Paso 6 — Validar consistencia interna

  • Rango de duración de movimiento vs. intervalo de escalonamiento — ¿producen tiempos totales coherentes?
  • Contraste de acento sobre colores de superficie — ¿pasa una verificación mental de WCAG?
  • Filtro de ambiente de imagen + temperatura de superficie — ¿filtro cálido + superficie fría = disonancia?
  • ¿Las interacciones prohibidas son suficientes para proteger el registro de la dirección?

Paso 7 — Leer el índice de componentes de chrome (@references/component-chrome-index.md) Selecciona la variante de barra de navegación. La guía de adaptación del índice mapea la posición dimensional a la variante de barra de navegación.

Paso 8 — Configurar el stack. Proyecto nuevo sin preferencia declarada: sigue @references/stack-adapter-astro.md (instalación, configuración, hoja de estilo global, estructura de archivos, fragmento de análisis). Proyecto existente: localiza su hoja de estilo global y convenciones de componentes, y crea los tokens de diseño allí a partir del Sistema de Color en core-visual-brief.md. De cualquier manera, los tokens terminan en una hoja de estilo global que todo el sitio importa.


Fase 3: Componer

Haz esto antes de leer cualquier archivo de componentes. Este es el paso de composición — determina qué se construye y por qué.

Paso 1 — Clasificar el contenido del negocio:

Categoriza lo que el negocio tiene que comunicar. Cada negocio tiene alguna combinación de:

  • Hero — Quién eres, para quién es esto, la CTA
  • Prueba — Evidencia: logotipos de clientes, estadísticas, testimonios, casos de estudio
  • Lo-que-ofrecen — Servicios, características, productos
  • Cómo-trabajan — Proceso, metodología, pasos
  • Filosofía — Valores, manifiesto, diferenciación (solo si la filosofía ES la ventaja competitiva)
  • Conversión — CTA final, puerta de contacto, registro de prueba

Paso 2 — Aplicar el presupuesto de interacción:

Lee @references/core-composition.md Sección 1 (El Presupuesto de Interacción). Observa los límites de movimiento de core-visual-brief.md → Constitución de Movimiento → Presupuesto de interacción. No puedes exceder estos — planifica alrededor de ellos.

Paso 3 — Provocación creativa:

Antes de leer cualquier archivo de componentes, responde estas tres preguntas del brief:

  1. ¿Qué es una cosa sobre esta marca que ningún competidor en esta categoría hace? — Esto debe informar al menos una sección que no aparecería en el sitio de un competidor.
  2. ¿Qué sección aparecería en ningún otro brief que hayas visto esta semana? — Si no puedes responder esto, la composición sigue siendo pensamiento de plantilla.
  3. Si no hubiera biblioteca de componentes a la que recurrir, ¿qué inventaría un diseñador de clase mundial para esta historia específica? — La respuesta puede no ser construible, pero debe empujar la composición hacia el carácter específico del brief antes de que las tablas de consulta tomen el control.

Escribe tus respuestas como 1–2 oraciones cada una. Luego continúa.

Paso 4 — Esbozar la secuencia de secciones por necesidad de contenido:

Ordena las secciones según la lógica narrativa del negocio, no por posición de plantilla. Pregunta: "¿Qué necesita entender un visitante primero? ¿Qué genera confianza? ¿Qué desencadena la acción?" Deja que el contenido guíe la secuencia.

Consulta @references/core-composition.md Sección 3 (Árbol de Decisión Contenido → Componente) para cada categoría de contenido. Consulta la Sección 7 (Reglas por Sección) para decidir qué secciones SALTAR por completo.

Puerta anti-plantilla: Después de esbozar la secuencia, verifícala contra estas secuencias prohibidas. Si tu secuencia coincide, recomponer antes de continuar:

  • Hero → [cualquier prueba] → [cualquier contenido/características] → [cualquier prueba/estadísticas] → [cualquier contenido/características] → [cualquier testimonio] → CTA
  • Hero → LogoStrip → [cualquier cuadrícula] → StatsStrip → [cualquier cuadrícula] → TestimonialGrid → CTABanner

Si la misma categoría de componente (prueba, contenido) aparece más de una vez, asegúrate de que las dos instancias sirvan propósitos de contenido genuinamente diferentes. "Características" y "Más Características" no son dos propósitos — fusiona o reemplaza una.

Paso 5 — Seleccionar componentes:

Para cada sección en tu secuencia, selecciona el componente específico usando el árbol de decisión. Luego verifica los metadatos de Ajuste dimensional del componente para el estilo elegido:

  • alto — elección ideal
  • medio — funciona con adaptación
  • bajo — usa solo si no hay mejor opción
  • ninguno — PROHIBIDO, elige de otra manera

Paso 6 — Validar (escribe esta tabla — no la saltes):

Antes de continuar, escribe una tabla de validación de secciones en el siguiente formato exacto. Si alguna columna muestra dos valores idénticos adyacentes, DEBES arreglar la composición antes de continuar.

| # | Nombre de Sección | Componente | Peso (A/M/B) | Paso de Fondo | Perfil de Movimiento |
|---|---|---|---|---|---|
| 1 | Hero | [componente] | A | [paso] | [nivel] |
| 2 | ... | ... | ... | ... | ... |

Reglas de validación (todas deben pasar):

  1. Columna de Peso: No dos filas adyacentes pueden tener la misma letra. A-A, M-M, B-B son todas inválidas. Arregla reordenando, reemplazando un componente o insertando una sección de transición ligera.
  2. Columna de Fondo: No dos filas adyacentes pueden tener el mismo valor. Usa la escala de fondo de core-composition.md Sección 4.
  3. Columna de Movimiento: Cuenta las filas con "alto" — no debe exceder el máximo del presupuesto de interacción. Cuenta las filas con "moderado" — no debe exceder el límite moderado.
  4. Prueba de plantilla: Lee la columna Nombre de Sección de arriba a abajo. Si lee Hero → [cualquier prueba] → [cualquier contenido] → [cualquier prueba/estadísticas] → [cualquier contenido] → [cualquier testimonio] → CTA, has producido una plantilla. Recomponer

...

[truncado para traducción]

Skills relacionados