Communitygithub.com

Cody-W-Tucker/skills

Patrons d'animation prêts pour la production pour React / Next.js — bouton, modale, toast, défilement, animations de page, entrée/sortie et layout — construits sur les tokens et ressorts de motion-foundations.

Qu'est-ce que skills ?

Cette compétence fournit un ensemble complet de patrons d'animation React prêts pour la production, conçus pour fonctionner avec `motion-foundations` dans React et Next.js (App Router). Elle couvre les animations les plus courantes : retours de bouton, listes à défilement progressif, modales accessibles, piles de notifications, transitions de page, révélations au scroll, barres de progression, cartes extensibles et accordéons. Le coeur de la compétence réside dans son adhésion à des règles strictes qui garantissent l'accessibilité, la compatibilité SSR et une sensation naturelle : tous les valeurs d'animation proviennent de tokens et de ressorts importés, les composants conditionnels sont systématiquement enveloppés dans `AnimatePresence` avec une clé et une animation de sortie, et les transitions de page utilisent `mode="wait"` pour un enchaînement propre. Des exemples de code prêts à être copiés-collés sont fournis pour chaque patron, ainsi que des conseils de décision pour choisir la bonne approche (AnimatePresence, layout, layoutId, whileInView). La compétence sert de solution unique pour tout développeur souhaitant ajouter des animations homogènes et maintenables à une application React sans retomber dans les pièges courants des animations CSS ou des frameworks non optimisés.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/motion-patterns

Demander à votre IA préférée

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

Documentation

Patrons de Mouvement (Motion Patterns)

Patrons copier-coller pour les besoins d'animation UI les plus courants. Chaque patron ici est construit sur les tokens et ressorts de motion-foundations. Ne définissez pas de nouvelles valeurs de durée ou d'assouplissement ici — importez-les.

Quand Activer

  • Animer un bouton, une carte, une modale ou une notification toast
  • Construire des entrées de liste avec décalage progressif (stagger)
  • Mettre en place des transitions de page dans le App Router Next.js
  • Ajouter des animations d'entrée ou de sortie à du contenu conditionnel
  • Implémenter des révélations au scroll, des progressions liées au scroll, ou des sections d'histoire collantes
  • Construire des cartes extensibles, des accordéons, ou des transitions d'élément partagé

Livrables

Cette compétence produit :

  • Des animations accessibles et compatibles SSR pour tous les composants UI standard
  • Des rendus conditionnels enveloppés dans AnimatePresence avec un comportement de sortie correct
  • Un composant d'encapsulation de transition de page pour le App Router Next.js
  • Des patrons de révélation au scroll et liés au scroll utilisant useScroll + useTransform
  • Des patrons d'animation de layout (layout, layoutId) pour l'expansion et le fondu enchaîné d'éléments

Principes

  • Chaque patron importe depuis motion-foundations. Pas de nombres bruts.
  • Chaque rendu conditionnel est enveloppé dans AnimatePresence avec une key.
  • Les animations de sortie sont toujours définies en même temps que les animations d'entrée — jamais après coup.
  • layout est utilisé uniquement pour de petits décalages isolés. Les grandes sous-arbres reçoivent des transformations explicites.

Règles

  1. Enveloppez toujours les rendus conditionnels dans AnimatePresence avec une key sur l'enfant direct. Sans clé, les animations de sortie ne se déclenchent jamais.
  2. Définissez toujours exit quand vous définissez initial + animate. Une animation sans sortie est incomplète.
  3. Utilisez mode="wait" pour les transitions de page. L'entrée ne doit pas commencer avant la fin de la sortie.
  4. N'utilisez jamais layout sur des sous-arbres de plus de ~5 enfants ou profondément imbriqués dans le DOM. Utilisez plutôt des transformations explicites x/y.
  5. L'intervalle de décalage (stagger) doit rester entre 0.05s et 0.10s. En dessous, cela semble mécanique ; au-dessus, cela semble lent.
  6. Les modales doivent toujours inclure : piège de focus, fermeture par Échap, verrouillage du scroll, role="dialog", aria-modal="true".
  7. Les révélations au scroll utilisent viewport={{ once: true }}. Répéter au défilement en arrière est distrayant, pas informatif.
  8. Toutes les valeurs de token sont importées de motion-foundations. Pas de nombres en ligne.

Guide de Décision

Choisir le bon patron

SituationPatron
Un élément apparaît / disparaîtAnimatePresence
Liste d'éléments chargés en séquenceVariants avec décalage (stagger)
Navigation entre routesEncapsuleur de transition de page
Un élément change de taille sur placePropriété layout
Même élément se déplace entre contextes de pagelayoutId
Un élément entre lorsqu'il est visible après défilementwhileInView
Valeur liée à la position de défilementuseScroll + useTransform

Quand utiliser mode="wait" vs mode="sync"

ModeUtiliser quand
waitTransitions de page, échanges de contenu (un à la fois)
syncNotifications empilées, éléments de liste (le chevauchement est acceptable)
popLayoutÉléments retirés d'une liste avec réorganisation

Concepts Clés

Contrat AnimatePresence

Trois choses doivent toujours être vraies :

  1. AnimatePresence enveloppe le conditionnel
  2. L'enfant direct a une key
  3. L'enfant a une propriété exit

Si l'une de ces conditions manque, l'animation de sortie échoue silencieusement.

layout vs layoutId

  • layout — anime le propre changement de taille/position de l'élément sur place
  • layoutId — lie deux éléments séparés, en créant un fondu enchaîné entre eux lors des rendus

Utilisez layout="position" sur le texte à l'intérieur d'un conteneur extensible pour empêcher l'animation du réarrangement du texte.

Exemples de Code

Retour de bouton

"use client"
import { motion } from "motion/react"
import { springs, motionTokens } from "@/lib/motion-tokens"

<motion.button
  whileHover={{ scale: motionTokens.scale.pop }}
  whileTap={{ scale: motionTokens.scale.press }}
  transition={springs.snappy}
/>

Liste avec décalage (Stagger)

"use client"
import { motion } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"

const container = {
  hidden: {},
  visible: {
    transition: {
      staggerChildren: 0.08,   // dans la règle 0.05–0.10
      delayChildren: 0.1,
    },
  },
}

const item = {
  hidden:  { opacity: 0, y: motionTokens.distance.md },
  visible: { opacity: 1, y: 0, transition: springs.gentle },
}

<motion.ul variants={container} initial="hidden" animate="visible">
  {items.map((i) => (
    <motion.li key={i.id} variants={item} />
  ))}
</motion.ul>

Modale

"use client"
import { motion, AnimatePresence } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"

// Envelopper au site d'appel :
// <AnimatePresence>{isOpen && <Modal key="modal" />}</AnimatePresence>

export function Modal({ onClose }: { onClose: () => void }) {
  return (
    <>
      {/* Superposition */}
      <motion.div
        className="fixed inset-0 bg-black/50"
        initial={{ opacity: 0 }}
        animate={{ opacity: 1 }}
        exit={{ opacity: 0 }}
        onClick={onClose}
      />

      {/* Panneau — exigences d'accessibilité : piège de focus, fermeture par Échap,
          verrouillage du scroll, role="dialog", aria-modal="true" */}
      <motion.div
        role="dialog"
        aria-modal="true"
        className="fixed inset-x-4 top-1/2 -translate-y-1/2 rounded-xl bg-white p-6"
        initial={{
          opacity: 0,
          scale: motionTokens.scale.press,
          y: motionTokens.distance.sm,
        }}
        animate={{ opacity: 1, scale: 1, y: 0 }}
        exit={{
          opacity: 0,
          scale: motionTokens.scale.press,
          y: motionTokens.distance.sm,
        }}
        transition={springs.gentle}
      />
    </>
  )
}

Pile de toasts

"use client"
import { motion, AnimatePresence } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"

<AnimatePresence mode="sync">
  {toasts.map((t) => (
    <motion.div
      key={t.id}
      layout
      initial={{
        opacity: 0,
        x: motionTokens.distance.xl,
        scale: motionTokens.scale.subtle,
      }}
      animate={{ opacity: 1, x: 0, scale: 1 }}
      exit={{
        opacity: 0,
        x: motionTokens.distance.xl,
        scale: motionTokens.scale.subtle,
      }}
      transition={springs.snappy}
    />
  ))}
</AnimatePresence>

Transition de page (Next.js App Router)

// components/page-transition.tsx
"use client"
import { motion, AnimatePresence } from "motion/react"
import { usePathname } from "next/navigation"
import { motionTokens } from "@/lib/motion-tokens"

const variants = {
  initial: { opacity: 0, y: motionTokens.distance.sm },
  enter:   { opacity: 1, y: 0 },
  exit:    { opacity: 0, y: -motionTokens.distance.sm },
}

export function PageTransition({ children }: { children: React.ReactNode }) {
  const pathname = usePathname()
  return (
    <AnimatePresence mode="wait">
      <motion.div
        key={pathname}
        variants={variants}
        initial="initial"
        animate="enter"
        exit="exit"
        transition={{
          duration: motionTokens.duration.normal,
          ease: motionTokens.easing.smooth,
        }}
      >
        {children}
      </motion.div>
    </AnimatePresence>
  )
}

Révélation au scroll

"use client"
import { motion } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"

<motion.div
  initial={{ opacity: 0, y: motionTokens.distance.lg }}
  whileInView={{ opacity: 1, y: 0 }}
  viewport={{ once: true, margin: "-80px" }}   // once: true — règle 7
  transition={{ duration: motionTokens.duration.slow, ease: motionTokens.easing.smooth }}
/>

Barre de progression au scroll

"use client"
import { motion, useScroll } from "motion/react"

export function ScrollProgress() {
  const { scrollYProgress } = useScroll()
  return (
    <motion.div
      className="fixed top-0 left-0 h-1 bg-indigo-500 origin-left w-full"
      style={{ scaleX: scrollYProgress }}
    />
  )
}

Carte extensible

"use client"
import { useState } from "react"
import { motion, AnimatePresence } from "motion/react"
import { springs, motionTokens } from "@/lib/motion-tokens"

export function ExpandingCard({ title, body }: { title: string; body: string }) {
  const [expanded, setExpanded] = useState(false)

  return (
    <motion.div layout onClick={() => setExpanded(!expanded)} className="cursor-pointer">
      {/* layout="position" empêche l'animation du réarrangement du texte */}
      <motion.h2 layout="position" className="font-semibold">
        {title}
      </motion.h2>

      <AnimatePresence>
        {expanded && (
          <motion.p
            key="body"
            initial={{ opacity: 0 }}
            animate={{ opacity: 1 }}
            exit={{ opacity: 0 }}
            transition={{ duration: motionTokens.duration.fast }}
          >
            {body}
          </motion.p>
        )}
      </AnimatePresence>
    </motion.div>
  )
}

Fondu enchaîné d'élément partagé

// Contexte source
<motion.img layoutId="hero-image" src={src} className="w-16 h-16 rounded" />

// Contexte de destination (même layoutId — motion gère la transition)
<motion.img layoutId="hero-image" src={src} className="w-full rounded-xl" />

Accordéon

<motion.div
  initial={false}
  animate={{ opacity: open ? 1 : 0, scaleY: open ? 1 : 0 }}
  style={{ transformOrigin: "top", overflow: "hidden" }}
  transition={{
    duration: motionTokens.duration.normal,
    ease: motionTokens.easing.smooth,
  }}
>
  {children}
</motion.div>

Exemple Bout-en-Bout

Une liste à décalage progressif qui s'affiche au montage, gère la présence conditionnelle et respecte le mouvement réduit — combinant tokens, ressorts, AnimatePresence et le hook d'accessibilité de motion-foundations :

"use client"
import { useState } from "react"
import { motion, AnimatePresence } from "motion/react"
import { motionTokens, springs } from "@/lib/motion-tokens"
import { useSafeMotion } from "@/hooks/use-reduced-motion"

const containerVariants = {
  hidden: {},
  visible: {
    transition: { staggerChildren: 0.08, delayChildren: 0.1 },
  },
}

function ListItem({ label, onRemove }: { label: string; onRemove: () => void }) {
  const safe = useSafeMotion(motionTokens.distance.sm)
  return (
    <motion.li
      variants={{
        hidden:  safe.initial,
        visible: safe.animate,
      }}
      exit={safe.exit}
      transition={springs.gentle}
      className="flex items-center justify-between p-3 rounded-lg bg-white shadow-sm"
    >
      <span>{label}</span>
      <button onClick={onRemove}>Supprimer</button>
    </motion.li>
  )
}

export function AnimatedList({ items, onRemove }: {
  items: { id: string; label: string }[]
  onRemove: (id: string) => void
}) {
  return (
    <motion.ul
      variants={containerVariants}
      initial="hidden"
      animate="visible"
      className="space-y-2"
    >
      <AnimatePresence mode="popLayout">
        {items.map((item) => (
          <ListItem
            key={item.id}
            label={item.label}
            onRemove={() => onRemove(item.id)}
          />
        ))}
      </AnimatePresence>
    </motion.ul>
  )
}

Contraintes / Non-Objectifs

Cette compétence ne couvre pas :

  • Les définitions de tokens et ressorts → voir motion-foundations
  • Les interactions de glissement, gestes de balayage, listes réorganisables → voir motion-advanced
  • Les animations de texte (révélation mot/caractère, compteurs) → voir motion-advanced
  • Le dessin de chemins SVG ou le morphing → voir motion-advanced
  • Les hooks d'animation personnalisés → voir motion-advanced
  • Les transitions CSS uniquement sans utiliser motion/react

Anti-Patterns

Anti-patternRègle violéeCorrection
Enfant de AnimatePresence sans keyRègle 1Ajouter une key stable à l'enfant direct
initial + animate sans exitRègle 2Toujours définir les trois ensemble
Transition de page sans mode="wait"Règle 3Ajouter mode="wait" à AnimatePresence
layout sur une liste de 50 élémentsRègle 4Utiliser mode="popLayout" ou des transformations explicites
staggerChildren: 0.2 sur une liste de 10 élémentsRègle 5Limiter à 0.08–0.10
Modale sans piège de focusRègle 6Ajouter focus-trap-react ou Radix Dialog
whileInView sans viewport={{ once: true }}Règle 7Les entrées répétitives distraient, n'informent pas
transition={{ duration: 0.3 }} en ligneRègle 8Utiliser motionTokens.duration.normal

Compétences Liées

  • motion-foundations — définit tous les tokens, ressorts, le hook useSafeMotion et les gardes SSR que chaque patron importe ici. Doit être configuré en premier.
  • motion-advanced — étend ces patrons avec le glissement, les gestes, SVG, le texte, les hooks personnalisés et le séquençage impératif. Ne redéfinit aucun patron de cette compétence.

Individual skills in this repo

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

Cody-W-Tucker/skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, conversion rate, or landing page optimization.

Cody-W-Tucker/skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign.

Cody-W-Tucker/skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, Demand Gen, and Connected TV formats. Covers VAC→Demand Gen migration, Shorts creative requirements, and CTV shoppable ads. Use when user says YouTube Ads, video ads, pre-roll, bumper ads, YouTube campaign, Shorts ads, or CTV ads.

Cody-W-Tucker/skills

Craft the story that makes investors say \"I want in.\" Master the narrative structure that Reid Hoffman, Sequoia, and top founders use to raise capital. Use when: **Preparing to fundraise** to develop your story before the deck; **Investor meetings** to structure conversations that convert; **Pitch practice** to refine your narrative arc; **Cold outreach** to write compelling investor emails; **Pivoting** to reframe your story after a change

Cody-W-Tucker/skills

Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns.

Cody-W-Tucker/skills

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Cody-W-Tucker/skills

Optimize landing pages for maximum conversions using proven frameworks from Unbounce and Oli Gardner—apply the \"one goal, one message, one action\" principle with data-driven design, copy, and CTA best practices. Use when: **Create a new landing page** for a campaign; **Optimize an existing landing page** that isn't converting; **Review landing page design** before launch; **Improve form conversion rates** on lead gen pages; **A/B test landing page elements** systematically

Cody-W-Tucker/skills

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

Cody-W-Tucker/skills

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

Cody-W-Tucker/skills

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Cody-W-Tucker/skills

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

Cody-W-Tucker/skills

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Cody-W-Tucker/skills

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Cody-W-Tucker/skills

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Master April Dunford's 8-step sales narrative from \"Sales Pitch\" (2023). Transform your positioning into a compelling story that wins enterprise deals. Use when: Structuring B2B sales presentations and demos; Creating pitch decks for complex products; Training sales teams on narrative-driven selling; Converting positioning strategy into sales conversations; Winning against entrenched competitors

Cody-W-Tucker/skills

Swiss-style user-research narrative template in warm-paper editorial aesthetics. Use when users ask for a premium research deck or story-first live artifact with minimalist typography, high-clarity layout, subtle motion, donut breakdowns, and keyboard/click navigation across slides in a single HTML file.

Cody-W-Tucker/skills

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

Cody-W-Tucker/skills

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.

Skills associés