Communitygithub.com

David-Li0406/meta-skill-evloving

Animaciones CSS, transiciones y efectos basados en desplazamiento con accesibilidad (prefers-reduced-motion). Úsalo al agregar movimiento, efectos hover, estados de carga o animaciones de desplazamiento.

¿Qué es meta-skill-evloving?

Este skill proporciona una guía completa y accesible para implementar animaciones y transiciones en CSS, priorizando el respeto a las preferencias de movimiento del usuario (`prefers-reduced-motion`) y el rendimiento (evitando jank y layout thrashing). Es ideal para desarrolladores que trabajan con agentes como Claude Code o Cursor, ya que ofrece patrones claros y reutilizables. El skill cubre desde transiciones simples hasta animaciones basadas en el desplazamiento (scroll-driven), micro-interacciones y la API de View Transitions, todo ejemplificado con código CSS listo para copiar. Su utilidad radica en que promueve un enfoque de 'movimiento reducido primero', garantizando que las animaciones sean un realce progresivo y no una barrera para usuarios con sensibilidades vestibulares u otras discapacidades. Además, incluye una lista de verificación final y una filosofía clara sobre el propósito del movimiento, asegurando que cualquier implementación sea intencionada, respetuosa y sutil.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/skill-flow/data/skills-refined-36k/skillsmp/animation-motion

Preguntar en tu IA favorita

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

Documentación

Skill de Animación y Movimiento

Este skill cubre animaciones y transiciones CSS con un enfoque en accesibilidad (respetando las preferencias de movimiento del usuario) y rendimiento (evitando jank y layout thrashing).

Relacionado: Para patrones interactivos solo con CSS (pestañas, acordeones, alternadores sin JavaScript), consulta el skill progressive-enhancement.

Filosofía

El movimiento debe ser:

  1. Intencionado - Guía la atención, muestra relaciones, proporciona retroalimentación
  2. Respetuoso - Honra las preferencias de prefers-reduced-motion
  3. Eficiente - Usa propiedades solo del compositor cuando sea posible
  4. Sutil - Mejora, no distrae ni abruma

Movimiento Reducido Primero

Siempre empieza con movimiento reducido como predeterminado, luego agrega movimiento para usuarios que no hayan optado por no tenerlo.

El Patrón

/* Base: sin movimiento (predeterminado de movimiento reducido) */
.element {
  transition: none;
}

/* Agrega movimiento solo cuando el usuario no ha solicitado movimiento reducido */
@media (prefers-reduced-motion: no-preference) {
  .element {
    transition: transform 0.3s ease, opacity 0.3s ease;
  }
}

¿Por Qué Movimiento Reducido Primero?

EnfoqueProblema
Movimiento primero, luego eliminarLos usuarios ven un destello de movimiento antes de que se aplique la media query
Reducido primero, luego agregarPredeterminado seguro, el movimiento es una mejora progresiva

Respetando las Preferencias del Usuario

La Media Query prefers-reduced-motion

/* El usuario prefiere movimiento reducido */
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

Movimiento Reducido Granular

En lugar de eliminar todo el movimiento, proporciona alternativas:

/* Animación completa para usuarios sin preferencia */
@media (prefers-reduced-motion: no-preference) {
  .card {
    transition: transform 0.3s ease, box-shadow 0.3s ease;
  }

  .card:hover {
    transform: translateY(-4px);
    box-shadow: var(--shadow-lg);
  }
}

/* Alternativa sutil para movimiento reducido */
@media (prefers-reduced-motion: reduce) {
  .card {
    transition: box-shadow 0.15s ease;
  }

  .card:hover {
    box-shadow: var(--shadow-md);
  }
}

Detección con JavaScript

const prefersReducedMotion = window.matchMedia(
  '(prefers-reduced-motion: reduce)'
).matches;

if (prefersReducedMotion) {
  // Usa transiciones instantáneas o salta animaciones
  element.style.transition = 'none';
} else {
  // Animación completa
  element.animate(keyframes, options);
}

Propiedades Seguras para el Rendimiento

Propiedades Solo del Compositor (Rápidas)

Estas propiedades se pueden animar sin activar layout o paint:

PropiedadUso
transformMovimiento, escalado, rotación
opacityFundido de entrada/salida
filterDesenfoque, brillo (acelerado por GPU)
/* BUENO: Solo compositor */
.card:hover {
  transform: translateY(-4px) scale(1.02);
  opacity: 0.9;
}

Propiedades a Evitar Animar

Estas activan costosos recálculos de layout:

PropiedadProblema
width, heightRecalculo de layout
top, left, right, bottomRecalculo de layout
margin, paddingRecalculo de layout
border-widthRecalculo de layout
font-sizeLayout + reflujo de texto
/* MALO: Activa layout */
.card:hover {
  margin-top: -4px;  /* Layout thrashing */
  height: 110%;      /* Layout thrashing */
}

/* BUENO: Usa transform en su lugar */
.card:hover {
  transform: translateY(-4px) scaleY(1.1);
}

Promover a Capa de Compositor

Usa will-change con moderación para animaciones conocidas:

/* Úsalo solo para elementos que SÍ van a animar */
.animated-element {
  will-change: transform, opacity;
}

/* Elimínalo después de que la animación termine */
.animated-element.animation-done {
  will-change: auto;
}

Advertencia: No apliques will-change a muchos elementos: consume memoria.


Patrones de Transición

Integración con Tokens de Diseño

:root {
  /* Escala de duración */
  --duration-instant: 0.1s;
  --duration-fast: 0.15s;
  --duration-normal: 0.3s;
  --duration-slow: 0.5s;

  /* Funciones de easing */
  --ease-out: cubic-bezier(0, 0, 0.2, 1);
  --ease-in: cubic-bezier(0.4, 0, 1, 1);
  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
  --ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);
}

Transiciones Comunes

/* Efecto de elevación al hacer hover */
@media (prefers-reduced-motion: no-preference) {
  .card {
    transition:
      transform var(--duration-fast) var(--ease-out),
      box-shadow var(--duration-fast) var(--ease-out);
  }

  .card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow-md);
  }
}

/* Anillo de enfoque */
@media (prefers-reduced-motion: no-preference) {
  button {
    transition: outline-offset var(--duration-instant) var(--ease-out);
  }

  button:focus-visible {
    outline: 2px solid var(--focus-color);
    outline-offset: 2px;
  }
}

/* Fundido de entrada */
@media (prefers-reduced-motion: no-preference) {
  .fade-in {
    animation: fadeIn var(--duration-normal) var(--ease-out);
  }
}

@keyframes fadeIn {
  from { opacity: 0; }
  to { opacity: 1; }
}

Patrones de Animación

Animaciones con Keyframes

/* Pulso sutil para llamar la atención */
@keyframes pulse {
  0%, 100% { transform: scale(1); }
  50% { transform: scale(1.05); }
}

@media (prefers-reduced-motion: no-preference) {
  .notification-badge {
    animation: pulse 2s var(--ease-in-out) infinite;
  }
}

/* Alternativa de movimiento reducido: sin animación */
@media (prefers-reduced-motion: reduce) {
  .notification-badge {
    animation: none;
  }
}

Spinners de Carga

/* Spinner que respeta el movimiento reducido */
@keyframes spin {
  to { transform: rotate(360deg); }
}

.spinner {
  width: 24px;
  height: 24px;
  border: 2px solid var(--border-color);
  border-top-color: var(--primary-color);
  border-radius: 50%;
}

@media (prefers-reduced-motion: no-preference) {
  .spinner {
    animation: spin 1s linear infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  .spinner {
    /* Indicador estático u opacidad pulsante */
    animation: none;
    border-style: dotted;
  }
}

Carga con Esqueleto

@keyframes shimmer {
  0% { background-position: -200% 0; }
  100% { background-position: 200% 0; }
}

.skeleton {
  background: linear-gradient(
    90deg,
    var(--surface-color) 25%,
    var(--background-alt) 50%,
    var(--surface-color) 75%
  );
  background-size: 200% 100%;
}

@media (prefers-reduced-motion: no-preference) {
  .skeleton {
    animation: shimmer 1.5s infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  .skeleton {
    animation: none;
    background: var(--background-alt);
  }
}

Animaciones de Entrada

Fundido y Deslizamiento

@keyframes fadeSlideUp {
  from {
    opacity: 0;
    transform: translateY(10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@media (prefers-reduced-motion: no-preference) {
  .animate-in {
    animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
  }

  /* Hijos escalonados */
  .animate-in > * {
    animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
  }

  .animate-in > *:nth-child(1) { animation-delay: 0ms; }
  .animate-in > *:nth-child(2) { animation-delay: 50ms; }
  .animate-in > *:nth-child(3) { animation-delay: 100ms; }
  .animate-in > *:nth-child(4) { animation-delay: 150ms; }
}

@media (prefers-reduced-motion: reduce) {
  .animate-in,
  .animate-in > * {
    animation: none;
    opacity: 1;
    transform: none;
  }
}

Escalado de Entrada

@keyframes scaleIn {
  from {
    opacity: 0;
    transform: scale(0.9);
  }
  to {
    opacity: 1;
    transform: scale(1);
  }
}

@media (prefers-reduced-motion: no-preference) {
  dialog[open] {
    animation: scaleIn var(--duration-fast) var(--ease-out);
  }
}

API de View Transitions

Para transiciones de página (mejora progresiva):

/* Habilitar view transitions */
@view-transition {
  navigation: auto;
}

/* Fundido cruzado predeterminado */
::view-transition-old(root),
::view-transition-new(root) {
  animation-duration: var(--duration-normal);
}

/* Respetar movimiento reducido */
@media (prefers-reduced-motion: reduce) {
  ::view-transition-old(root),
  ::view-transition-new(root) {
    animation-duration: 0.01ms;
  }
}

/* Transiciones nombradas para elementos específicos */
.hero-image {
  view-transition-name: hero;
}

::view-transition-old(hero),
::view-transition-new(hero) {
  animation-duration: var(--duration-slow);
}

Animaciones Basadas en Desplazamiento

Animaciones CSS modernas basadas en desplazamiento (mejora progresiva):

/* Fundido de entrada al desplazarse */
@keyframes fadeInOnScroll {
  from { opacity: 0; transform: translateY(20px); }
  to { opacity: 1; transform: translateY(0); }
}

@media (prefers-reduced-motion: no-preference) {
  .scroll-reveal {
    animation: fadeInOnScroll linear both;
    animation-timeline: view();
    animation-range: entry 0% entry 100%;
  }
}

@media (prefers-reduced-motion: reduce) {
  .scroll-reveal {
    opacity: 1;
    transform: none;
  }
}

Micro-interacciones

Presión de Botón

@media (prefers-reduced-motion: no-preference) {
  button {
    transition: transform var(--duration-instant) var(--ease-out);
  }

  button:active {
    transform: scale(0.98);
  }
}

Interruptor de Alternancia

.toggle-track {
  width: 44px;
  height: 24px;
  background: var(--surface-color);
  border-radius: 12px;
}

.toggle-thumb {
  width: 20px;
  height: 20px;
  background: white;
  border-radius: 50%;
  transform: translateX(2px);
}

@media (prefers-reduced-motion: no-preference) {
  .toggle-thumb {
    transition: transform var(--duration-fast) var(--ease-out);
  }
}

.toggle-input:checked + .toggle-track .toggle-thumb {
  transform: translateX(22px);
}

Marca de Casilla de Verificación

.checkbox-icon {
  stroke-dasharray: 24;
  stroke-dashoffset: 24;
}

@media (prefers-reduced-motion: no-preference) {
  .checkbox-icon {
    transition: stroke-dashoffset var(--duration-fast) var(--ease-out);
  }
}

.checkbox-input:checked + .checkbox-box .checkbox-icon {
  stroke-dashoffset: 0;
}

Guías de Duración de Animación

Tipo de AnimaciónDuraciónRazón
Micro-interacción100-150msRetroalimentación inmediata
Transición simple150-300msNotable pero rápida
Animación compleja300-500msTiempo para seguir
Transición de página300-500msCambio de contexto
Indicador de carga1000-2000msUn ciclo visible

La Regla de los 100ms

Los usuarios perciben las acciones como instantáneas si la respuesta es inferior a 100ms. Úsala para:

  • Estados activos de botones
  • Indicadores de enfoque
  • Interruptores de alternancia

Patrones Peligrosos a Evitar

Desencadenantes Vestibulares

Estos pueden causar mareos por movimiento o convulsiones:

PatrónProblemaAlternativa
Desplazamiento parallaxProblemas vestibularesParallax estático o sutil
Video con reproducción automáticaMovimiento inesperadoReproducir al interactuar
Parpadeo (>3Hz)Riesgo de convulsionesSin parpadeo
Zoom grandeProblemas vestibularesTransiciones de fundido
Giro/rotaciónDesorientaciónFundido o deslizamiento
/* MALO: Parallax agresivo */
.parallax {
  transform: translateY(calc(var(--scroll) * 0.5));
}

/* MEJOR: Sutil o desactivado con movimiento reducido */
@media (prefers-reduced-motion: reduce) {
  .parallax {
    transform: none;
  }
}

Animaciones Infinitas

/* MALO: Movimiento constante */
.attention-seeker {
  animation: bounce 1s infinite;
}

/* MEJOR: Iteraciones limitadas */
.attention-seeker {
  animation: bounce 1s 3; /* Solo 3 veces */
}

/* MEJOR: Activar al interactuar */
.attention-seeker:hover {
  animation: bounce 0.5s;
}

Lista de Verificación para Pruebas

DevTools del Navegador

  1. Chrome: Rendering > Emulate CSS media feature > prefers-reduced-motion: reduce
  2. Firefox: about:config > ui.prefersReducedMotion (0=no-preference, 1=reduce)
  3. Safari: Develop > Experimental Features > Reduced Motion

Configuración del Sistema

  • macOS: Preferencias del Sistema > Accesibilidad > Pantalla > Reducir movimiento
  • iOS: Configuración > Accesibilidad > Movimiento > Reducir Movimiento
  • Windows: Configuración > Acceso Fácil > Pantalla > Mostrar animaciones
  • Android: Configuración > Accesibilidad > Eliminar animaciones

Lista de Verificación

Al agregar animaciones o transiciones:

  • Se respeta prefers-reduced-motion
  • El movimiento reducido tiene una alternativa significativa (no solo desactivado)
  • Solo se animan propiedades del compositor (transform, opacity)
  • will-change se usa con moderación y se elimina después de la animación
  • Los tokens de duración se usan de manera consistente
  • No hay contenido parpadeante (>3 parpadeos por segundo)
  • Las animaciones infinitas tienen un propósito y se pueden detener
  • Parallax y movimientos grandes son mejoras opcionales
  • Los estados de carga funcionan sin animación
  • La animación mejora en lugar de distraer

Skills Relacionados

  • css-author - Organización moderna de CSS con @import nativo, @layer en cascada...
  • progressive-enhancement - Desarrollo primero en HTML con patrones interactivos solo con CSS
  • performance - Escribe páginas HTML amigables con el rendimiento
  • accessibility-checker - Asegura el cumplimiento de WCAG2AA

Individual skills in this repo

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

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

Skills relacionados