Communitygithub.com

coastdigitalgroup/coastai-skills

Diseña e implementa un marco sistemático para el movimiento funcional en interfaces, definiendo duraciones, curvas de suavizado y coreografía para mejorar la usabilidad, la retroalimentación y los modelos mentales espaciales.

¿Qué es coastai-skills?

Este skill proporciona una metodología completa para diseñar "movimiento funcional" en interfaces de usuario, más allá de la animación decorativa. Establece un sistema de duraciones, curvas de suavizado y coreografía que ayuda a los usuarios a comprender relaciones espaciales, proporciona retroalimentación sobre acciones y reduce la carga cognitiva durante cambios de contexto. Es compatible con cualquier plataforma (web, móvil, escritorio) y se integra mediante tokens de diseño y reglas CSS predefinidas. El skill guía a los desarrolladores paso a paso: desde la creación de una escala de duraciones y una paleta de curvas de Bezier, hasta el diseño de secuencias coreografiadas y la planificación de la accesibilidad con `prefers-reduced-motion`. También incluye reglas de decisión (como `Funcional primero`), restricciones de rendimiento (solo animar `transform` y `opacity` para 60fps), y criterios de validación para garantizar consistencia y usabilidad. Ideal para equipos que construyen librerías de componentes, sistemas de diseño o aplicaciones con transiciones complejas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/interface-motion-system

Preguntar en tu IA favorita

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

Documentación

Sistema de Movimiento de Interfaz

Propósito

El Sistema de Movimiento de Interfaz proporciona una metodología para diseñar "movimiento funcional" — movimiento que cumple un propósito específico en la interfaz de usuario. Va más allá de la animación decorativa para establecer un sistema de duraciones, curvas de suavizado y coreografía que ayuda a los usuarios a comprender relaciones espaciales, proporciona retroalimentación para las acciones y reduce la carga cognitiva durante los cambios de contexto.

Casos de Uso

  • Definir tiempos de transición y curvas estándar para una librería de UI.
  • Diseñar cambios de diseño complejos (ej., expandir una tarjeta a pantalla completa).
  • Establecer movimientos de retroalimentación para acciones del usuario (ej., marcas de verificación de éxito, spinners de carga).
  • Coreografiar la entrada y salida de capas de UI (Modales, Cajones, Notificaciones).
  • Usar movimiento para guiar la atención hacia un elemento o cambio específico.

Cuándo NO Usar

  • Estética de Marca Estática Only: Cuando el estilo visual evita intencionalmente el movimiento para transmitir un tono específico (ej., diseños minimalistas, brutalistas o "similares al papel").
  • "Relleno" Puramente Decorativo: Animaciones que no agregan valor funcional y distraen al usuario de su tarea principal (ej., elementos de fondo que se mueven sin interacción).
  • Entornos de Alta Latencia: Donde el costo de rendimiento de renderizar movimiento supera el beneficio de UX, provocando "tirones" o retrasos.

Entradas

  1. Personalidad de Marca: ¿El movimiento es "Ágil/Productivo" (rápido, lineal) o "Natural/Fluido" (elástico, suave, orgánico)?
  2. Contexto de Interacción: ¿Qué se está moviendo? (Elemento atómico, contenedor o página completa).
  3. Tipo de Disparador: ¿El movimiento es activado por el sistema (Carga), el usuario (Clic/Desplazamiento) o el entorno (Scroll)?
  4. Capacidades de la Plataforma: Restricciones técnicas de los navegadores o dispositivos de destino.

Salidas

  1. Escala de Duración: Un conjunto de tokens de tiempo estandarizados (ej., motion-fast, motion-standard, motion-slow).
  2. Paleta de Suavizado: Un conjunto definido de curvas Bezier para diferentes intenciones de movimiento (ej., ease-in, ease-out, emphasized).
  3. Reglas de Coreografía: Estándares para cómo los elementos entran, salen y se mueven en relación entre sí.
  4. Especificación de Tokens de Movimiento: Documentación de variables de movimiento para desarrolladores.

Flujo de Trabajo

1. Establecer la Escala de Duración

Crea una progresión lógica de tiempos basada en el tamaño del cambio:

  • Rápido (100–150ms): Para micro-interacciones y estados atómicos (Hover, Toggle, Activo).
  • Estándar (200–300ms): Para transiciones medianas (Desplegables, Tooltips, Expansiones pequeñas).
  • Lento (350–500ms): Para cambios de diseño grandes o transiciones inmersivas (Modales, cambios a nivel de página).

2. Definir las Curvas de Suavizado

Asigna significado semántico a diferentes curvas Bezier:

  • Estándar (Ease-in-out): Para elementos que se mueven de un punto a otro dentro del viewport.
  • Entrada (Ease-out): Para elementos que aparecen o entran al viewport (comienzan rápido, terminan lento para sentirse receptivos).
  • Salida (Ease-in): Para elementos que desaparecen o salen del viewport (comienzan lento, terminan rápido para sentirse con propósito).
  • Enfatizado (Complejo): Una curva personalizada (ej., cubic-bezier(0.4, 0, 0.2, 1)) para transiciones primarias que deben sentirse de alta calidad.

3. Diseñar para Modelos Mentales Espaciales

Usa el movimiento para explicar de dónde viene un elemento y hacia dónde va:

  • Continuidad Direccional: Si un cajón se desliza desde la derecha, debe salir hacia la derecha.
  • Relación Padre-Hijo: Un elemento hijo (como un menú) idealmente debería originarse de su padre (el botón).

4. Coreografiar Secuencias (Escalonamiento)

Cuando varios elementos aparecen a la vez, evita el efecto "Pop-in":

  • Escalonamiento: Introduce elementos con un ligero retraso (20–50ms) entre cada uno para guiar el ojo en un orden específico.
  • Escalonamiento Direccional: Escalonea los elementos en la dirección de lectura (de arriba a abajo o de izquierda a derecha).

5. Planificar para Accesibilidad (Movimiento Reducido)

El movimiento debe ser inclusivo:

  • La Verificación "Pre-vuelo": Siempre define un fallback para usuarios que tienen "Reducir Movimiento" activado a nivel de sistema operativo.
  • Visuales Alternativas: Reemplaza el movimiento con desvanecimientos de opacidad o sin animación cuando prefers-reduced-motion esté activo.

Reglas de Decisión

  • La Regla "Funcional Primero": Si no puedes explicar qué comunica un movimiento al usuario, elimínalo.
  • Tiempos Responsivos: Las duraciones deben ser más cortas en pantallas pequeñas (móvil) porque la distancia física que recorre un elemento es menor.
  • Velocidad sobre Fluidez para Acción: La retroalimentación de interacción (ej., un clic en un botón) debe sentirse instantánea (<100ms) incluso si la transición resultante es más larga.
  • Sin Bucles Infinitos: Evita animaciones en bucle continuo (spinners, pulsos) a menos que representen un estado activo que bloquea el fondo.

Restricciones

  • Accesibilidad: Debe respetar prefers-reduced-motion. El movimiento no debe desencadenar convulsiones (evita parpadeos rápidos o patrones de alta frecuencia a gran escala).
  • Rendimiento: Limítate a propiedades "Solo Compositor" (transform y opacity) para garantizar 60fps. Evita animar width, height o margin.
  • Consistencia: Usa la misma duración y suavizado para el mismo tipo de componente en todo el sitio.

Patrones de Falla Comunes

  • La Trampa del "Mareo por Movimiento": Usar movimientos amplios y abarcadores (ej., la página entera deslizándose) que causan malestar vestibular.
  • Interfaces Lentas: Establecer duraciones demasiado largas (ej., 1 segundo para un menú), haciendo que el usuario espere y que el sitio se sienta roto.
  • Movimiento Lineal: Usar suavizado "linear", que se siente mecánico y antinatural en comparación con la aceleración/desaceleración del mundo físico.
  • Dirección Confusa: Un modal que "crece" desde el centro pero "se desliza" hacia abajo al salir, rompiendo el modelo espacial del usuario.
  • El Efecto "Temblor": Escalonar elementos con retrasos demasiado largos, haciendo que la página se sienta como si estuviera cargando lentamente.

Criterios de Validación

  • Cada transición tiene un token de Duración y Suavizado definido.
  • Las duraciones son proporcionales al tamaño de la transición (Rápido para pequeño, Lento para grande).
  • El movimiento respalda un modelo mental espacial claro (Entrada/Salida lógica).
  • Se usa escalonamiento para revelaciones de múltiples elementos para guiar el ojo.
  • Accesibilidad: prefers-reduced-motion se aborda con una estrategia de simplificación clara.
  • Rendimiento: Solo se usan transform y opacity para animaciones frecuentes.
  • El movimiento de retroalimentación (ej., clic en botón) comienza en <100ms.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills relacionados