Communitygithub.com

coastdigitalgroup/coastai-skills

Diseña e implementa un marco sistemático para eventos cronológicos y registros de actividad, gestionando el ritmo espacial, la agrupación de eventos y la visualización de estados.

¿Qué es coastai-skills?

Este skill proporciona un marco de trabajo sistemático para diseñar líneas de tiempo, cronologías y registros de actividad en interfaces de usuario. Su objetivo es ayudar a desarrolladores y diseñadores a crear visualizaciones temporales claras, escaneables y accesibles, como feeds de actividad en paneles SaaS, hojas de ruta de productos, historiales de pedidos o líneas de tiempo de hitos corporativos. El sistema enfatiza el equilibrio entre la densidad de información y el ritmo espacial, guiando la definición de un 'hilo temporal', nodos visuales (marcadores), agrupación de eventos por períodos y adaptación responsiva (de escritorio a móvil). Incluye reglas de decisión claras (por ejemplo, no romper el hilo a menos que haya un vacío lógico), restricciones de accesibilidad (uso de listas semánticas, `aria-label` y `aria-live` para feeds en tiempo real) y criterios de validación. Evita patrones comunes como la sobrecarga de información o la alineación inconsistente, y distingue cuándo no usar esta skill (por ejemplo, para progreso lineal paso a paso o datos puramente tabulares).

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

Preguntar en tu IA favorita

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

Documentación

Sistema de Línea de Tiempo de Actividad

Propósito

El Sistema de Línea de Tiempo de Actividad proporciona una metodología para diseñar secuencias cronológicas de eventos, registros históricos u hojas de ruta. Garantiza que los usuarios puedan rastrear el progreso, comprender relaciones temporales y escanear datos históricos de manera eficiente. Este sistema equilibra la densidad de información con el ritmo espacial, asegurando que la narrativa de "cuándo" y "qué" sea clara en todos los puntos de vista.

Casos de Uso

  • Diseñar feeds de actividad para paneles SaaS (por ejemplo, historial de proyectos).
  • Estructurar hojas de ruta de productos o notas de versión.
  • Organizar la historia de la empresa o hitos de "Acerca de Nosotros".
  • Implementar seguimiento de pedidos o historial de envíos para comercio electrónico.
  • Gestionar visualizaciones de procesos de múltiples etapas (por ejemplo, estado de solicitud).

Cuándo NO Usar

  • Progreso Lineal de Pasos: Para una secuencia simple de pasos que el usuario debe completar en tiempo real, use step-progress-system.
  • Datos Puramente Tabulares: Si el objetivo principal es ordenar y filtrar por muchas columnas (por ejemplo, un registro de auditoría financiera completo), use data-table-ui-system.
  • Navegación Global: Para la estructura de todo el sitio, use site-navigation-system.
  • Feeds de Blog Simples: Donde las tarjetas estándar en una cuadrícula o lista son suficientes sin un "hilo" visual o marcadores temporales.

Entradas

  1. Inventario de Eventos: La lista de eventos, marcas de tiempo y metadatos asociados.
  2. Resolución Temporal: ¿Al usuario le importan segundos, días o años?
  3. Tipos de Eventos: Categorización de eventos (por ejemplo, Info, Éxito, Advertencia, Error, o Hito vs. Acción Menor).
  4. Restricciones Espaciales: ¿La línea de tiempo vivirá en una barra lateral, una vista de página completa o una tarjeta estrecha?
  5. Tokens de Marca: Colores, escalas tipográficas y tokens de espaciado.

Salidas

  1. Especificación de Anatomía de Línea de Tiempo: Definición del "Hilo" (la línea vertical/horizontal), los "Nodos" (los marcadores) y los "Bloques de Contenido".
  2. Estrategia de Agrupación: Reglas para agrupar eventos (por ejemplo, "Hoy", "Ayer", "Octubre 2023").
  3. Matriz de Estado y Situación: Tratamientos visuales para diferentes tipos de eventos y estados interactivos.
  4. Plano Responsivo: Cómo se adapta la línea de tiempo desde un diseño centrado o alternado a una vista de columna única en móvil.

Flujo de Trabajo

1. Definir el Hilo Temporal y la Orientación

Determine la dirección del tiempo:

  • Vertical (Estándar): Mejor para longitudes de contenido variables e historias largas.
  • Horizontal: Mejor para hojas de ruta de alto nivel o procesos cortos donde el espacio horizontal es abundante.

Establezca el "Hilo" (la línea que conecta los eventos) y asegúrese de que tenga un peso visual y color consistentes (generalmente un tono neutro apagado).

2. Establecer Nodos y Marcadores de Eventos

Diseñe los anclajes visuales para cada evento:

  • Nodos Simples: Pequeños puntos o círculos para acciones menores.
  • Nodos Icónicos: Iconos dentro de círculos para indicar tipos de eventos (por ejemplo, una marca de verificación para "Completado").
  • Marcadores de Fecha: Etiquetas que flotan junto a o encima de los nodos.

3. Aplicar Ritmo Espacial y Agrupación

Evite el desorden visual agrupando eventos por períodos de tiempo:

  • Agrupación Relativa: "Justo ahora", "Hace 2 horas".
  • Agrupación Absoluta: "Lunes, 23 Oct", "Septiembre 2023".

Use el fluid-spacing-system para mantener espacios verticales consistentes entre eventos. Los hitos de alta prioridad deben tener más espacio en blanco que los elementos de actividad menores.

4. Organizar el Bloque de Contenido

Aplique el visual-hierarchy-system al contenido adyacente a cada nodo:

  • Título: La acción central o el nombre del evento.
  • Metadatos: Marca de tiempo, actor (avatar/nombre de usuario) y categoría.
  • Cuerpo/Descripción: Detalles opcionales o contenido expandido.
  • Acciones: Botones contextuales (por ejemplo, "Ver Detalles", "Deshacer").

5. Planificar la Adaptación Responsiva

  • Diseño Alternado (Patrón Z): En escritorio, los eventos alternan izquierda y derecha del hilo. En móvil, colapsar a una columna única (Hilo a la izquierda, Contenido a la derecha).
  • Diseño de Un Solo Lado: Estandarizar en "Hilo-Izquierda, Contenido-Derecha" para móvil para maximizar la legibilidad.

Reglas de Decisión

  • La Regla del "Hilo": La línea nunca debe romperse a menos que haya un vacío lógico en el tiempo o una acción de "Cargar Más".
  • Umbral de Agrupación: Si más de 5 eventos ocurren dentro del mismo día, agrúpelos bajo un solo encabezado de fecha para reducir texto redundante.
  • La Jerarquía del "Nodo": Use nodos más grandes o colores de marca para "Hitos" y nodos más pequeños y neutros para "Actividades".
  • Posición de la Marca de Tiempo: Para líneas de tiempo verticales, coloque las marcas de tiempo a la izquierda del hilo (escritorio) o inmediatamente debajo del título (móvil) para el escaneo más rápido.

Restricciones

  • Accesibilidad: Las líneas de tiempo deben ser navegables como una lista (<ul> o <ol>). Los nodos que contienen iconos deben tener aria-label o texto oculto para lectores de pantalla. Envuelva las marcas de tiempo en un elemento <time datetime="..."> para que las etiquetas relativas ("Hace 2 horas") sigan siendo legibles por máquina. Para feeds de actividad que se actualizan en vivo, agregue nuevas entradas dentro de una región aria-live="polite" (no toda la lista) para que los usuarios de lectores de pantalla escuchen nuevos eventos sin perder su lugar.
  • Responsividad: Las líneas de tiempo nunca deben desbordar el viewport. Las líneas de tiempo horizontales deben cambiar a verticales o usar un desplazamiento horizontal en móvil.
  • Contraste Visual: El hilo y los nodos deben cumplir con una relación de contraste de 3:1 contra el fondo.

Patrones de Falla Comunes

  • Hilos Rotos: La línea vertical comienza y termina arbitrariamente, dificultando seguir la secuencia.
  • Sobrecarga de Información: Incluir demasiado texto del cuerpo en cada evento, convirtiendo la línea de tiempo en un muro de texto.
  • Alineación Inconsistente: Mezclar texto centrado y alineado a la izquierda dentro de la misma línea de tiempo sin una lógica clara.
  • Apretujamiento en Móvil: Intentar mantener un diseño alternado (izquierda/derecha) en móvil, dejando columnas diminutas para el texto.

Criterios de Validación

  • Los eventos siguen un orden cronológico claro y consistente (Ascendente o Descendente).
  • Los marcadores visuales (nodos) y el hilo de conexión están estilizados de manera consistente.
  • La agrupación temporal (por ejemplo, "Hoy") se utiliza para reducir la carga cognitiva.
  • El comportamiento responsivo (por ejemplo, colapsar a una columna única) está definido y es funcional.
  • Accesibilidad: La línea de tiempo está marcada como una lista semántica, y las marcas de tiempo usan <time datetime="...">.
  • Los feeds en tiempo real anuncian nuevas entradas a través de una región aria-live="polite" con ámbito sin interrumpir el foco del lector de pantalla.
  • Los hitos principales son visualmente distintos de la actividad secundaria.

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