Communitygithub.com

edneymatias/antigravity-laravel-kit

Pensamiento de diseño y toma de decisiones para UI web. Úsalo al diseñar componentes, diseños, esquemas de color, tipografía o al crear interfaces estéticas. Enseña principios, no valores fijos.

¿Qué es antigravity-laravel-kit?

Esta habilidad es una guía completa de principios de diseño frontend que prioriza el pensamiento crítico sobre la memorización y la consulta activa al usuario sobre la suposición automática. Cubre psicología UX, diseño de color, tipografía, efectos visuales y animaciones, proporcionando reglas claras como la Regla de Oro 1.618, la cuadrícula de 8 puntos y la regla 60-30-10 para el color. Su filosofía central es evitar las tendencias genéricas de la IA (como los grids Bento, el glassmorphism y los degradados mesh) y, en su lugar, tomar riesgos calculados basados en el contexto único del proyecto, la audiencia y las restricciones. Incluye una lista detallada de patrones anti-patrón y una guía de proceso de decisión paso a paso, así como archivos de referencia opcionales para profundizar en áreas específicas. Está diseñada para usarse antes de codificar, ideal para desarrolladores que usan asistentes de IA como Claude Code, Cursor o Codex, y se complementa con una auditoría posterior al diseño usando la habilidad `web-design-guidelines`.

Compatible con✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/edneymatias/antigravity-laravel-kit/tree/HEAD/.agent/skills/frontend-design

Preguntar en tu IA favorita

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

Documentación

Sistema de Diseño Frontend

Filosofía: Cada píxel tiene un propósito. La moderación es lujo. La psicología del usuario impulsa las decisiones. Principio central: PIENSA, no memorices. PREGUNTA, no asumas.


🎯 Regla de Lectura Selectiva (OBLIGATORIO)

Lee los archivos REQUERIDOS siempre, los OPCIONALES solo cuando sea necesario:

ArchivoEstadoCuándo Leer
ux-psychology.md🔴 REQUERIDO¡Siempre leer primero!
color-system.md⚪ OpcionalDecisiones de color/paleta
typography-system.md⚪ OpcionalSelección/combinación de fuentes
visual-effects.md⚪ OpcionalGlassmorphism, sombras, degradados
animation-guide.md⚪ OpcionalAnimación necesaria
motion-graphics.md⚪ OpcionalLottie, GSAP, 3D
decision-trees.md⚪ OpcionalPlantillas de contexto

🔴 ux-psychology.md = LÉELO SIEMPRE. Los demás = solo si son relevantes.


🔧 Scripts de Ejecución

Ejecuta estos para auditorías (no leas, solo ejecuta):

ScriptPropósitoUso
Auditoría ManualAuditoría de Psicología UX y AccesibilidadUsa las herramientas de desarrollo del navegador y Lighthouse

⚠️ CRÍTICO: PREGUNTA ANTES DE ASUMIR (OBLIGATORIO)

¡ALTO! Si la solicitud del usuario es abierta, NO recurras a tus favoritos.

Cuando la Pregunta del Usuario es Vaga, PREGUNTA:

¿Color no especificado? Pregunta:

"¿Qué paleta de colores prefieres? (azul/verde/naranja/neutro/otro?)"

¿Estilo no especificado? Pregunta:

"¿Qué estilo buscas? (minimalista/audaz/retro/futurista/orgánico?)"

¿Diseño no especificado? Pregunta:

"¿Tienes preferencia de diseño? (una columna/cuadrícula/asimétrico/ancho completo?)"

⛔ TENDENCIAS POR DEFECTO A EVITAR (PUERTO SEGURO ANTIPATRÓN):

Tendencia por Defecto de IAPor Qué es MalaPiensa en su Lugar
Cuadrículas Bento (Cliché Moderno)Usado en todos los diseños de IA¿Por qué este contenido NECESITA una cuadrícula?
Héroe Dividido (Izquierda/Derecha)Predecible y aburrido¿Qué tal Tipografía Masiva o Narrativa Vertical?
Degradados Mesh/AuroraEl fondo perezoso "nuevo"¿Cuál es una combinación de colores radical?
GlassmorphismLa idea de IA de "premium"¿Qué tal un plano sólido y de alto contraste?
Azul Cian Profundo / FintechPuerto seguro de la prohibición del púrpura¿Por qué no Rojo, Negro o Verde Neón?
"Orquestar / Empoderar"Redacción generada por IA¿Cómo diría esto un humano?
Fondo oscuro + brillo neónSobr utilizado, "aspecto de IA"¿Qué NECESITA realmente la MARCA?
Todo redondeadoGenérico/Seguro¿Dónde puedo usar bordes afilados y brutalistas?

🔴 "Cada estructura 'segura' que elijas te acerca un paso más a una plantilla genérica. ASUME RIESGOS."


1. Análisis de Restricciones (SIEMPRE PRIMERO)

Antes de cualquier trabajo de diseño, RESPONDE ESTAS o PREGUNTA AL USUARIO:

RestricciónPreguntaPor Qué es Importante
Cronograma¿Cuánto tiempo?Determina la complejidad
Contenido¿Listo o marcador de posición?Afecta la flexibilidad del diseño
Marca¿Directrices existentes?Puede dictar colores/fuentes
Tecnología¿Qué stack?Afecta las capacidades
Audiencia¿Quién exactamente?Impulsa todas las decisiones visuales

Audiencia → Enfoque de Diseño

AudienciaPiensa En
Generación ZAudaz, rápido, primero móvil, auténtico
MillennialsLimpio, minimalista, impulsado por valores
Generación XFamiliar, confiable, claro
BoomersLegible, alto contraste, simple
B2BProfesional, centrado en datos, confianza
LujoElegancia contenida, espacio en blanco

2. Principios de Psicología UX

Leyes Fundamentales (Internalízalas)

LeyPrincipioAplicación
Ley de HickMás opciones = decisiones más lentasLimita las opciones, usa divulgación progresiva
Ley de FittsMás grande + más cerca = más fácil de hacer clicTamaña adecuadamente los CTA
Ley de Miller~7 elementos en la memoria de trabajoAgrupa el contenido en fragmentos
Von RestorffDiferente = memorableHaz que los CTA sean visualmente distintos
Posición SerialPrimero/último se recuerda másInformación clave al inicio/final

Niveles de Diseño Emocional

VISCERAL (instantáneo) → Primera impresión: colores, imágenes, sensación general
CONDUCTUAL (uso)       → Usándolo: velocidad, retroalimentación, eficiencia
REFLEXIVO (memoria)   → Después: "Me gusta lo que esto dice de mí"

Construcción de Confianza

  • Indicadores de seguridad en acciones sensibles
  • Prueba social donde sea relevante
  • Acceso claro a contacto/soporte
  • Diseño consistente y profesional
  • Políticas transparentes

3. Principios de Diseño

Proporción Áurea (φ = 1.618)

Úsala para armonía proporcional:
├── Contenido : Barra lateral ≈ 62% : 38%
├── Cada tamaño de encabezado = anterior × 1.618 (para escala dramática)
├── El espaciado puede seguir: sm → md → lg (cada uno × 1.618)

Concepto de Cuadrícula de 8 Puntos

Todo el espaciado y tamaño en múltiplos de 8:
├── Ajustado: 4px (medio paso para micro)
├── Pequeño: 8px
├── Medio: 16px
├── Grande: 24px, 32px
├── XL: 48px, 64px, 80px
└── Ajusta según la densidad del contenido

Principios Clave de Tamaño

ElementoConsideración
Objetos táctilesTamaño de toque cómodo mínimo
BotonesAltura basada en la jerarquía de importancia
EntradasCoincide con la altura del botón para alineación
TarjetasRelleno consistente, transpirable
Ancho de lectura45-75 caracteres óptimo

4. Principios de Color

Regla 60-30-10

60% → Primario/Fondo (base tranquila y neutral)
30% → Secundario (áreas de apoyo)
10% → Acento (CTA, destacados, atención)

Psicología del Color (Para la Toma de Decisiones)

Si Necesitas...Considera TonosEvita
Confianza, calmaFamilia azulRojos agresivos
Crecimiento, naturalezaFamilia verdeGrises industriales
Energía, urgenciaNaranja, rojoAzules pasivos
Lujo, creatividadVerde azulado profundo, Oro, EsmeraldaBrillos de aspecto barato
Limpio, minimalistaNeutrosColor abrumador

Proceso de Selección

  1. ¿Cuál es la industria? (limita las opciones)
  2. ¿Cuál es la emoción? (elige el primario)
  3. ¿Modo claro u oscuro? (establece la base)
  4. PREGUNTA AL USUARIO si no está especificado

Para teoría del color detallada: color-system.md


5. Principios de Tipografía

Selección de Escala

Tipo de ContenidoRelación de EscalaSensación
UI densa1.125-1.2Compacto, eficiente
Web general1.25Equilibrado (más común)
Editorial1.333Legible, espacioso
Héroe/pantalla1.5-1.618Impacto dramático

Concepto de Combinación

Contraste + Armonía:
├── DIFERENTE suficiente para la jerarquía
├── SIMILAR suficiente para la cohesión
└── Generalmente: pantalla + neutral, o serif + sans

Reglas de Legibilidad

  • Longitud de línea: 45-75 caracteres óptimo
  • Altura de línea: 1.4-1.6 para el cuerpo del texto
  • Contraste: Verifica los requisitos WCAG
  • Tamaño: 16px+ para el cuerpo en web

Para tipografía detallada: typography-system.md


6. Principios de Efectos Visuales

Glassmorphism (Cuando sea Apropiado)

Propiedades clave:
├── Fondo semitransparente
├── Desenfoque de fondo
├── Borde sutil para definición
└── ⚠️ **ADVERTENCIA:** El glassmorphism azul/blanco estándar es un cliché moderno. Úsalo de forma radical o no lo uses.

Jerarquía de Sombras

Concepto de elevación:
├── Elementos más altos = sombras más grandes
├── Desplazamiento Y > Desplazamiento X (luz desde arriba)
├── Múltiples capas = más realista
└── Modo oscuro: puede necesitar brillo en su lugar

Uso de Degradados

Degradados armoniosos:
├── Colores adyacentes en la rueda (análogos)
├── O el mismo tono, diferente luminosidad
├── Evita pares complementarios agresivos
├── 🚫 **NO Degradados Mesh/Aurora** (manchas flotantes)
└── VARÍA radicalmente de proyecto a proyecto

Para la guía completa de efectos: visual-effects.md


7. Principios de Animación

Concepto de Tiempo

Duración basada en:
├── Distancia (más lejos = más largo)
├── Tamaño (más grande = más lento)
├── Importancia (crítico = claro)
└── Contexto (urgente = rápido, lujo = lento)

Selección de Curvas de Aceleración

AcciónCurvaPor Qué
EntradaSalida suaveDesacelerar, asentarse
SalidaEntrada suaveAcelerar, salir
ÉnfasisEntrada-salida suaveSuave, deliberado
JuguetónReboteDivertido, enérgico

Rendimiento

  • Anima solo transform y opacity
  • Respeta la preferencia de movimiento reducido
  • Prueba en dispositivos de gama baja

Para patrones de animación: animation-guide.md, para avanzados: motion-graphics.md


8. Lista de Verificación "Factor WOW"

Indicadores Premium

  • Espacio en blanco generoso (lujo = espacio para respirar)
  • Profundidad y dimensión sutiles
  • Animaciones suaves y con propósito
  • Atención al detalle (alineación, consistencia)
  • Ritmo visual cohesivo
  • Elementos personalizados (no todos por defecto)

Constructores de Confianza

  • Señales de seguridad donde corresponda
  • Prueba social / testimonios
  • Propuesta de valor clara
  • Imágenes profesionales
  • Lenguaje de diseño consistente

Desencadenantes Emocionales

  • Héroe que evoca la emoción deseada
  • Elementos humanos (rostros, historias)
  • Indicadores de progreso/logro
  • Momentos de deleite

9. Antipatrones (Lo que NO Hacer)

❌ Indicadores de Diseño Perezoso

  • Fuentes predeterminadas del sistema sin consideración
  • Imágenes de stock que no coinciden
  • Espaciado inconsistente
  • Demasiados colores que compiten
  • Muros de texto sin jerarquía
  • Contraste inaccesible

❌ Patrones de Tendencia de IA (¡EVITAR!)

  • Los mismos colores en cada proyecto
  • Oscuro + neón como predeterminado
  • Púrpura/violeta en todo (PROHIBICIÓN DE PÚRPURA ✅)
  • Cuadrículas Bento para páginas de aterrizaje simples
  • Degradados Mesh y Efectos de Brillo
  • Misma estructura de diseño / clon de Vercel
  • No preguntar las preferencias del usuario

❌ Patrones Oscuros (No Éticos)

  • Costos ocultos
  • Urgencia falsa
  • Acciones forzadas
  • UI engañosa
  • Confirmshaming

10. Resumen del Proceso de Decisión

Para CADA tarea de diseño:

1. RESTRICCIONES
   └── ¿Cuál es el cronograma, la marca, la tecnología, la audiencia?
   └── Si no está claro → PREGUNTA

2. CONTENIDO
   └── ¿Qué contenido existe?
   └── ¿Cuál es la jerarquía?

3. DIRECCIÓN DE ESTILO
   └── ¿Qué es apropiado para el contexto?
   └── Si no está claro → PREGUNTA (¡no recurras a lo predeterminado!)

4. EJECUCIÓN
   └── Aplica los principios anteriores
   └── Revisa contra los antipatrones

5. REVISIÓN
   └── "¿Esto sirve al usuario?"
   └── "¿Es esto diferente de mis valores predeterminados?"
   └── "¿Estaría orgulloso de esto?"

Archivos de Referencia

Para orientación más profunda en áreas específicas:


Habilidades Relacionadas

HabilidadCuándo Usarla
frontend-design (esta)Antes de codificar - Aprende principios de diseño (color, tipografía, psicología UX)
web-design-guidelinesDespués de codificar - Audita por accesibilidad, rendimiento y mejores prácticas

Flujo de Trabajo Post-Diseño

Después de implementar tu diseño, ejecuta la auditoría:

1. DISEÑO    → Lee los principios de frontend-design ← ESTÁS AQUÍ
2. CÓDIGO    → Implementa el diseño
3. AUDITORÍA → Ejecuta la revisión de web-design-guidelines
4. CORREGIR  → Aborda los hallazgos de la auditoría

Próximo paso: Después de codificar, usa la habilidad web-design-guidelines para auditar tu implementación en busca de accesibilidad, estados de enfoque, animaciones y problemas de rendimiento.


Recuerda: El diseño es PENSAR, no copiar. Cada proyecto merece una consideración fresca basada en su contexto y usuarios únicos. ¡Evita el Puerto Seguro Moderno de SaaS!

Skills relacionados