Communitygithub.com

David-Li0406/meta-skill-evloving

Animações CSS, transições e efeitos baseados em rolagem com acessibilidade (prefers-reduced-motion). Use ao adicionar movimento, efeitos de hover, estados de carregamento ou animações baseadas em rolagem.

O que é meta-skill-evloving?

Esta habilidade oferece um guia completo para animações e transições CSS, priorizando acessibilidade e desempenho. Ela ensina a respeitar as preferências de movimento do usuário (prefers-reduced-motion) e a usar propriedades que não forçam recálculos de layout, como transform e opacity. O guia inclui padrões para animações de entrada, micro-interações, indicadores de carregamento e animações baseadas em rolagem, sempre com alternativas seguras para quem prefere movimento reduzido. É útil em plataformas como Claude Code, Cursor e outros agentes que geram código CSS moderno e acessível.

Funciona com~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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Animação e Movimento

Esta habilidade cobre animações e transições CSS com foco em acessibilidade (respeitando as preferências de movimento do usuário) e desempenho (evitando travamentos e alterações de layout).

Relacionada: Para padrões interativos CSS-only (abas, acordeões, alternadores sem JavaScript), veja a habilidade progressive-enhancement.

Filosofia

O movimento deve ser:

  1. Proposital - Guia a atenção, mostra relações, fornece feedback
  2. Respeitoso - Honra as preferências de prefers-reduced-motion
  3. Eficiente - Usa propriedades apenas do compositor quando possível
  4. Sutil - Melhora, não distrai ou sobrecarrega

Movimento Reduzido Primeiro

Sempre comece com movimento reduzido como padrão, depois adicione movimento para usuários que não optaram por redução.

O Padrão

/* Base: sem movimento (padrão de movimento reduzido) */
.element {
  transition: none;
}

/* Adicione movimento apenas quando o usuário não solicitou movimento reduzido */
@media (prefers-reduced-motion: no-preference) {
  .element {
    transition: transform 0.3s ease, opacity 0.3s ease;
  }
}

Por que Movimento Reduzido Primeiro?

AbordagemProblema
Movimento primeiro, depois removaUsuários veem um flash de movimento antes da media query ser aplicada
Reduzido primeiro, depois adicionePadrão seguro, movimento é um aprimoramento progressivo

Respeitando as Preferências do Usuário

A Media Query prefers-reduced-motion

/* Usuário prefere movimento reduzido */
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

Movimento Reduzido Granular

Em vez de remover todo o movimento, forneça alternativas:

/* Animação completa para usuários sem preferência */
@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 movimento reduzido */
@media (prefers-reduced-motion: reduce) {
  .card {
    transition: box-shadow 0.15s ease;
  }

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

Detecção com JavaScript

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

if (prefersReducedMotion) {
  // Use transições instantâneas ou pule animações
  element.style.transition = 'none';
} else {
  // Animação completa
  element.animate(keyframes, options);
}

Propriedades com Bom Desempenho

Propriedades Apenas do Compositor (Rápidas)

Estas propriedades podem ser animadas sem acionar layout ou pintura:

PropriedadeUse para
transformMovimento, escala, rotação
opacityAparecer/desaparecer
filterDesfoque, brilho (acelerado por GPU)
/* BOM: Apenas compositor */
.card:hover {
  transform: translateY(-4px) scale(1.02);
  opacity: 0.9;
}

Propriedades a Evitar ao Animar

Estas acionam recálculos caros de layout:

PropriedadeProblema
width, heightRecalculo de layout
top, left, right, bottomRecalculo de layout
margin, paddingRecalculo de layout
border-widthRecalculo de layout
font-sizeLayout + refluir texto
/* RUIM: Aciona layout */
.card:hover {
  margin-top: -4px;  /* Travamento de layout */
  height: 110%;      /* Travamento de layout */
}

/* BOM: Use transform em vez disso */
.card:hover {
  transform: translateY(-4px) scaleY(1.1);
}

Promovendo para a Camada do Compositor

Use will-change com moderação para animações conhecidas:

/* Use apenas para elementos que IRÃO animar */
.animated-element {
  will-change: transform, opacity;
}

/* Remova após a animação completar */
.animated-element.animation-done {
  will-change: auto;
}

Aviso: Não aplique will-change a muitos elementos—isso consome memória.


Padrões de Transição

Integração com Tokens de Design

:root {
  /* Escala de duração */
  --duration-instant: 0.1s;
  --duration-fast: 0.15s;
  --duration-normal: 0.3s;
  --duration-slow: 0.5s;

  /* Funções 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);
}

Transições Comuns

/* Efeito de elevação no 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);
  }
}

/* Anel de foco */
@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;
  }
}

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

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

Padrões de Animação

Animações com Keyframes

/* Pulsação sutil para atenção */
@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 para movimento reduzido: sem animação */
@media (prefers-reduced-motion: reduce) {
  .notification-badge {
    animation: none;
  }
}

Spinners de Carregamento

/* Spinner que respeita movimento reduzido */
@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 ou opacidade pulsante */
    animation: none;
    border-style: dotted;
  }
}

Carregamento Skeleton

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

Animações de Entrada

Aparecer e Deslizar

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

  /* Filhos 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;
  }
}

Escalar

@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 Transições de Visualização (View Transitions API)

Para transições de página (aprimoramento progressivo):

/* Habilitar transições de visualização */
@view-transition {
  navigation: auto;
}

/* Crossfade padrão */
::view-transition-old(root),
::view-transition-new(root) {
  animation-duration: var(--duration-normal);
}

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

/* Transições nomeadas para elementos específicos */
.hero-image {
  view-transition-name: hero;
}

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

Animações Baseadas em Rolagem

Animações CSS modernas baseadas em rolagem (aprimoramento progressivo):

/* Aparecer ao rolar */
@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-interações

Pressionar Botão

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

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

Alternador (Toggle Switch)

.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ção de Checkbox

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

Diretrizes de Duração de Animação

Tipo de AnimaçãoDuraçãoMotivo
Micro-interação100-150msFeedback imediato
Transição simples150-300msPerceptível, mas rápido
Animação complexa300-500msTempo para acompanhar
Transição de página300-500msMudança de contexto
Indicador de carregamento1000-2000msUm ciclo visível

A Regra dos 100ms

Os usuários percebem ações como instantâneas se a resposta for inferior a 100ms. Use isso para:

  • Estados ativos de botão
  • Indicadores de foco
  • Alternadores

Padrões Perigosos a Evitar

Gatilhos Vestibulares

Estes podem causar enjoo ou convulsões:

PadrãoProblemaAlternativa
Rolagem parallaxProblemas vestibularesParallax estático ou sutil
Vídeo com reprodução automáticaMovimento inesperadoReproduzir ao interagir
Piscante (>3Hz)Risco de convulsãoSem piscar
Zoom grandeProblemas vestibularesTransições de fade
Girando/rotacionandoDesorientaçãoFade ou deslizar
/* RUIM: Parallax agressivo */
.parallax {
  transform: translateY(calc(var(--scroll) * 0.5));
}

/* MELHOR: Sutil ou desabilitado com movimento reduzido */
@media (prefers-reduced-motion: reduce) {
  .parallax {
    transform: none;
  }
}

Animações Infinitas

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

/* MELHOR: Iterações limitadas */
.attention-seeker {
  animation: bounce 1s 3; /* Apenas 3 vezes */
}

/* MELHOR: Acionar ao interagir */
.attention-seeker:hover {
  animation: bounce 0.5s;
}

Lista de Verificação de Testes

Ferramentas do Desenvolvedor no Navegador

  1. Chrome: Renderização > Emular recurso de mídia CSS > prefers-reduced-motion: reduce
  2. Firefox: about:config > ui.prefersReducedMotion (0=sem preferência, 1=reduzir)
  3. Safari: Desenvolver > Recursos Experimentais > Movimento Reduzido

Configurações do Sistema

  • macOS: Preferências do Sistema > Acessibilidade > Tela > Reduzir movimento
  • iOS: Ajustes > Acessibilidade > Movimento > Reduzir Movimento
  • Windows: Configurações > Facilidade de Acesso > Tela > Mostrar animações
  • Android: Configurações > Acessibilidade > Remover animações

Lista de Verificação

Ao adicionar animações ou transições:

  • prefers-reduced-motion é respeitado
  • Movimento reduzido tem uma alternativa significativa (não apenas desabilitado)
  • Apenas propriedades do compositor são animadas (transform, opacity)
  • will-change é usado com moderação e removido após a animação
  • Tokens de duração são usados consistentemente
  • Nenhum conteúdo piscante (>3 piscadas por segundo)
  • Animações infinitas têm um propósito e podem ser interrompidas
  • Parallax e movimento grande são aprimoramentos opcionais
  • Estados de carregamento funcionam sem animação
  • A animação melhora em vez de distrair

Habilidades Relacionadas

  • css-author - Organização CSS moderna com @import nativo, @layer em cascata...
  • progressive-enhancement - Desenvolvimento HTML-first com padrões de interatividade CSS-only
  • performance - Escrever páginas HTML com bom desempenho
  • accessibility-checker - Garantir conformidade com WCAG2AA de acessibilidade

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".

Habilidades Relacionadas