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 Proyecto | Sistemas de Diseño Recomendados |
|---|---|
| Aterrizaje SaaS | linear.app, vercel.com, supabase.com, stripe.com, notion.so |
| Panel/Aplicación | linear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard |
| Comercio Electrónico | apple.com, shopify.com, nike.com |
| Portafolio | framer.com, webflow.com, cargo.site |
| Contenido/Blog | medium.com, substack.com, stripe.com/blog |
| Herramienta Desarrollador | vercel.com, github.com, docs.rs, nextjs.org |
| Servicio/Negocio | cursor.com, intercom.com, webflow.com |
| Marca/Agencia | tesla.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:
-
Verificar project-context.md
- ¿Existe en la raíz del proyecto?
- Si no: Crear a partir de plantilla con nombre del proyecto, objetivo, audiencia
-
Analizar Activos Actuales
# Ejecutar automáticamente python3 ~/.claude/skills/design-systems/scripts/inspect-project.pyVerifica:
- ¿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?
-
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
-
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:
-
Fundación (Crítico)
- Variables de color CSS mapeadas
- Escala tipográfica definida
- Sistema de espaciado establecido
- Reset/normalize base aplicado
-
Layout (Alto)
- Espaciado de secciones (hero, contenido, pie de página)
- Anchos de contenedor (max-width, padding)
- Sistema de cuadrícula (si aplica)
-
Componentes (Medio)
- Botones (primario, secundario, ghost)
- Tarjetas (si se usan)
- Formularios/inputs (si se usan)
- Navegación (encabezado, pie de página)
-
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
- deteccion-categoria.md - Cómo detectar tipos de proyecto
- extraccion-tokens.md - Extraer tokens de diseño existentes
- algoritmo-coincidencia.md - Lógica de puntuación de confianza
Guías de Adaptación
- adaptacion-color.md - Mapear colores existentes al sistema de diseño
- adaptacion-tipografia.md - Sustituciones de familias de fuente
- adaptacion-espaciado.md - Mapeo del sistema de espaciado
- mapeo-componentes.md - Traducciones de nombres de clases
Validación
- puertas-calidad.md - 11 reglas no negociables
- verificaciones-accesibilidad.md - Validación A11y
- verificaciones-rendimiento.md - Presupuesto de rendimiento
Patrones Específicos por Categoría
- aterrizaje-saas.md - Patrones de página de aterrizaje SaaS
- panel-app.md - Patrones de UI de panel de control
- comercio-electronico.md - Patrones de producto/ecommerce
- portafolio.md - Patrones de portafolio creativo
- sitio-contenido.md - Patrones de blog/contenido
Scripts
scripts/analyze-project.py— Detectar categoría, tokens actualesscripts/match-design-system.py— Comparar contra la bibliotecascripts/validate-application.py— Puertas de calidadscripts/generate-adaptation.py— Mapear existente al sistema de diseñoscripts/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.