Communitygithub.com

FerroxLabs/murage

Expertise em animação web abrangendo animações e transições CSS, Web Animations API, Framer Motion, GSAP, animações orientadas por rolagem, animações de layout, física de molas, preferências de movimento reduzido e orçamentos de desempenho.

O que é murage?

Este skill oferece um guia completo para projetar e implementar animações web performáticas e intencionais, melhorando a experiência do usuário sem comprometer desempenho ou acessibilidade. Ele abrange desde técnicas simples de CSS (transições e @keyframes) até bibliotecas avançadas como Framer Motion (ideal para animações de entrada/saída em React e animações com física de molas) e GSAP (para sequências temporais complexas e animações orientadas por rolagem). Além disso, inclui práticas essenciais como o respeito à preferência do usuário por movimento reduzido (`prefers-reduced-motion`), um orçamento de desempenho focado em manter 60fps (animando apenas `transform` e `opacity`), e princípios de design que garantem que cada animação tenha um propósito claro. O skill é compatível com diversas plataformas e frameworks, fornecendo exemplos práticos em CSS, React (com Framer Motion) e JavaScript (com GSAP), e é acionado quando o usuário busca orientação sobre Design de Animação ou precisa de melhores práticas para sua implementação.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/animation-designer

Perguntar na sua IA favorita

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

Documentação

Design de Animação

Propósito

Projetar e implementar animações web performáticas e intencionais que melhorem a experiência do usuário sem sacrificar desempenho ou acessibilidade. Este skill cobre ferramentas de animação, padrões e a estrutura de decisão para escolher a abordagem certa.

Seleção de Ferramentas de Animação

Matriz de Decisão

NECESSIDADE DE ANIMAÇÃO                 FERRAMENTA RECOMENDADA
--------------------------------------------------------------
Efeitos simples de hover/foco           Transições CSS
Sequências de keyframes (loading, etc.)  CSS @keyframes
Animações de entrada/saída de componentes  Framer Motion (React)
                                          Vue <Transition> (Vue)
Revelações acionadas por rolagem        Animações CSS orientadas por rolagem
                                          (ou Intersection Observer)
Sequências temporais complexas          GSAP
Animações de caminho SVG                GSAP ou CSS
Movimento baseado em física/mola        Framer Motion (spring)
Animações de layout (posição/tamanho)   Framer Motion (layoutId)
Movimento baseado em gestos (arrastar, pinça)  Framer Motion (drag)
Transições de elemento compartilhado    View Transitions API
Animações de visualização de dados      Transições D3 ou GSAP
Microinterações (ícones, alternadores)  CSS ou Lottie

Transições CSS

Fundamentos

/* Atalho de transição: propriedade duração função-temporização atraso */
.botao {
  background: var(--cor-marca);
  transition: background 200ms ease-out, transform 150ms ease-out;
}
.botao:hover {
  background: var(--cor-marca-hover);
  transform: scale(1.02);
}

/* Propriedades individuais */
.card {
  transition-property: transform, box-shadow, opacity;
  transition-duration: 200ms, 300ms, 200ms;
  transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
}

/* Funções de temporização nomeadas */
--ease-in:        cubic-bezier(0.4, 0, 1, 1);     /* Acelerando */
--ease-out:       cubic-bezier(0, 0, 0.2, 1);     /* Desacelerando */
--ease-in-out:    cubic-bezier(0.4, 0, 0.2, 1);   /* Padrão */
--ease-spring:    cubic-bezier(0.34, 1.56, 0.64, 1); /* Ultrapassagem */

Padrões de Transição Comuns

/* Aparecer/Desaparecer */
.fade-enter { opacity: 0; }
.fade-enter-active { opacity: 1; transition: opacity 300ms ease-out; }
.fade-exit { opacity: 1; }
.fade-exit-active { opacity: 0; transition: opacity 200ms ease-in; }

/* Deslizar para cima a partir de baixo */
.slide-up {
  transform: translateY(20px);
  opacity: 0;
  transition: transform 300ms ease-out, opacity 200ms ease-out;
}
.slide-up.active {
  transform: translateY(0);
  opacity: 1;
}

/* Brilho de carregamento (skeleton) */
@keyframes brilho {
  0% { background-position: -200% 0; }
  100% { background-position: 200% 0; }
}
.skeleton {
  background: linear-gradient(90deg, #e0e0e0 25%, #f0f0f0 50%, #e0e0e0 75%);
  background-size: 200% 100%;
  animation: brilho 1.5s ease-in-out infinite;
}

CSS @keyframes

/* Giratório */
@keyframes girar {
  to { transform: rotate(360deg); }
}
.giratorio {
  animation: girar 1s linear infinite;
  border: 3px solid var(--cor-borda);
  border-top-color: var(--cor-marca);
  border-radius: 50%;
  width: 24px; height: 24px;
}

/* Pulsar (indicador de atenção) */
@keyframes pulsar {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.5; }
}
.ponto-notificacao {
  # ... (condensado) ...
.item-lista:nth-child(2) { animation-delay: calc(1 * 50ms); }
.item-lista:nth-child(3) { animation-delay: calc(2 * 50ms); }

/* Ou com atributo style: style="--i: 3" */
.item-lista {
  animation-delay: calc(var(--i) * 50ms);
}

Animações CSS Orientadas por Rolagem

/* Animar com base na posição de rolagem */
@keyframes revelar {
  from {
    opacity: 0;
    transform: translateY(40px) scale(0.95);
  }
  to {
    opacity: 1;
    transform: translateY(0) scale(1);
  }
}

/* Acionar quando o elemento entra na viewport */
.revelar-na-rolagem {
  animation: revelar linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 50%;
}
# ... (condensado) ...
  to { transform: translateY(-50px); }
}

.elemento-parallax {
  animation: parallax linear;
  animation-timeline: scroll();
}

Framer Motion (React)

Padrões Básicos

import { motion, AnimatePresence } from 'framer-motion';

// Animação de entrada
function Card() {
  return (
    <motion.div
      initial={{ opacity: 0, y: 20 }}
      animate={{ opacity: 1, y: 0 }}
      transition={{ duration: 0.3, ease: 'easeOut' }}
    >
      <h2>Conteúdo do Card</h2>
    </motion.div>
  );
}

// Animação de saída (requer AnimatePresence)
function Modal({ isOpen, onClose }: ModalProps) {
  return (
    # ... (condensado) ...
        <motion.li key={item.id} variants={itemVariants}>
          {item.nome}
        </motion.li>
      ))}
    </motion.ul>
  );
}

Física de Mola

// Animação com mola (movimento natural baseado em física)
<motion.div
  animate={{ x: 100 }}
  transition={{
    type: 'spring',
    stiffness: 300,   // Maior = mais rápido
    damping: 20,      // Maior = menos oscilação
    mass: 1,          // Maior = mais inércia
  }}
/> .// Predefinições
const predefinicoesMola = {
  rapida:  { type: 'spring', stiffness: 400, damping: 25 },
  elastica:  { type: 'spring', stiffness: 300, damping: 10 },
  suave:  { type: 'spring', stiffness: 120, damping: 14 },
  melado: { type: 'spring', stiffness: 60, damping: 20 },
};

// Quando usar mola vs. easing:
// Mola: elementos interativos, arrastar, mudanças de layout (parece natural)
// Easing: transições simples, entrada/saída (parece previsível)

Animações de Layout

// Animação automática de layout
function CardExpansivel({ expandido }: { expandido: boolean }) {
  return (
    <motion.div layout className={expandido ? 'card-expandido' : 'card-recolhido'}>
      <motion.h2 layout="position">Título</motion.h2>
      {expandido && (
        <motion.p
          initial={{ opacity: 0 }}
          animate={{ opacity: 1 }}
          exit={{ opacity: 0 }}
        >
          Conteúdo expandido aqui.
        </motion.p>
      )}
    </motion.div>
  );
}

# ... (condensado) ...
            {item.titulo}
          </motion.div>
        ))}
      </div>
    </LayoutGroup>
  );
}

Animações de Gesto

// Arrastar
<motion.div
  drag
  dragConstraints={{ top: -100, bottom: 100, left: -100, right: 100 }}
  dragElastic={0.2}
  whileDrag={{ scale: 1.1, cursor: 'grabbing' }}
/> .// Hover e toque
<motion.button
  whileHover={{ scale: 1.05 }}
  whileTap={{ scale: 0.95 }}
  transition={predefinicoesMola.rapida}
>
  Clique em Mim
</motion.button> .// Acionado por rolagem (com useInView)
# ... (condensado) ...
      animate={estaVisivel ? { opacity: 1, y: 0 } : {}}
      transition={{ duration: 0.6, ease: 'easeOut' }}
    >
      {children}
    </motion.div>
  );
}

GSAP (Linhas do Tempo Complexas)

import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';

gsap.registerPlugin(ScrollTrigger);

// Sequência de linha do tempo
const tl = gsap.timeline({ defaults: { ease: 'power2.out', duration: 0.5 } });

tl.from('.hero-titulo', { y: 60, opacity: 0 })
  .from('.hero-subtitulo', { y: 40, opacity: 0 }, '-=0.3')   // Sobreposição de 0.3s
  .from('.hero-cta', { scale: 0.8, opacity: 0 }, '-=0.2')
  .from('.hero-imagem', { x: 100, opacity: 0 }, '-=0.4');

// Animação acionada por rolagem
gsap.from('.card-funcionalidade', {
  scrollTrigger: {
    trigger: '.secao-funcionalidades',
    start: 'top 80%',
    # ... (condensado) ...
  const ctx = gsap.context(() => {
    // Todas as animações GSAP aqui
    gsap.from('.item', { opacity: 0, y: 20, stagger: 0.1 });
  }, containerRef);

  return () => ctx.revert();  // Limpar todas as animações
}, []);

Preferências de Movimento Reduzido

Implementação

/* CSS: Respeitar globalmente a preferência do usuário */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
// React: Hook useReducedMotion
function useReducedMotion(): boolean {
  const [reduzido, setReduzido] = useState(false);

  useEffect(() => {
    const mq = window.matchMedia('(prefers-reduced-motion: reduce)');
    setReduzido(mq.matches);
    const handler = (e: MediaQueryListEvent) => setReduzido(e.matches);
    mq.addEventListener('change', handler);
    return () => mq.removeEventListener('change', handler);
  }, []);

  return reduzido;
}

// Uso
function CardAnimado() {
  const reduzido = useReducedMotion();
# ... (condensado) ...
      Conteúdo
    </motion.div>
  );
}

// Framer Motion integrado (v6+)
import { useReducedMotion } from 'framer-motion';

Orçamento de Desempenho para Animação

ALVO: As animações devem manter 60fps (16,67ms por quadro)

REGRAS:
  1. Animar apenas transform e opacity (propriedades apenas do compositor)
  2. Evitar animar width, height, top, left, margin, padding
  3. Usar will-change com moderação (adiciona sobrecarga de memória)
  4. Limitar animações simultâneas a ~10-15 elementos
  5. Usar requestAnimationFrame para animações orientadas por JS
  6. Debounce manipuladores de rolagem (ou usar animações CSS orientadas por rolagem)
  7. Evitar animar elementos que acionam layout em outros elementos

MEDIÇÃO:
  - Chrome DevTools > Performance > Gráfico de quadros
  - Alvo: Nenhum quadro excedendo 16ms
  - Verificar thrashing de layout (indicadores de refluxo forçado)

TÉCNICAS DE OTIMIZAÇÃO:
  - Usar transform: translateZ(0) ou will-change para promover camadas
  - Usar contain: layout paint para contêineres animados
  - Usar content-visibility: auto para conteúdo animado fora da tela
  - Pausar animações quando não visíveis (Intersection Observer)

Princípios de Design de Animação

1. PROPÓSITO: Cada animação deve servir a uma função
   - Guiar a atenção
   - Mostrar relações (pai-filho, antes-depois)
   - Fornecer feedback (clique, hover, sucesso, erro)
   - Manter orientação espacial (de onde o conteúdo veio)
   - Reduzir o tempo de espera percebido

2. DIRETRIZES DE DURAÇÃO:
   Microinterações (hover, alternar):  100-200ms
   Animações de entrada:                 200-400ms
   Animações de saída:                     150-300ms (mais rápida que a entrada)
   Transições de página:                    300-500ms
   Sequências complexas:                   500-1000ms total

3. EASING:
   Entrando: ease-out (desacelerando -- aparece rapidamente, se estabelece)
   Saindo: ease-in (acelerando -- começa devagar, sai rapidamente)
   Movendo: ease-in-out (movimento natural)
   Contínuo: linear (giratórios, progresso)

4. ESCALONAMENTO:
   30-80ms entre itens da lista (mais rápido para mais itens)
   Duração total máxima de escalonamento: ~500ms (mesmo para 20+ itens)

Lista de Verificação da Arquitetura de Animação

  • Ferramenta de animação selecionada com base nas necessidades de complexidade
  • Transições CSS usadas para efeitos simples de hover/foco
  • CSS @keyframes usados para animações de loop e carregamento
  • Framer Motion ou equivalente usado para animações de entrada/saída/layout
  • GSAP reservado para sequências complexas de linha do tempo
  • Todas as animações mantêm 60fps (verificado no DevTools)
  • Apenas transform e opacity são animados (sem propriedades de layout)
  • prefers-reduced-motion respeitado globalmente
  • Durações de animação seguem diretrizes de UX (100-500ms)
  • Tempo de escalonamento limitado a uma duração total razoável
  • Cada animação tem um propósito claro (não decorativa)
  • Física de mola usada para animações interativas/de gestos
  • Animações orientadas por rolagem usam API CSS onde suportado
  • Animações GSAP são limpas na desmontagem do componente
  • will-change usado apenas durante animação ativa

Quando Usar

Use este skill quando:

  • Projetando ou implementando soluções de design de animação
  • Revisando ou melhorando abordagens existentes de design de animação
  • Tomando decisões arquiteturais ou de implementação sobre design de animação
  • Aprendendo padrões e melhores práticas de design de animação
  • Solucionando problemas relacionados a design de animação

NÃO use este skill quando:

  • A pergunta é sobre um domínio de tecnologia fundamentalmente diferente
  • Um skill irmão mais específico cobre exatamente o tópico necessário
  • O usuário precisa de um tutorial prático completo em vez de orientação especializada

Formato de Saída

# Análise de Design de Animação

## Avaliação de Contexto
[Resumo da situação e restrições]

## Abordagem Recomendada
[Recomendação principal com justificativa]

## Etapas de Implementação
1. [Etapa com detalhes específicos]
2. [Etapa com detalhes específicos]
3. [Etapa com detalhes específicos]

## Compensações e Considerações
- [Compensação principal 1]
- [Compensação principal 2]

## Próximos Passos
- [Item de ação imediata]
- [Item de ação de acompanhamento]

Exemplo

Entrada: "Ajude-me a implementar design de animação para uma aplicação de produção de médio porte"

Saída: Uma análise estruturada cobrindo avaliação do estado atual, abordagem de design de animação recomendada com padrões específicos, roteiro de implementação com marcos e estratégias de mitigação de riscos adaptadas à escala e restrições da aplicação.

Casos de Borda

  • Integração com sistema legado: Quando o design de animação deve coexistir com abordagens legadas, forneça um caminho de migração gradual em vez de uma reescrita completa
  • Incompatibilidade de escala: Quando a complexidade da solução excede a escala do projeto, recomende uma abordagem mais simples e observe quando revisitar
  • Lacunas de habilidade da equipe: Quando a equipe não tem experiência com a abordagem recomendada, inclua recursos de aprendizado e alternativas mais simples
  • Requisitos conflitantes: Quando as restrições entram em conflito (por exemplo, desempenho vs. manutenibilidade), declare explicitamente a compensação e recomende com base nas prioridades declaradas

Individual skills in this repo

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

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Game narrative design covering branching dialogue systems, world lore construction, environmental storytelling techniques, character arc design for interactive media, player agency and consequence systems, quest narrative structure, narrative documentation, and integration with game mechanics. Use when the user asks about narrative designer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

Habilidades Relacionadas