motion-design
Skill28 starsChanged 3 months agoApache-2.0View on GitHub
Projeta e implementa animacoes e microinteracoes de interface. Trigger em: "animacao", "transicao", "motion", "micro-interacao", "framer motion", "spring", "easing", "parallax", "scroll animation", "hover effect", "shared element", "flip", "layout animation", "haptic", "vibracao", "som de interface", "reduced motion", "flash", "piscando", "quando nao animar", "animacao demais".
48 other projects use a version of this.
Adopted by
Most recently taken up by
- owlinthebarnai/video-studio-kittheir own version, first seen Nov 16, 2026
- zstvns/design-skillstheir own version, first seen Nov 15, 2026
- ryanportfolio/HarnessFirmware.comtheir own version, first seen Nov 8, 2026
- ryanportfolio/Corewise.Academytheir own version, first seen Nov 8, 2026
- ryanportfolio/savetokenstheir own version, first seen Nov 8, 2026
- ryanportfolio/STKtheir own version, first seen Nov 8, 2026
Used with
Projects with it also use conversion-ux, addskill and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
LucSenaSkillconversion-ux
Use when building or improving the screens that turn visitors into users and users into customers — landing pages and heroes, CTAs, social proof, signup forms as a conversion step, pricing pages, paywalls and upgrade prompts, trials, checkout, and cancellation flows — and when planning A/B tests for them. Covers awareness-level messaging, field costs, plan tables, Baymard checkout findings, easy-cancel legal requirements, sample sizes, and a hard ethics floor against dark patterns. Also use when the user says "nobody signs up", "improve conversion", "my landing page isn't working", "design our pricing page", "add a paywall", "reduce checkout abandonment", or "build a cancel flow", even for one section. For onboarding, activation, and first-run empty states use onboarding-design; for login, sign-up mechanics, and account security use auth-flows; for visual direction use design-taste; for form mechanics use interaction-design; for psychology and dark-pattern law in depth use ux-principles.
Also in 7 projects that use this
ryanportfolioSkilladdskill
Create, import, update, or install repo or personal skills: runtime ownership, resources, discovery checks.
Also in 6 projects that use this
ryanportfolioSkillapply-firmware
Bring current folder (plain folder, existing repo, old or partial firmware copy) up to full Harness Firmware in place. Mirror external repo → adopt-repo.
Also in 6 projects that use this
- +9 more from ryanportfolio
Other versions48 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 48
- LottieFiles/motion-design-skill★ 1.7ksame name
- Jwuthri/Tracely-ai★ 1.3ksame name
- jwuthri-cloud/Tracely-ai★ 979same name
- nahid-sparktales/agent-dispatcher★ 59same name
- gvergnaud/bise★ 51same name
- imMamdouhaboammar/motion-graphics-skills★ 50same name
- adityareddy-dev/deskstudio★ 43same name
- owlinthebarnai/video-studio-kit★ 41same name
- LobzyJay/motion-design-with-claude-and-codex★ 38same name
- zstvns/design-skills★ 33same name
38 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository92 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- po-feature-specSkill
- ui-ux-designSkill
- backend-apiSkill
- frontend-integrationSkill
- qa-testingSkill
- security-reviewSkill
- deploy-dockerSkill
- context-managerSkill
- orchestratorSkill
- documenterSkill
- reviewerSkill
- marketing-copySkill
- seo-specialistSkill
- mobile-tauriSkill
- image-generatorSkill
- repo-auditorSkill
- asset-librarianSkill
- observability-sreSkill
- data-analyticsSkill
- accessibility-specialistSkill
- migration-refactor-specialistSkill
- release-managerSkill
- ai-integration-architectSkill
- prompt-engineerSkill
- video-integration-specialistSkill
- claude-md-generatorSkill
- design-intelligenceSkill
- cost-trackerSkill
- session-summarySkill
- smart-suggestionsSkill
- detective-specSkill
- static-analysisSkill
- skill-authorSkill
- web-asset-generatorSkill
- tdd-engineerSkill
- architecture-deepenerSkill
- program-routerSkill
- parallel-dispatcherSkill
- blog-publisherSkill
- blog-screenshotSkill
- canary-deploymentSkill
- zoom-outSkill
- handoff-contextSkill
- post-deploy-canary-monitorSkill
- pattern-conformitySkill
- research-prepSkill
- context-budgetSkill
- direct-response-copySkill
- ux-researchSkill
- ui-polishSkill
- doubt-driven-reviewSkill
- video-analysisSkill
- marketing-reporting-analyticsSkill
- responsive-conversionSkill
- mobile-ux-foundationsSkill
- i18n-localizationSkill
- closed-loop-revenueSkill
- app-reference-architectureSkill
- The first 60 shown.
The file
Files
Motion Design - Animações, Transições e Micro-Interações
O Motion Designer entra após o Frontend, quando os componentes estão prontos para receber vida. Toda animação deve ser intencional, performática e acessível.
Governanca Global
Esta skill segue GLOBAL.md, policies/execution.md, policies/handoffs.md, policies/token-efficiency.md, policies/stack-flexibility.md e policies/evals.md.
Para exemplos extensos de tokens e variants, consultar docs/skill-guides/motion-design.md apenas quando necessario.
Para ajustes pontuais de acabamento (scale on press, animacao contextual de icone, skip animation on load, split/stagger de entrada, saida sutil), ver skills/52-ui-polish/SKILL.md — esta skill (12) e dona do sistema de motion tokens; a 52 cobre o detalhe fino que faz o motion parecer refinado.
Quando Usar
- adicionar movimento significativo a componentes e fluxos
- definir microinteracoes, transicoes e comportamento de entrada/saida
Quando Nao Usar
- para substituir UI/UX estrutural ou implementacao frontend base
- quando o movimento nao agrega clareza ou acessibilidade
Entradas Esperadas
- componentes frontend ja definidos
- intencao da interface e hierarquia visual
- restricoes de performance e acessibilidade
Saidas Esperadas
- sistema de motion coerente
- transicoes e microinteracoes justificadas
- handoff claro para QA/Frontend
Responsabilidades
- Criar sistema de animação consistente com tokens reutilizáveis
- Implementar transições entre páginas fluidas
- Definir micro-interações (hover, click, focus) para feedback do usuário
- Criar transições de loading/skeleton suaves
- Implementar animações baseadas em scroll
- Garantir 60fps em todas as animações
Stack
Animações: Framer Motion
Transições: CSS Transitions / CSS Animations
Estilo: Tailwind CSS
Performance: requestAnimationFrame
Acessibilidade: prefers-reduced-motionMotion Tokens
export const motionTokens = {
duration: {
instant: 0.1,
fast: 0.2,
normal: 0.3,
slow: 0.5,
dramatic: 0.8,
},
easing: {
default: [0.25, 0.1, 0.25, 1],
smooth: [0.4, 0, 0.2, 1],
snappy: [0.2, 0, 0, 1],
bounce: [0.34, 1.56, 0.64, 1],
spring: { type: 'spring', stiffness: 300, damping: 20 },
},
stagger: {
fast: 0.03,
normal: 0.05,
slow: 0.1,
},
} as const;Padrões de Animação
Animações de Entrada
import { Variants } from 'framer-motion';
import { motionTokens } from '@/lib/motion-tokens';
const { duration, easing } = motionTokens;
export const fadeIn: Variants = {
hidden: { opacity: 0 },
visible: {
opacity: 1,
transition: { duration: duration.normal, ease: easing.smooth },
},
};
export const slideUp: Variants = {
hidden: { opacity: 0, y: 20 },
visible: {
opacity: 1,
y: 0,
transition: { duration: duration.normal, ease: easing.smooth },
},
};
export const slideInFromLeft: Variants = {
hidden: { opacity: 0, x: -30 },
visible: {
opacity: 1,
x: 0,
transition: { duration: duration.normal, ease: easing.snappy },
},
};
export const scaleIn: Variants = {
hidden: { opacity: 0, scale: 0.9 },
visible: {
opacity: 1,
scale: 1,
transition: { duration: duration.fast, ease: easing.bounce },
},
};Animações de Saída
export const fadeOut: Variants = {
visible: { opacity: 1 },
exit: {
opacity: 0,
transition: { duration: duration.fast, ease: easing.default },
},
};
export const slideDown: Variants = {
visible: { opacity: 1, y: 0 },
exit: {
opacity: 0,
y: 20,
transition: { duration: duration.fast, ease: easing.smooth },
},
};Animações de Lista (Stagger)
export const staggerContainer: Variants = {
hidden: { opacity: 0 },
visible: {
opacity: 1,
transition: {
staggerChildren: motionTokens.stagger.normal,
delayChildren: 0.1,
},
},
};
export const staggerItem: Variants = {
hidden: { opacity: 0, y: 15 },
visible: {
opacity: 1,
y: 0,
transition: { duration: duration.normal, ease: easing.smooth },
},
};import { motion } from 'framer-motion';
import { staggerContainer, staggerItem } from '@/lib/motion-variants';
function AnimatedList({ items }: { items: Item[] }) {
return (
<motion.ul
variants={staggerContainer}
initial="hidden"
animate="visible"
>
{items.slice(0, 10).map((item) => (
<motion.li key={item.id} variants={staggerItem}>
{item.name}
</motion.li>
))}
</motion.ul>
);
}Transição de Página
export const pageTransition: Variants = {
hidden: { opacity: 0, y: 10 },
visible: {
opacity: 1,
y: 0,
transition: { duration: duration.normal, ease: easing.smooth },
},
exit: {
opacity: 0,
y: -10,
transition: { duration: duration.fast, ease: easing.default },
},
};import { AnimatePresence, motion } from 'framer-motion';
import { pageTransition } from '@/lib/motion-variants';
function PageWrapper({ children, key }: { children: React.ReactNode; key: string }) {
return (
<AnimatePresence mode="wait">
<motion.div
key={key}
variants={pageTransition}
initial="hidden"
animate="visible"
exit="exit"
>
{children}
</motion.div>
</AnimatePresence>
);
}Micro-Interações
import { motion } from 'framer-motion';
import { motionTokens } from '@/lib/motion-tokens';
function ButtonPress({ children, onClick }: { children: React.ReactNode; onClick: () => void }) {
return (
<motion.button
whileTap={{ scale: 0.97 }}
whileHover={{ scale: 1.02 }}
transition={{ duration: motionTokens.duration.instant, ease: motionTokens.easing.snappy }}
onClick={onClick}
>
{children}
</motion.button>
);
}
function CardHover({ children }: { children: React.ReactNode }) {
return (
<motion.div
whileHover={{
y: -4,
boxShadow: '0 10px 30px rgba(0, 0, 0, 0.12)',
}}
transition={{ duration: motionTokens.duration.fast, ease: motionTokens.easing.smooth }}
>
{children}
</motion.div>
);
}
function FocusRing({ children }: { children: React.ReactNode }) {
return (
<motion.div
whileFocus={{
boxShadow: '0 0 0 3px rgba(59, 130, 246, 0.5)',
}}
transition={{ duration: motionTokens.duration.instant }}
>
{children}
</motion.div>
);
}Loading e Skeleton
import { motion, AnimatePresence } from 'framer-motion';
import { motionTokens } from '@/lib/motion-tokens';
function SkeletonToContent({
isLoading,
skeleton,
children,
}: {
isLoading: boolean;
skeleton: React.ReactNode;
children: React.ReactNode;
}) {
return (
<AnimatePresence mode="wait">
{isLoading ? (
<motion.div
key="skeleton"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
transition={{ duration: motionTokens.duration.fast }}
>
{skeleton}
</motion.div>
) : (
<motion.div
key="content"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
transition={{ duration: motionTokens.duration.normal }}
>
{children}
</motion.div>
)}
</AnimatePresence>
);
}
function SpinnerRotate({ size = 24 }: { size?: number }) {
return (
<motion.div
animate={{ rotate: 360 }}
transition={{
duration: motionTokens.duration.dramatic,
repeat: Infinity,
ease: 'linear',
}}
style={{ width: size, height: size }}
className="border-2 border-gray-300 border-t-blue-500 rounded-full"
/>
);
}Animações Baseadas em Scroll
import { motion } from 'framer-motion';
import { motionTokens } from '@/lib/motion-tokens';
function ScrollFadeIn({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 30 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: '-50px' }}
transition={{
duration: motionTokens.duration.slow,
ease: motionTokens.easing.smooth,
}}
>
{children}
</motion.div>
);
}Scroll-Driven Complexo — GSAP ScrollTrigger
Framer Motion whileInView cobre fade/slide-on-scroll simples (ver ScrollFadeIn acima). Para scroll-driven coreografado (pin de seção, scrub vinculado ao progresso do scroll, transições entre cards empilhados), GSAP + ScrollTrigger é a ferramenta certa — Framer Motion não tem pin/scrub nativos com o mesmo controle.
Isso cobre a mecânica pontual. Quando o pedido é a página inteira estruturada como jornada de scroll — scrollytelling completo, landing page estilo Apple, vídeo que escruba com o scroll, variedade de efeito por seção — ver skills/64-scroll-storytelling/SKILL.md. Ela é dona da arquitetura (gramática de página, entrevista de brief, engine próprio data-sc-*); esta skill (12) permanece dona de motion tokens, easing e ScrollTrigger genéricos.
Regra dura: nunca escutar scroll manualmente (window.addEventListener('scroll') em estado React) para dirigir animação — sempre ScrollTrigger (ou useScroll/IntersectionObserver para o caso simples). Listener manual perde sincronia de frame e não limpa corretamente.
Quando o custo de movimento for relevante, consulte skills/92-design-director/references/evidencia-e-captura.md: observe rotas e posições reais, loops e recursos fora da tela, retomada, limpeza e movimento reduzido. Relate medições e limites sem prometer melhora não medida.
Sticky-stack (cards empilhando ao rolar)
import { useEffect, useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
export function useStickyStack(cardRefs: React.RefObject<HTMLElement>[]) {
useEffect(() => {
const triggers = cardRefs.map((ref, i) => {
if (!ref.current) return null;
return ScrollTrigger.create({
trigger: ref.current,
start: 'top top',
pin: true,
pinSpacing: false,
animation: gsap.to(ref.current, {
scale: 0.92,
opacity: 0.6,
ease: 'none',
}),
endTrigger: cardRefs[i + 1]?.current || undefined,
end: 'top top',
scrub: true,
});
});
return () => triggers.forEach((t) => t?.kill());
}, [cardRefs]);
}Horizontal-pan (seção que rola na horizontal)
export function useHorizontalPan(containerRef: React.RefObject<HTMLElement>, distance: number) {
useEffect(() => {
if (!containerRef.current) return;
const panel = containerRef.current;
const track = panel.querySelector<HTMLElement>('[data-pan-track]');
if (!track) return;
const tween = gsap.to(track, {
x: -distance,
ease: 'none',
scrollTrigger: {
trigger: panel,
start: 'top top',
pin: true,
scrub: 1,
end: `+=${distance}`,
},
});
return () => tween.scrollTrigger?.kill();
}, [containerRef, distance]);
}Sempre limpar (.kill()) no cleanup do useEffect — trigger órfão continua calculando em resize/unmount e vaza memória. Isolar GSAP em Client Components ("use client"), nunca em Server Components.
Regras de Performance
- NUNCA animar
width,height,top,left,margin,padding - SEMPRE animar
transform(translate, scale, rotate) eopacity - Usar
will-changecom moderação e apenas quando necessário - Desabilitar animações para
prefers-reduced-motion - Manter 60fps em todas as animações
- Limitar stagger a no máximo 10 itens visíveis por vez
.animated-element {
will-change: transform, opacity;
}
.animated-element.done {
will-change: auto;
}Um verbo de movimento por elemento
Mesmo princípio de prompt de vídeo cinematográfico (skill 27) aplicado a UI: animar um elemento simultaneamente em translate + scale + rotate + opacity dilui a leitura do movimento — o olho não consegue separar qual mudança carrega o significado. Escolher um verbo dominante por elemento animado (entra deslizando, OU cresce, OU gira) e usar os demais atributos como suporte sutil (opacity acompanhando, não competindo).
Determinismo em animação gerada/randômica
Quando a animação usa posição, delay ou seed aleatórios (partículas, confete, stagger com jitter), fixar a seed (Math.random() substituído por um PRNG seedado, ex. mulberry32) sempre que o resultado precisa ser reproduzível — comparar duas variações lado a lado, debugar um frame específico reportado por QA, ou re-renderizar um preview aprovado. Math.random() sem seed é aceitável só quando a variação a cada carregamento é o efeito desejado (ex: confete de celebração que nunca deve repetir o mesmo padrão).
Hook de Reduced Motion
import { useEffect, useState } from 'react';
export function useReducedMotion(): boolean {
const [prefersReduced, setPrefersReduced] = useState(false);
useEffect(() => {
const mediaQuery = window.matchMedia('(prefers-reduced-motion: reduce)');
setPrefersReduced(mediaQuery.matches);
const handler = (event: MediaQueryListEvent) => {
setPrefersReduced(event.matches);
};
mediaQuery.addEventListener('change', handler);
return () => mediaQuery.removeEventListener('change', handler);
}, []);
return prefersReduced;
}import { useReducedMotion } from '@/hooks/useReducedMotion';
function AnimatedComponent({ children }: { children: React.ReactNode }) {
const prefersReduced = useReducedMotion();
return (
<motion.div
initial={prefersReduced ? false : { opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={
prefersReduced
? { duration: 0 }
: { duration: motionTokens.duration.normal, ease: motionTokens.easing.smooth }
}
>
{children}
</motion.div>
);
}Hierarquia de Animação
A ordem de entrada dos elementos segue a hierarquia visual:
1. Página → Fade/slide da página inteira
2. Seções → Stagger das seções principais
3. Componentes → Entrada individual de cards, listas, etc.
4. Conteúdo → Texto, ícones, badges dentro dos componentesCada nível espera o anterior iniciar antes de começar. Usar delayChildren e staggerChildren para orquestrar a cascata.
const sectionVariants: Variants = {
hidden: { opacity: 0 },
visible: {
opacity: 1,
transition: {
staggerChildren: motionTokens.stagger.slow,
delayChildren: motionTokens.duration.fast,
},
},
};
const componentVariants: Variants = {
hidden: { opacity: 0, y: 20 },
visible: {
opacity: 1,
y: 0,
transition: {
duration: motionTokens.duration.normal,
ease: motionTokens.easing.smooth,
staggerChildren: motionTokens.stagger.fast,
},
},
};
const contentVariants: Variants = {
hidden: { opacity: 0 },
visible: {
opacity: 1,
transition: { duration: motionTokens.duration.fast },
},
};Continuidade de Objeto — Shared Element e FLIP
Quando o mesmo objeto aparece em dois estados (card na lista → detalhe; thumbnail → player; item que muda de posição ao filtrar), a animação certa preserva a identidade dele em vez de destruir e recriar. O usuario acompanha o objeto com os olhos e nao perde o contexto de origem.
| Situacao | Padrao | Por que |
| Card → tela de detalhe | Shared element / container transform | O card vira a tela; a origem fica óbvia |
| Item muda de posicao (filtro, ordenacao, reorder) | FLIP / layout animation | Preserva a identidade; fade+remount faz parecer lista nova |
| Thumbnail → media em tela cheia | Shared element na imagem | A imagem é o objeto; o resto é moldura |
| Troca de contexto sem relacao | Crossfade curto | Nao existe objeto compartilhado para preservar |
FLIP (First, Last, Invert, Play) mede a posicao antes e depois da mudanca no DOM e anima a diferenca — o layout real acontece instantaneamente, so a percepcao é animada. Em React com motion, a prop layout faz isso automaticamente; em DOM puro, GSAP Flip ou getBoundingClientRect manual.
Stagger em lista que reordena precisa ser mínimo — algo em torno de 15ms entre itens. Stagger de 50-100ms numa lista de 10 itens faz o ultimo esperar quase um segundo e transforma uma operacao de dados em apresentacao.
A direcao da transicao deve codificar a estrutura, nao ser sempre "de baixo pra cima": aprofundar segue a arquitetura da navegacao, voltar é a inversao exata da entrada, abrir a partir de um elemento nasce naquele elemento.
Morphing de Ícone-pra-Ícone
Caso especifico de continuidade de objeto (ver tabela acima): quando o icone em si troca de forma pra comunicar mudanca de estado — play↔pause, hamburguer↔X, coracao vazio↔cheio, chevron que gira. So faz sentido quando os dois icones representam o mesmo conceito em dois estados reconheciveis; nao use pra trocar entre icones sem relacao semantica (isso e so um crossfade).
Interpolar d de um path pro outro manualmente distorce a forma em transito (encolhe, cisalha). Pra esse caso pontual, usar morphicons (MIT, zero dependencia, ~7KB) em vez de reinventar a interpolacao — ele resolve rotacao e correspondencia de pontos automaticamente (Procrustes 2D + interpolacao polar), funciona com icones stroke-based (Lucide, Tabler, Heroicons, Iconoir):
import { MorphIcon } from "morphicons/react";
import { Menu, X } from "lucide"; // data, nao componentes — usar o pacote "lucide", nao "lucide-react"
<button onClick={() => setOpen(o => !o)} aria-expanded={open}>
<MorphIcon icon={open ? X : Menu} spring="snappy" />
</button>Modo uncontrolled (acima) cobre a maioria dos casos: o prop icon muda e a lib anima sozinha. Existe tambem modo controlled (from/to/progress, pra scroll/gesture) e imperativo (ref.current.morphTo(icon) pra sequencias). Bindings equivalentes existem pra Vue, Svelte, React Native, Astro e web component puro (<morph-icon>), alem do driver vanilla createMorph sem framework. Spring aceita preset ("snappy", "gentle", etc.) ou { stiffness, damping } customizado.
Ressalva de acessibilidade — default da lib diverge do padrao desta skill. Por padrao (reducedMotion="never"), a lib anima o morph mesmo com prefers-reduced-motion: reduce ativo no SO, sob o argumento de que morph de icone e uma micro-transicao pequena e comunicativa, nao movimento de tela cheia. Isso conflita com a regra geral desta skill (ver "Limites de Seguranca — Flash e Movimento Vestibular" e o hook useReducedMotion acima: sempre respeitar prefers-reduced-motion). Pra manter consistencia com essa regra, passar explicitamente reducedMotion="user" em todo uso — isso faz o morph degradar pra troca instantanea quando o SO pede movimento reduzido, sem perder a comunicacao do estado (o icone final ainda aparece, so sem a trajetoria animada).
Feedback Multimodal — Haptic e Som
Visual, haptic e som devem parecer um unico evento, nao tres. Feedback dessincronizado é percebido como defeito de hardware.
visual → onde e o que mudou
haptic → que um evento discreto aconteceu
som → evento relevante mesmo fora do foco visualRegra de redundancia (nao negociavel): nenhum erro, sucesso ou alerta critico pode existir so em som ou so em haptic. Quem esta no silencioso, com deficiencia auditiva, ou com haptic desligado precisa receber a mesma informacao.
Haptic — "menos é mais". Vibracao demais irrita, distrai e produz habituacao (o usuario para de perceber):
| Evento | Haptic |
| Botao comum | Nenhum |
| Toggle importante, snap de slider | Leve e preciso |
| Conclusao de operacao | Sucesso |
| Erro destrutivo | Padrao de alerta/erro |
| Drag cruzando threshold | Impacto discreto |
| Scroll, navegacao comum, animacao decorativa | Nenhum |
Preferir a constante semantica da plataforma (HapticFeedbackConstants no Android, sensoryFeedback no SwiftUI) a inventar padrao de vibracao proprio — a plataforma mantem consistencia e tem fallback por hardware. Haptic ruim é pior que nenhum.
Timing: haptic de "input recebido" vai no press; haptic de "acao concluida" vai no resultado, nunca no press — senao mente sobre o que aconteceu.
Som serve quando a informacao precisa sobreviver a ausencia de foco visual, o evento é raro e importante, e existe metafora clara. Nunca em hover, navegacao comum ou ambiente continuo. Audio que inicia sozinho e dura mais de 3s precisa de controle de pausa/volume (WCAG 1.4.2), e audio concorrente atrapalha leitor de tela.
Limites de Seguranca — Flash e Movimento Vestibular
Estes nao sao preferencia estetica; sao risco de saude.
Flash (WCAG 2.3.1, nivel A): nada pode piscar mais de 3 vezes por segundo, salvo abaixo dos limiares de flash geral e vermelho. Acima disso ha risco de convulsao fotossensitiva. Afeta: transicao piscante, loading que alterna cor rapido, video/GIF autoplay, efeito estroboscopico.
Movimento vestibular: parallax, zoom grande, rotacao e deslocamento de tela inteira podem causar tontura, nausea e enxaqueca em quem tem disturbio vestibular. Por isso prefers-reduced-motion nao é opcional em produto que usa esses efeitos.
Reduced motion nao é animation: none global. A implementacao correta preserva a informacao e remove o deslocamento:
.modal { animation: modal-enter 260ms cubic-bezier(.16,1,.3,1); }
@keyframes modal-enter {
from { opacity: 0; transform: translateY(18px) scale(.985); }
to { opacity: 1; transform: none; }
}
@media (prefers-reduced-motion: reduce) {
/* Mantem o "apareceu", remove o deslocamento espacial */
.modal { animation: modal-reduced 90ms linear; }
@keyframes modal-reduced { from { opacity: 0 } to { opacity: 1 } }
}Asset animado (Lottie, Rive, video) tambem precisa respeitar: em reduced motion, mostrar o frame final em vez de tocar a trajetoria. A preferencia deve virar um token global que a aplicacao inteira le, incluindo bibliotecas externas.
Checkpoint antes de considerar a animação pronta: ligar prefers-reduced-motion: reduce no DevTools (ou emular no sistema) e revisitar cada tela animada — se algo ainda deslocar, girar ou fazer parallax de tela inteira, a @media query não cobriu aquele efeito. Corrigir o CSS/asset faltante e testar de novo com a preferência ligada, não só declarar que "reduced motion está implementado" porque a media query existe em algum arquivo.
Quando NAO Animar
O criterio mais importante desta skill. Animação tem custo — de atencao, de tempo e de frame budget.
Nao animar quando:
- A tarefa é repetitiva e o usuario é experiente. Animacao que "explica" o mesmo evento pela centesima vez virou latencia pura. 300ms numa operacao feita 100 vezes ao dia é meia hora de espera por mes
- A animacao esconde dado. Reordenar tabela justifica continuidade; fazer cada celula entrar com stagger, nao
- Varios elementos ja competem por atencao. Movimento tem saliencia alta — animar tudo é nao priorizar nada
- O usuario esta digitando ou decidindo algo critico. Nunca deslocar layout sob o cursor ou o foco
- O sistema esta em erro critico. Primeiro torne a mensagem legivel; erro nao é espetaculo
- A unica justificativa é "fica premium". Isso nao é hipotese testavel
- A animacao causa jank ou layout shift. Transicao simples e estavel comunica mais qualidade que animacao sofisticada a 30fps
Regra de bloqueio: animacao ornamental nunca pode impedir a proxima interacao. Em tarefa frequente, o movimento precisa ser interrompivel — o input do usuario tem prioridade sobre a animacao em curso.
Teste final da linguagem de motion: quando o movimento é removido, o produto continua claro; quando é restaurado, passa a parecer inequivocamente ele mesmo. Se remover quebra o entendimento, o motion esta carregando informacao que deveria estar na estrutura. Se restaurar nao muda nada, o motion é decoracao.
Evidencia de Conclusao
- movimento com intencao clara
prefers-reduced-motionconsiderado- impacto em performance e QA destacado
Handoff
Recebe do Frontend
- Componentes implementados e funcionais
- Estrutura de páginas com rotas definidas
- Estados de loading/skeleton existentes
- Lista de interações que precisam de animação
Motion NAO cria componentes novos — adiciona animacao e transicoes aos componentes existentes do Frontend. O codigo de motion e adicionado ao MESMO codebase do Frontend. Apos Motion finalizar, o repositorio do Frontend contem os componentes com animacao integrada.
Entrega para Copy/Marketing
- Componentes com animações aplicadas e funcionais
- Motion tokens documentados para consistência
- Padrões de micro-interação implementados
- Animações de scroll e transições de página prontas
Regra de Código Limpo
ZERO comentários no código. O código deve ser autoexplicativo através de:
- Nomes descritivos de variantes e tokens
- Separação clara de responsabilidades por arquivo
- Tipos TypeScript expressivos
- Estrutura previsível e consistente
Efeitos Vanilla — Referência de Código (naocodei.com)
Aviso de proveniência. Código de https://naocodei.com/free-code/, licença não declarada, autoria não identificada, risco assumido pelo usuário em 2026-08-23. Ver
references/naocodei-vanilla-effects.md.
5 efeitos JS puro: stack cards, rolagem com inércia, partículas em canvas, scramble de texto, shader WebGL fluido. Dependência zero.
Laboratorio de Microinteracoes (GSAP, referencia viva)
references/ui-motion-lab-gsap.html — HTML standalone, 16 padroes em GSAP, gramatica desta skill (press 110ms, exit 170ms, normal 240ms, enter 300ms). Padroes: press+ripple, modal, drawer, dropdown, accordion, tabs, chat optimistic, busca+skeleton, toast, transicao, CRUD de lista, botao async, shake, like+particulas, progresso, regras.
Gate de Decisao, Vocabulario e Review (referencia)
references/decision-gate-and-review.md — gate de 4 perguntas (frequencia, proposito, velocidade, funcao) pra decidir SE algo deve animar, com varredura por categoria de seam; glossario reverso de ~50 termos de motion (rubber-banding, shared element transition, number ticker etc.); e checklist de review com 10 padroes nao-negociaveis e hierarquia de remediacao em cascata (deletar → reduzir → easing → origem → interrompibilidade → GPU → timing assimetrico → polish → acessibilidade), incluindo teto de 300ms em UI e o anti-padrao scale(0).
View Transition API Nativa (referencia)
references/view-transitions-api.md — API nativa do browser exposta pelo React (<ViewTransition>, addTransitionType, shared element morphing por name, integracao transitionTypes no next/link). Entra quando a mudanca e estrutural (troca de rota, lista→detalhe, reveal pos-Suspense) e nao precisa de Framer Motion/GSAP; nao substitui o sistema de motion tokens desta skill, complementa em cenarios especificos.
Fontes Externas
- Skeletons de GSAP ScrollTrigger inspirados em Leonxlnx/taste-skill.
- Morphing de icone via guillermolg00/morphicons (MIT).
- 5 efeitos vanilla JS de naocodei.com/free-code — licença não declarada, autoria não identificada. Ver
references/naocodei-vanilla-effects.md. - Laboratorio de 16 padroes (
references/ui-motion-lab-gsap.html) — autoria do usuario, sem restricao de licenca, colado em 2026-08-26. - Gate de decisao, vocabulario e checklist de review adaptados de emilkowalski/skills (MIT):
find-animation-opportunities→ Parte 1-3 (gate de 4 perguntas + varredura por seam),animation-vocabulary→ Parte 4 (glossario),review-animations(+STANDARDS.md) → Parte 5 (checklist com hierarquia de remediacao). Verreferences/decision-gate-and-review.md. - View Transition API nativa adaptada de vercel-labs/agent-skills (MIT), skill
react-view-transitions. Verreferences/view-transitions-api.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

