Communitygithub.com

Motion (Framer Motion) — Compétence

Implémentez des animations fluides et accessibles avec motion/react (Framer Motion) dans React. À utiliser pour ajouter des animations, des gestes ou des transitions de mise en page avec motion, AnimatePresence, useScroll et les API associées. Nécessite une frontière 'use client' ; ne convient pas pour les composants rendus uniquement côté serveur ou lorsqu'aucune animation n'est nécessaire.

Qu'est-ce que Motion (Framer Motion) — Compétence ?

Cette compétence pour AI agents (Claude Code, Cursor, Codex) permet aux développeurs React d'implémenter des animations fluides et accessibles avec la bibliothèque Framer Motion, en particulier `motion/react`. Elle définit des règles strictes : les animations doivent être encapsulées dans des composants `'use client'` pour respecter l'architecture React Server Components, les préférences de mouvement réduit (`useReducedMotion()`) doivent être prises en compte, et les transitions doivent utiliser les outils adaptés (`AnimatePresence` pour les entrées/sorties, `layout` pour les animations de mise en page). La compétence propose des checklists d'implémentation et de révision, ainsi que des exemples minimaux de code (entrée/sortie, mise en page, accessibilité). Elle met également en garde contre les erreurs courantes comme l'absence d'`AnimatePresence` lors des démontages ou l'extension inutile de l'arbre client. Idéale pour les agents IA qui génèrent ou refactorisent du code React avec animations.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/motion

Demander à votre IA préférée

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

Documentation

Que fait Motion (Framer Motion) — Compétence ?

Nom : motion Objectif : Implémenter des animations fluides et accessibles avec motion/react dans React. Utilisez cette compétence pour ajouter des animations, des gestes ou des transitions de mise en page.

À utiliser lorsque : Vous utilisez motion/react (motion, AnimatePresence, useScroll, etc.). Ne pas utiliser lorsque : Aucune animation n'est nécessaire ou le composant est strictement rendu côté serveur.

Règles

  • Limite client uniquement : Motion nécessite 'use client' ; conservez des îlots clients petits.
  • Commencez simple : Débutez par l'opacité/translation avant d'ajouter la physique des ressorts.
  • Utilisez le bon outil : AnimatePresence pour les entrées/sorties, layout pour la mise en page, whileHover/whileTap pour les gestes.
  • Respectez le mouvement réduit : Utilisez useReducedMotion().
  • Discipline de bundle : Utilisez LazyMotion pour les grandes surfaces d'animation.

Flux de travail

  1. Identifiez l'objectif UX (retour, transition, focus).
  2. Ajoutez la plus petite limite 'use client'.
  3. Implémentez correctement les transitions d'entrée/sortie ou de mise en page.
  4. Respectez les préférences de mouvement réduit.
  5. Vérifiez les performances et la taille du bundle.

Listes de contrôle

Liste de contrôle d'implémentation

  • 'use client' seulement là où c'est nécessaire
  • Comportement de mouvement réduit défini
  • AnimatePresence encapsule l'interface conditionnelle
  • Les transitions de mise en page utilisent layout

Liste de contrôle de révision

  • Les animations ne se relancent pas à chaque rendu
  • Le code Motion n'étend pas inutilement l'arbre client

Exemples minimaux

Entrée/Sortie

"use client";

import { AnimatePresence, motion } from "motion/react";

export function Toast({
  open,
  children,
}: {
  open: boolean;
  children: React.ReactNode;
}) {
  return (
    <AnimatePresence>
      {open ? (
        <motion.div
          initial={{ opacity: 0, y: 8 }}
          animate={{ opacity: 1, y: 0 }}
          exit={{ opacity: 0, y: 8 }}
          transition={{ duration: 0.18 }}
        >
          {children}
        </motion.div>
      ) : null}
    </AnimatePresence>
  );
}

Animation de mise en page

"use client";

import { motion } from "motion/react";

export function Expander({ open }: { open: boolean }) {
  return (
    <motion.div layout className="overflow-hidden rounded-md border p-3">
      <div className="font-medium">Titre</div>
      {open ? <div className="mt-2 text-sm">Plus de contenu...</div> : null}
    </motion.div>
  );
}

Mouvement réduit

"use client";

import { motion, useReducedMotion } from "motion/react";

export function FadeIn({ children }: { children: React.ReactNode }) {
  const reduce = useReducedMotion();
  return (
    <motion.div
      initial={reduce ? false : { opacity: 0, y: 6 }}
      animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
      transition={{ duration: 0.2 }}
    >
      {children}
    </motion.div>
  );
}

Erreurs et pièges courants

  • Démontage sans AnimatePresence (les animations de sortie ne se déclenchent jamais)
  • Animation de mise en page sans layout
  • Placer Motion dans un énorme arbre client
  • Animer de grandes listes sans virtualisation

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills associés