Communitygithub.com

use_figma — Compétence d'animation pour l'API Figma

Contexte d'animation/mouvement pour l'outil MCP `use_figma` — animer des nœuds Figma via des images clés manuelles, styles d'animation, easing et durée de timeline. Chargez-la avec figma-use lorsque la tâche implique d'ajouter, modifier ou inspecter une animation sur un nœud.

Qu'est-ce que use_figma — Compétence d'animation pour l'API Figma ?

Cette compétence étend l'outil MCP `use_figma` avec la prise en charge de l'animation. Elle permet de manipuler les images clés manuelles (lecture/écriture via `manualKeyframeTracks`, `applyManualKeyframeTrack`, `removeManualKeyframeTrack`), d'appliquer des styles d'animation (`applyAnimationStyle`, `removeAnimationStyle`, `animationStyles`), de gérer la durée des timelines (`node.timelines` / `node.setTimelineDuration`) et de configurer l'easing (courbes cubiques, ressort). Elle est utile dès qu'une tâche implique l'ajout, la modification ou l'inspection d'un mouvement sur un nœud Figma. Plateformes prises en charge : Figma via l'API Plugin officielle (avec le drapeau de fonctionnalité `metronome_plugin_api`). Fonctionnement : la compétence se charge en même temps que `figma-use` en passant `skillNames: "figma-use-motion"` dans l'appel à `use_figma`. Elle guide l'agent pas à pas : vérifier l'éligibilité de l'utilisateur, choisir le bon easing public, ne jamais raccourcir les timelines, et surtout éviter les appels coûteux à `export_video` en planifiant soigneusement avant chaque rendu. En cas d'erreur "n'est pas une API prise en charge", il faut abandonner immédiatement sans réessayer. La compétence inclut aussi une checklist pré-vol pour éviter les erreurs courantes (noms d'énumérations internes, types d'easing invalides, animation de nœuds racine). Enfin, elle précise comment vérifier l'animation : ne pas utiliser `get_screenshot` (repos uniquement), mais `export_video` avec échantillonnage d'images réduit, en itérant par lots plutôt qu'image par image.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/figma/ebentley-figma/skills/figma-use-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 use_figma — Compétence d'animation pour l'API Figma ?

Contexte d'animation pour l'outil MCP use_figma. figma-use couvre les règles de base de l'API Plugin — chargez les deux ensemble.

Passez toujours skillNames: "figma-use-motion" (séparé par une virgule avec figma-use) lorsque vous appelez use_figma pour du travail d'animation. Uniquement pour la journalisation.

Barrière d'exécution

Les API d'animation sont protégées par le drapeau de fonctionnalité utilisateur metronome_plugin_api. Si l'utilisateur appelant ne le possède pas, chaque propriété et helper d'animation référencé dans cette compétence lève une erreur "<name>" n'est pas une API prise en charge.

Abandonnez rapidement sur cette erreur. Ne réessayez pas ; dites à l'utilisateur que l'animation n'est pas activée pour lui et arrêtez-vous. Sinon, vous gaspillez des appels et semez la confusion avec des échecs identiques répétés.

Quand utiliser cette compétence

Chargez cette compétence chaque fois qu'une tâche use_figma implique :

  • L'ajout, la modification ou la suppression d'images clés sur un nœud (manualKeyframeTracks, applyManualKeyframeTrack, removeManualKeyframeTrack).
  • L'animation des couleurs de remplissage ou de contour dans le temps.
  • L'application, la modification ou la suppression de styles d'animation (applyAnimationStyle, removeAnimationStyle, animationStyles).
  • La lecture ou l'écriture de la durée de la timeline via node.timelines / node.setTimelineDuration(id, secondes).
  • Le choix d'un easing pour l'une des opérations ci-dessus.

Le travail de conception statique (création de formes, composants, variables, mise en page) passe uniquement par figma-use — cette compétence est réservée à la dimension temporelle.

Surface d'API d'animation exposée

  • node.manualKeyframeTracks — lecture/écriture des images clés manuelles (y compris les pistes de remplissage, de contour et d'effet).
  • node.applyManualKeyframeTrack(champ, track) / node.removeManualKeyframeTrack(champ) — ajouter, remplacer ou supprimer une piste d'images clés manuelle sans réécrire tout l'objet.
  • node.animationStyles — lecture/écriture des métadonnées de style d'animation appliquées à un nœud.
  • node.applyAnimationStyle(styleId, presetData?) / node.removeAnimationStyle(id) — appliquer un style découvert et supprimer une instance de style appliquée via son id retourné/lu en arrière.
  • node.timelines — liste en lecture seule des timelines pour le cadre de premier niveau conteneur, avec des durées en secondes.
  • node.setTimelineDuration(id, dureeSecondes) — écrire la durée de la timeline du cadre de premier niveau conteneur.
  • node.animations — données d'images clés résolues en lecture seule (actuellement uniquement les pistes manuelles — voir motion-patterns.md).
  • figma.motion.figmaAnimationStyles() — liste en lecture seule des styles d'animation propriétaires de Figma.

La création d'un code source de module prédéfini personnalisé "figma:motion" est hors de portée. Si l'utilisateur souhaite un tout nouveau style d'animation, dites-le et arrêtez-vous ; n'en inventez pas.

Documentation de référence

Chargez ces documents selon les besoins de la tâche :

DocQuand chargerCe qu'il couvre
motion-patterns.mdAjout/modification d'animation de mouvementImages clés manuelles, remplissages/contours animés, application de styles d'animation, durée de timeline
motion-easing.mdRéglage de l'easing d'animationObjets d'easing pour images clés, courbe cubique/ressort personnalisée, HOLD, application de l'easing dans un style d'animation

Vérification de l'animation

get_screenshot montre uniquement l'état de repos de la timeline, jamais le mouvement. Pour vérifier le mouvement, utilisez export_video et échantillonnez les images — mais le rendu est côté serveur, lent et coûteux (~10 s à minutes), alors faites en sorte que chaque rendu compte.

Planifiez avant de rendre — le coût évolue avec pixels × images, alors gardez les deux aussi petits que nécessaire :

  1. Choisissez d'abord les moments. Vous avez besoin d'une image par phase (par exemple, par étape de décalage, ou début / milieu / fin), pas d'une lecture fluide — généralement 4 à 6. Ce nombre détermine votre fps.
  2. Taillez à ce que vous devez lire. Commencez petit — constraint: { type: 'WIDTH', value: 320 }, quality: "low" — mais le texte et les petits éléments deviennent flous, donc augmentez WIDTH (768+) lorsque vous devez juger des détails fins. Omettre constraint = pleine taille (1x ; le serveur limite à 10x / 4096 px).
  3. Réglez fps juste assez haut pour capturer ces images : fps: 5 couvre quelques images ; 10 est une limite haute. Plus élevé ne fait que gonfler le rendu.

Mécanique : export_video fonctionne uniquement sur un cadre de premier niveau dont les enfants portent l'animation (passez ce cadre, pas le descendant que vous avez image clé). Il retourne un jobId avec status: "processing" — ré-invoquez avec { fileKey, jobId } pour interroger. Extrayez ensuite les images localement avec ffmpeg -ss <t> -i anim.mp4 -frames:v 1 frame_<t>.png — l'extraction est gratuite, donc une fois le rendu payé, exploitez-le pour chaque image qui vous renseigne plutôt que de ré-exporter. Sans extracteur d'images comme ffmpeg, sautez l'export et raisonnez sur les images clés à la place.

Itérez jusqu'à ce que ce soit juste. L'export est un diagnostic, pas une validation : si les images sont erronées (mauvais ordre, timing décalé, élément manquant, masque qui obscurcit le composite), corrigez les images clés/styles et ré-exportez. Lisez toutes les images et regroupez chaque correction en un seul passage avant de re-rendre — chaque rendu a un coût réel, donc faites en sorte que chacun compte plutôt que de ré-exporter après chaque petit changement.

Sautez complètement l'export pour les changements triviaux ou évidents.

Liste de vérification pré-vol

En plus de la liste de vérification pré-vol figma-use, vérifiez :

  • L'easing utilise la forme publique { type: 'EASE_OUT', easingFunctionCubicBezier?: …, easingFunctionSpring?: … } — pas les noms internes de graphe de scène comme OUT_CUBIC.
  • L'ease-in-out utilise l'énumération publique exacte EASE_IN_AND_OUT (ou EASE_IN_AND_OUT_BACK) ; n'émettez jamais l'alias invalide EASE_IN_OUT.
  • Le nœud animé n'est pas un cadre de premier niveau (fils direct d'une page). Animez les descendants à la place.
  • Les valeurs de timeline sont en secondes dans l'API Plugin publique. Prolongez via setTimelineDuration ; ne raccourcissez jamais sauf demande explicite de l'utilisateur.
  • Les champs d'images clés de transformation utilisent des noms publics (TRANSLATION_X, TRANSLATION_Y, ROTATION, SCALE_X, SCALE_Y, SCALE_XY), pas les noms internes MOTION_* du graphe de scène.
  • Les champs d'images clés manuelles proviennent de la liste blanche publique dans motion-patterns.md ; les champs générés/internes du graphe de scène lèvent intentionnellement une erreur.
  • Les ID des nœuds mutés sont retournés (conformément à la règle 15 de figma-use).
  • Lorsque la correction du mouvement n'est pas évidente et qu'un extracteur d'images (ffmpeg) est disponible, vérifiez via export_video + échantillonnage d'images — rendez petit, fps bas, itérez jusqu'à ce que ce soit juste (voir la section Vérification de l'animation ci-dessus). get_screenshot montre uniquement l'état de repos.

Individual skills in this repo

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

0n6k4v-Coder/skills

Translates Figma motion and animations into production-ready application code. Use when implementing animation/motion from a Figma design — user mentions "implement this motion", "add animation from Figma", "animate this component", provides a Figma URL whose node is animated, or when `get_design_context` returns motion data or instructs you to call `get_motion_context`.

0n6k4v-Coder/skills

Generate motion specification annotations from After Effects timeline data. Use when the user mentions "motion", "motion spec", "animation spec", "timeline", or wants to document a component's animation properties.

0n6k4v-Coder/skills

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender / instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.

0n6k4v-Coder/skills

Optimize a Next.js app that has `cacheComponents: true` — either the static shell on first paint, or the in-app navigation between routes. Picks the matching diagnostic loop and runs it.

0n6k4v-Coder/skills

Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines /_next/mcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.

Skills associés