Communitygithub.com

David-Li0406/meta-skill-evloving

Animations CSS, transitions et effets pilotés par le défilement, avec accessibilité (prefers-reduced-motion). À utiliser pour ajouter du mouvement, des effets de survol, des états de chargement ou des animations basées sur le défilement.

Qu'est-ce que meta-skill-evloving ?

Cette compétence couvre les animations et transitions CSS en mettant l'accent sur l'accessibilité (respect des préférences de mouvement de l'utilisateur) et la performance (éviter les saccades et les recalculs de mise en page). Elle fournit des motifs concrets pour implémenter des animations respectueuses des préférences de mouvement avec la requête média `prefers-reduced-motion`, en commençant toujours par une base sans mouvement comme valeur par défaut. Elle détaille les propriétés performantes (compositor-only) à utiliser (`transform`, `opacity`, `filter`) et celles à éviter (`width`, `height`, `top`, etc.), ainsi que des motifs pour les micro-interactions, les animations d'entrée, les spinners de chargement, et les squelettes. La compétence intègre également les API modernes comme les View Transitions et les animations pilotées par le défilement (scroll-driven), tout en mettant en garde contre les motifs dangereux pouvant déclencher des problèmes vestibulaires ou des crises d'épilepsie. Un checklist de test et des directives de durée sont inclus pour garantir une implémentation à la fois performante et inclusive.

Compatible avec~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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Animation & Mouvement

Cette compétence couvre les animations et transitions CSS avec un accent sur l'accessibilité (respect des préférences de mouvement de l'utilisateur) et la performance (éviter les saccades et les recalculs de mise en page).

Connexe : Pour les motifs interactifs uniquement CSS (onglets, accordéons, bascules sans JavaScript), voir la compétence progressive-enhancement.

Philosophie

Le mouvement doit être :

  1. Pertinent - Guide l'attention, montre les relations, fournit un retour
  2. Respectueux - Honore les préférences prefers-reduced-motion
  3. Performant - Utilise des propriétés compositor-only quand c'est possible
  4. Subtile - Améliore, ne distrait pas ni n'accable

Mouvement Réduit en Premier

Commencez toujours par un mouvement réduit comme valeur par défaut, puis ajoutez du mouvement pour les utilisateurs qui n'ont pas choisi de le réduire.

Le Motif

/* Base : pas de mouvement (mouvement réduit par défaut) */
.element {
  transition: none;
}

/* Ajouter du mouvement uniquement lorsque l'utilisateur n'a pas demandé de mouvement réduit */
@media (prefers-reduced-motion: no-preference) {
  .element {
    transition: transform 0.3s ease, opacity 0.3s ease;
  }
}

Pourquoi Mouvement Réduit en Premier ?

ApprocheProblème
Mouvement d'abord, puis retraitLes utilisateurs voient un flash de mouvement avant que la requête média ne s'applique
Réduit d'abord, puis ajoutValeur par défaut sûre, le mouvement est une amélioration progressive

Respecter les Préférences Utilisateur

La Requête Média prefers-reduced-motion

/* L'utilisateur préfère un mouvement réduit */
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

Mouvement Réduit Granulaire

Au lieu de supprimer tout mouvement, fournissez des alternatives :

/* Animation complète pour les utilisateurs sans préférence */
@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);
  }
}

/* Alternative subtile pour mouvement réduit */
@media (prefers-reduced-motion: reduce) {
  .card {
    transition: box-shadow 0.15s ease;
  }

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

Détection en JavaScript

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

if (prefersReducedMotion) {
  // Utiliser des transitions instantanées ou ignorer les animations
  element.style.transition = 'none';
} else {
  // Animation complète
  element.animate(keyframes, options);
}

Propriétés Performantes

Propriétés Compositor-Only (Rapides)

Ces propriétés peuvent être animées sans déclencher de mise en page ou de peinture :

PropriétéUtilisation
transformMouvement, mise à l'échelle, rotation
opacityApparition/disparition en fondu
filterFlou, luminosité (accéléré GPU)
/* BON : Compositor-only */
.card:hover {
  transform: translateY(-4px) scale(1.02);
  opacity: 0.9;
}

Propriétés à Éviter d'Animer

Ces propriétés déclenchent des recalculs de mise en page coûteux :

PropriétéProblème
width, heightRecalcul de mise en page
top, left, right, bottomRecalcul de mise en page
margin, paddingRecalcul de mise en page
border-widthRecalcul de mise en page
font-sizeMise en page + reflow du texte
/* MAUVAIS : Déclenche une mise en page */
.card:hover {
  margin-top: -4px;  /* Saccades de mise en page */
  height: 110%;      /* Saccades de mise en page */
}

/* BON : Utiliser transform à la place */
.card:hover {
  transform: translateY(-4px) scaleY(1.1);
}

Promouvoir vers un Calque Compositor

Utilisez will-change avec parcimonie pour les animations connues :

/* Utiliser uniquement pour les éléments qui VONT être animés */
.animated-element {
  will-change: transform, opacity;
}

/* Supprimer après la fin de l'animation */
.animated-element.animation-done {
  will-change: auto;
}

Attention : N'appliquez pas will-change à de nombreux éléments—cela consomme de la mémoire.


Motifs de Transition

Intégration de Jetons de Conception

:root {
  /* Échelle de durée */
  --duration-instant: 0.1s;
  --duration-fast: 0.15s;
  --duration-normal: 0.3s;
  --duration-slow: 0.5s;

  /* Fonctions d'accélération */
  --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);
}

Transitions Courantes

/* Effet de soulèvement au survol */
@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);
  }
}

/* Cercle de focus */
@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;
  }
}

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

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

Motifs d'Animation

Animations Images Clés

/* Impulsion subtile pour attirer l'attention */
@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;
  }
}

/* Alternative mouvement réduit : pas d'animation */
@media (prefers-reduced-motion: reduce) {
  .notification-badge {
    animation: none;
  }
}

Spinners de Chargement

/* Spinner qui respecte le mouvement réduit */
@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 {
    /* Indicateur statique ou opacité pulsante */
    animation: none;
    border-style: dotted;
  }
}

Chargement Squelette

@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);
  }
}

Animations d'Entrée

Fondu et Glissement

@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;
  }

  /* Enfants décalés */
  .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;
  }
}

Mise à l'Échelle

@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 View Transitions

Pour les transitions de page (amélioration progressive) :

/* Activer les transitions de vue */
@view-transition {
  navigation: auto;
}

/* Fondu croisé par défaut */
::view-transition-old(root),
::view-transition-new(root) {
  animation-duration: var(--duration-normal);
}

/* Respecter le mouvement réduit */
@media (prefers-reduced-motion: reduce) {
  ::view-transition-old(root),
  ::view-transition-new(root) {
    animation-duration: 0.01ms;
  }
}

/* Transitions nommées pour des éléments spécifiques */
.hero-image {
  view-transition-name: hero;
}

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

Animations Pilotes par le Défilement

Animations CSS modernes pilotées par le défilement (amélioration progressive) :

/* Apparition en fondu au défilement */
@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-interactions

Pression de Bouton

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

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

Interrupteur à Bascule

.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);
}

Coche de Case à Cocher

.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;
}

Directives de Durée d'Animation

Type d'AnimationDuréeRaison
Micro-interaction100-150msRetour immédiat
Transition simple150-300msNotable mais rapide
Animation complexe300-500msTemps pour suivre
Transition de page300-500msChangement de contexte
Indicateur de chargement1000-2000msUn cycle visible

La Règle des 100ms

Les utilisateurs perçoivent les actions comme instantanées si la réponse est inférieure à 100ms. Utilisez-la pour :

  • États actifs des boutons
  • Indicateurs de focus
  • Interrupteurs à bascule

Motifs Dangereux à Éviter

Déclencheurs Vestibulaires

Ceux-ci peuvent provoquer des nausées ou des crises d'épilepsie :

MotifProblèmeAlternative
Défilement parallaxeProblèmes vestibulairesParallaxe statique ou subtile
Vidéo en lecture automatiqueMouvement inattenduLecture sur interaction
Clignotement (>3Hz)Risque de crisePas de clignotement
Zoom importantProblèmes vestibulairesTransitions en fondu
Rotation/tournoiementDésorientationFondu ou glissement
/* MAUVAIS : Parallaxe agressive */
.parallax {
  transform: translateY(calc(var(--scroll) * 0.5));
}

/* MEILLEUR : Subtile ou désactivée avec mouvement réduit */
@media (prefers-reduced-motion: reduce) {
  .parallax {
    transform: none;
  }
}

Animations Infinies

/* MAUVAIS : Mouvement constant */
.attention-seeker {
  animation: bounce 1s infinite;
}

/* MEILLEUR : Itérations limitées */
.attention-seeker {
  animation: bounce 1s 3; /* Seulement 3 fois */
}

/* MEILLEUR : Déclencher sur interaction */
.attention-seeker:hover {
  animation: bounce 0.5s;
}

Liste de Vérification des Tests

Outils de Développement du Navigateur

  1. Chrome : Rendu > Émuler une fonctionnalité média CSS > prefers-reduced-motion: reduce
  2. Firefox : about:config > ui.prefersReducedMotion (0=no-preference, 1=reduce)
  3. Safari : Développer > Fonctionnalités expérimentales > Mouvement réduit

Paramètres Système

  • macOS : Préférences Système > Accessibilité > Affichage > Réduire les animations
  • iOS : Réglages > Accessibilité > Mouvement > Réduire le mouvement
  • Windows : Paramètres > Options d'ergonomie > Affichage > Afficher les animations
  • Android : Paramètres > Accessibilité > Supprimer les animations

Liste de Vérification

Lors de l'ajout d'animations ou de transitions :

  • prefers-reduced-motion est respecté
  • Le mouvement réduit a une alternative significative (pas seulement désactivé)
  • Seules les propriétés du compositor sont animées (transform, opacity)
  • will-change est utilisé avec parcimonie et supprimé après l'animation
  • Les jetons de durée sont utilisés de manière cohérente
  • Pas de contenu clignotant (>3 flashs par seconde)
  • Les animations infinies ont un but et peuvent être arrêtées
  • La parallaxe et les grands mouvements sont des améliorations optionnelles
  • Les états de chargement fonctionnent sans animation
  • L'animation améliore plutôt que de distraire

Compétences Connexes

  • css-author - Organisation CSS moderne avec @import natif, cascade @layer...
  • progressive-enhancement - Développement HTML-first avec motifs d'interactivité CSS uniquement
  • performance - Écrire des pages HTML performantes
  • accessibility-checker - Assurer la conformité WCAG2AA en matière d'accessibilité

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 associés