Communitygithub.com

Cozythecoder/frontend-design-md

Detecta automáticamente el tipo de proyecto, analiza la intención y aplica el sistema de diseño óptimo entre más de 60 patrones de referencia.

¿Qué es frontend-design-md?

Esta habilidad para agentes de IA (como Claude Code, Cursor o Codex) automatiza el proceso de selección y aplicación de sistemas de diseño en proyectos web. Primero, analiza el proyecto detectando su categoría (SaaS, dashboard, e-commerce, portfolio, etc.) y su estado actual (colores, tipografía, espaciado, componentes). Luego, calcula una puntuación de confianza basada en la coincidencia de categoría, similitud de tokens visuales, patrones de componentes y estructura de layout. En función de esto, recomienda el sistema de diseño más adecuado de una biblioteca de más de 60 patrones de referencia (como linear.app, vercel.com, apple.com). Antes de aplicar cualquier cambio, ejecuta un protocolo de verificación de activos (logotipos, imágenes, esquemas de color existentes) y valida restricciones técnicas (framework, enfoque CSS, capacidad de animación). Finalmente, aplica el sistema de diseño de forma adaptativa: mapea colores existentes, ajusta la escala tipográfica, establece un sistema de espaciado y traduce los nombres de clases de componentes existentes a los patrones del sistema de diseño seleccionado. Incluye una fase de validación con controles de calidad visual, accesibilidad y rendimiento, asegurando una integración coherente y profesional.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

Preguntar en tu IA favorita

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

Documentación

Habilidad de Inteligencia de Sistemas de Diseño

Detecta automáticamente el tipo de proyecto, analiza la intención y aplica el sistema de diseño óptimo entre más de 60 patrones de referencia.

Disparadores de Auto-Detección

Esta habilidad se activa cuando:

  • El usuario crea o modifica cualquier archivo de proyecto web (HTML, CSS, JS, JSX, Vue, Svelte)
  • El usuario dice "diseña esto", "haz que se vea bien", "mejorar la interfaz", "aplicar sistema de diseño"
  • El usuario menciona categorías específicas: "página de aterrizaje", "panel de control", "portafolio", "comercio electrónico"
  • No se especifica ningún sistema de diseño explícito en el proyecto

Fase 1: Análisis del Proyecto (Automático)

SIEMPRE ejecuta el análisis antes de seleccionar el sistema de diseño.

Paso 1: Detectar Categoría del Proyecto

Escanea los archivos del proyecto para determinar el tipo:

# Verificar indicadores
detecciones = {
    'saas-landing': ['precios', 'registro', 'funcionalidades', 'hero', 'testimonios'],
    'panel-app': ['panel', 'gráfico', 'tabla', 'barra-lateral', 'widget'],
    'comercio-electronico': ['producto', 'carrito', 'pago', 'tienda', 'inventario'],
    'portafolio': ['portafolio', 'galería', 'proyecto', 'creativo', 'arte'],
    'publicacion-contenido': ['blog', 'artículo', 'post', 'contenido', 'boletín'],
    'presentacion-marca': ['marca', 'historia', 'acerca', 'misión', 'valores'],
    'herramienta-desarrollador': ['api', 'docs', 'código', 'terminal', 'github'],
    'servicio-negocio': ['servicio', 'contacto', 'proceso', 'equipo', 'consultoría']
}

Paso 2: Analizar Estado Actual

Verificar los tokens de diseño existentes:

  • Colores en configuración CSS/SCSS/Tailwind
  • Tipografía (declaraciones de font-family, font-size)
  • Espaciado (patrones de margin, padding, gap)
  • Componentes (clases de botones, clases de tarjetas)

Paso 3: Coincidir con la Biblioteca de Sistemas de Diseño

Comparar con más de 60 patrones de referencia:

Tipo de ProyectoSistemas de Diseño Recomendados
Aterrizaje SaaSlinear.app, vercel.com, supabase.com, stripe.com, notion.so
Panel/Aplicaciónlinear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard
Comercio Electrónicoapple.com, shopify.com, nike.com
Portafolioframer.com, webflow.com, cargo.site
Contenido/Blogmedium.com, substack.com, stripe.com/blog
Herramienta Desarrolladorvercel.com, github.com, docs.rs, nextjs.org
Servicio/Negociocursor.com, intercom.com, webflow.com
Marca/Agenciatesla.com, apple.com, nike.com

Paso 4: Puntuación de Confianza

Calcular la confianza de coincidencia:

confianza = (
  coincidencia_categoria * 0.40 +      # ¿Coincide el contenido?
  similitud_tokens * 0.30 +            # ¿Superposición de color/tipografía?
  patrones_componentes * 0.20 +        # ¿Patrones de botones/tarjetas?
  estructura_layout * 0.10             # ¿Patrones de grid/flex?
)

Si confianza > 0.75: Sugerir automáticamente la mejor coincidencia
Si 0.50-0.75: Ofrecer 2-3 alternativas
Si < 0.50: Preguntar al usuario por preferencia de categoría

Fase 2: Protocolo de Verificación Pre-Vuelo

Lista de Verificación de Activos

ANTES de aplicar cualquier sistema de diseño:

  1. Verificar project-context.md

    • ¿Existe en la raíz del proyecto?
    • Si no: Crear a partir de plantilla con nombre del proyecto, objetivo, audiencia
  2. Analizar Activos Actuales

    # Ejecutar automáticamente
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    Verifica:

    • ¿Existe logotipo? (SVG preferido)
    • ¿Imágenes del producto? (PNG transparentes para hero?)
    • ¿Esquema de color ya definido?
    • ¿Tipografía ya configurada?
    • ¿Biblioteca de componentes existente?
  3. Determinar Jerarquía de Composición

    • Elemento Hero: Visual más grande (foto del producto, ilustración, titular)
    • Elementos de soporte: Funcionalidades, beneficios, prueba social
    • Acentos: Elementos decorativos, patrones
  4. Validar Restricciones Técnicas

    • Framework detectado (React, Vue, vanilla, etc.)
    • Enfoque CSS (Tailwind, CSS-in-JS, SCSS, etc.)
    • Capacidad de animación (¿GSAP cargado? ¿Framer Motion?)
    • Presupuesto de rendimiento (¿mobile-first? ¿escritorio?)

Fase 3: Aplicación del Sistema de Diseño

Paso 1: Seleccionar y Cargar

Basado en el análisis, cargar el DESIGN.md recomendado:

Recomendado: Sistema de Diseño de Linear.app
Confianza: 87%

Razones de coincidencia:
- Página de aterrizaje SaaS detectada (secciones de precios, funcionalidades)
- Preferencia de modo oscuro detectada
- Tipografía limpia (similar a Inter) encontrada
- Patrones de layout basados en tarjetas presentes

Paso 2: Adaptar al Proyecto

NO copiar y pegar en bruto. Adaptar según el análisis del proyecto:

Colores:

  • Si el proyecto tiene colores de marca: Mapear a roles del sistema de diseño
  • Si no tiene colores: Usar la paleta del sistema de diseño directamente
  • Ejemplo: "Tu azul #3B82F6 → Rol de Acento Primario"

Tipografía:

  • Si usa Inter/Sistema: Mantener la escala del sistema de diseño
  • Si usa una fuente diferente: Adaptar tamaños/pesos
  • Ejemplo: "Roboto en lugar de Inter → Ajustar pesos 400→500"

Espaciado:

  • Verificar la escala de espaciado existente
  • Mapear al sistema de diseño o preservar si es consistente

Componentes:

  • Mapear clases existentes a patrones del sistema de diseño
  • Ejemplo: "Tu .btn-primary → Botón Primario del sistema de diseño"

Paso 3: Lista de Verificación de Implementación

Aplicar el sistema de diseño en orden de prioridad:

  1. Fundación (Crítico)

    • Variables de color CSS mapeadas
    • Escala tipográfica definida
    • Sistema de espaciado establecido
    • Reset/normalize base aplicado
  2. Layout (Alto)

    • Espaciado de secciones (hero, contenido, pie de página)
    • Anchos de contenedor (max-width, padding)
    • Sistema de cuadrícula (si aplica)
  3. Componentes (Medio)

    • Botones (primario, secundario, ghost)
    • Tarjetas (si se usan)
    • Formularios/inputs (si se usan)
    • Navegación (encabezado, pie de página)
  4. Pulido (Bajo)

    • Sombras/elevación
    • Consistencia de border-radius
    • Estados de foco
    • Transiciones hover

Fase 4: Validación

Puertas de Calidad

Ejecutar después de la aplicación:

Verificación de Consistencia Visual:

# Verificar violaciones
violaciones = []

# 1. Conteo de colores
if colores_unicos > 8:
    violaciones.append("Demasiados colores - simplificar paleta")

# 2. Escala tipográfica
if tamanos_fuente > 12:
    violaciones.append("Tipografía no sistemática - consolidar tamaños")

# 3. Consistencia de espaciado
if base_espaciado not in [4, 8, 16]:
    violaciones.append("El espaciado no sigue la cuadrícula de 4/8px")

# 4. Objetivos táctiles
if objetivos_tactiles < 44:
    violaciones.append("Objetivos táctiles por debajo de 44px")

Verificación de Accesibilidad:

  • Contraste de color >= 4.5:1 para texto
  • Indicadores de foco visibles
  • Movimiento reducido respetado
  • Etiquetas ARIA donde sea necesario

Verificación de Rendimiento:

  • Sin animaciones que causen layout-thrashing
  • Imágenes optimizadas
  • Fuentes subconjuntadas (si son personalizadas)

Referencias

Análisis de Sistema de Diseño

Guías de Adaptación

Validación

Patrones Específicos por Categoría

Scripts

  • scripts/analyze-project.py — Detectar categoría, tokens actuales
  • scripts/match-design-system.py — Comparar contra la biblioteca
  • scripts/validate-application.py — Puertas de calidad
  • scripts/generate-adaptation.py — Mapear existente al sistema de diseño
  • scripts/inspect-assets.py — Verificar imágenes, logotipos, activos de marca

Biblioteca de Sistemas de Diseño

Más de 60 sistemas organizados por categoría en ../design-systems/:

SaaS / Herramientas de Desarrollador

  • linear.app (oscuro, Inter, peso 510)
  • vercel.com (Geist, shadow-border)
  • supabase.com (cálido, inspirado en postgres)
  • stripe.com (rico en contenido, degradados)
  • notion.so (amigable, redondeado)
  • github.com (funcional, denso)
  • cursor.com (centrado en editor, colores de sintaxis)

Comercio Electrónico / Producto

  • apple.com (SF Pro, contraste binario, CTAs en píldora)
  • shopify.com (polarizado, tokens Polaris)
  • nike.com (audaz, dinámico, centrado en imágenes)

Creativo / Portafolio

  • framer.com (lúdico, degradados, elástico)
  • webflow.com (profesional, estructurado)

Contenido / Publicación

  • medium.com (centrado en lectura, cuerpo serif)
  • substack.com (cálido, centrado en boletines)

Empresarial

  • ibm.com (Carbon design, sistemático)
  • salesforce.com (funcional, denso)

Automotriz / Lujo

  • tesla.com (mínimo, centrado en producto)
  • ferrari.com (dramático, acento rojo)
  • bmw.com (técnico, preciso)

Flujo de Uso

Usuario: "Construye una página de aterrizaje para mi SaaS"
↓
Habilidad: Analiza el proyecto...
           Detecta: Intención de aterrizaje SaaS
           Estado actual: Sin sistema de diseño
↓
Habilidad: Recomienda linear.app (87% de coincidencia)
           Ofrece alternativas: vercel.com, stripe.com
↓
Usuario: "Usa el estilo de Linear"
↓
Habilidad: Ejecuta protocolo de verificación pre-vuelo
           - Crea project-context.md
           - Analiza activos
           - Verifica stack tecnológico
↓
Habilidad: Aplica sistema de diseño Linear
           - Mapea tokens de color
           - Establece escala tipográfica
           - Implementa componentes
↓
Habilidad: Valida la salida
           - Verificación de contraste de color
           - Consistencia de espaciado
           - Revisión de puertas de calidad
↓
Salida: Proyecto con diseño inspirado en Linear

Configuración

Anular la auto-detección creando un archivo .design-system en la raíz del proyecto:

{
  "system": "linear.app",
  "theme": "dark",
  "adaptations": {
    "primaryColor": "#3B82F6",
    "fontFamily": "Inter"
  }
}

Esta habilidad fusiona tu colección de más de 60 sistemas de diseño con un flujo de trabajo de estilo épico: auto-detección, verificaciones pre-vuelo, validación y adaptación inteligente.

Skills relacionados