Communitygithub.com

use_figma — Motion-Animation-Skill für Figma

Bewegungs- und Animationskontext für das `use_figma` MCP-Tool – zum Animieren von Figma-Knoten mittels manueller Keyframes, Animationsstilen, Easing und Zeitachsen-Dauer. Zusammen mit figma-use laden, wenn die Aufgabe das Hinzufügen, Bearbeiten oder Prüfen von Animationen an einem Knoten umfasst.

Was ist use_figma — Motion-Animation-Skill für Figma?

Dieser Skill erweitert das `use_figma` MCP-Tool um Motion-Funktionen für die Figma Plugin API. Er ist speziell für Aufgaben gedacht, die Animationen auf Figma-Knoten betreffen: manuelle Keyframes, Animationsstile, Easing-Funktionen und die Steuerung der Zeitachsen-Dauer. Der Skill wird über den Parameter `skillNames: "figma-use-motion"` zusammen mit `figma-use` aktiviert. Wichtige Voraussetzung ist das User-Feature-Flag `metronome_plugin_api`, ohne das alle Motion-APIs einen Fehler werfen. Der Skill unterstützt die Arbeit mit `manualKeyframeTracks`, `applyManualKeyframeTrack`, `removeManualKeyframeTrack`, das Lesen/Schreiben von `timelines` und `setTimelineDuration`, die Anwendung und Entfernung von Animationsstilen (`applyAnimationStyle`, `removeAnimationStyle`) sowie das Auslesen von `animationStyles` und `figma.motion.figmaAnimationStyles()`. Für die Überprüfung von Animationen wird auf `export_video` verwiesen (mit Abtastung einzelner Frames), da `get_screenshot` nur den Ruhezustand zeigt. Der Skill rät zur sparsamen und gezielten Nutzung des Renderings, da es server-seitig ausgeführt wird und zeit- sowie kostenintensiv sein kann. Wichtige Vorsichtsmaßnahmen umfassen korrekte Easing-Enum-Werte (z. B. `EASE_IN_AND_OUT` statt `EASE_IN_OUT`), die Vermeidung von Animationen auf Top-Level-Frames und die Nutzung öffentlicher API-Feldnamen. Der Skill eignet sich nicht für statisches Design oder die Erstellung neuer Animationstile von Grund auf.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/figma/ebentley-figma/skills/figma-use-motion

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

use_figma — Figma Plugin API Skill für Motion

Motion-Kontext für das use_figma MCP-Tool. figma-use behandelt die grundlegenden Plugin-API-Regeln – beide zusammen laden.

Immer skillNames: "figma-use-motion" (kommagetrennt zusammen mit figma-use) übergeben, wenn use_figma für Motion-Arbeiten aufgerufen wird. Nur Protokollierung.

Laufzeit-Sperre

Motion-APIs sind hinter dem User-Feature-Flag metronome_plugin_api gesperrt. Wenn der aufrufende Benutzer es nicht besitzt, wirft jede in diesem Skill referenzierte Motion-Eigenschaft und -Hilfsfunktion "<name>" is not a supported API.

Sofort bei diesem Fehler aussteigen. Nicht wiederholen; dem Benutzer mitteilen, dass Motion nicht für ihn aktiviert ist, und anhalten. Andernfalls werden Aufrufe verbraucht und der Benutzer durch ständig gleiche Fehlermeldungen verwirrt.

Wann dieser Skill zu verwenden ist

Diesen Skill laden, wann immer ein use_figma-Task Folgendes umfasst:

  • Hinzufügen, Bearbeiten oder Entfernen von Keyframes auf einem Knoten (manualKeyframeTracks, applyManualKeyframeTrack, removeManualKeyframeTrack).
  • Animieren von Füll- oder Strichfarben über die Zeit.
  • Anwenden, Bearbeiten oder Entfernen von Animationsstilen (applyAnimationStyle, removeAnimationStyle, animationStyles).
  • Lesen oder Schreiben der Zeitachsen-Dauer via node.timelines / node.setTimelineDuration(id, seconds).
  • Auswahl von Easing für eine der obigen Aktionen.

Statische Designarbeit (Erstellen von Formen, Komponenten, Variablen, Layout) erfolgt ausschließlich über figma-use – dieser Skill ist nur für die Zeitdimension gedacht.

Verfügbare Motion-API-Oberfläche

  • node.manualKeyframeTracks – Lesen/Schreiben manueller Keyframes (inkl. Füll-, Strich- und Effekt-Spuren).
  • node.applyManualKeyframeTrack(field, track) / node.removeManualKeyframeTrack(field) – Hinzufügen, Ersetzen oder Entfernen einer manuellen Keyframe-Spur, ohne das gesamte Objekt neu zu schreiben.
  • node.animationStyles – Lesen/Schreiben von Animationsstil-Metadaten, die auf einen Knoten angewendet wurden.
  • node.applyAnimationStyle(styleId, presetData?) / node.removeAnimationStyle(id) – Einen entdeckten Stil anwenden und eine angewandte Stilinstanz anhand ihrer zurückgegebenen/ausgelesenen id entfernen.
  • node.timelines – Nur-Lesen-Liste der Zeitachsen für den enthaltenden Top-Level-Frame mit Dauern in Sekunden.
  • node.setTimelineDuration(id, durationSeconds) – Schreiben der Zeitachsen-Dauer des enthaltenden Top-Level-Frames.
  • node.animations – Nur-Lesen aufgelöste Keyframe-Daten (derzeit nur manuelle Spuren – siehe motion-patterns.md).
  • figma.motion.figmaAnimationStyles() – Nur-Lesen-Liste der Erstanbieter-Animationsstile von Figma.

Das Erstellen von benutzerdefiniertem "figma:motion"-Preset-Modul-Quellcode ist nicht abgedeckt. Wenn der Benutzer einen brandneuen Animationsstil wünscht, dies mitteilen und anhalten; keinen erfinden.

Referenzdokumente

Diese nach Bedarf laden, basierend auf der Aufgabe:

DokumentWann ladenInhalt
motion-patterns.mdHinzufügen/Bearbeiten von BewegungsanimationenManuelle Keyframes, animierte Füllungen/Striche, Anwenden von Animationsstilen, Zeitachsen-Dauer
motion-easing.mdEinstellen von Animations-EasingKeyframe-Easing-Objekte, benutzerdefinierte kubische/Feder, HOLD, Easing innerhalb eines Animationsstils anwenden

Animation überprüfen

get_screenshot zeigt nur den Ruhezustand der Zeitachse, niemals Bewegung. Um Bewegung zu prüfen, export_video und Einzelbilder entnehmen – aber es rendert serverseitig und ist langsam und teuer (~10s bis Minuten), also jeden Render zählen lassen.

Vor dem Rendern planen – Die Kosten skalieren mit Pixel × Frames, also beides nicht größer halten als nötig:

  1. Zuerst die Momente auswählen. Pro Phase wird ein Frame benötigt (z. B. pro Staffelungsschritt oder Start / Mitte / Endposition), keine flüssige Wiedergabe – meist 4–6. Diese Anzahl bestimmt die fps.
  2. Größe auf das Nötigste beschränken. Klein anfangen – constraint: { type: 'WIDTH', value: 320 }, quality: "low" – aber Text und kleine Elemente werden dort unscharf, also WIDTH erhöhen (768+), wenn feine Details beurteilt werden müssen. Weglassen von constraint = volle Größe (1x; Server begrenzt auf 10x / 4096px).
  3. fps gerade so hoch einstellen, dass diese Frames landen: fps: 5 reicht für einige wenige; 10 ist die Obergrenze. Höher bläht nur den Render auf.

Mechanik: export_video funktioniert nur auf einem Top-Level-Frame, dessen Kinder die Animation tragen (diesen Frame übergeben, nicht den Nachkommen, den man mit Keyframes versehen hat). Es gibt eine jobId mit status: "processing" zurück – erneut mit { fileKey, jobId } aufrufen, um abzufragen. Dann Frames lokal extrahieren mit ffmpeg -ss <t> -i anim.mp4 -frames:v 1 frame_<t>.png – Extraktion ist kostenlos, also sobald der Render bezahlt ist, jeden aussagekräftigen Frame daraus holen, statt neu zu exportieren. Ohne einen Frame-Extraktor wie ffmpeg den Export überspringen und über die Keyframes nachdenken.

Iterieren, bis es stimmt. Der Export ist eine Diagnose, keine Abnahme: Wenn die Frames falsch sind (falsche Reihenfolge, falsches Timing, fehlendes Element, Maske, die die Komposition ausblendet), die Keyframes/Styles korrigieren und neu exportieren. Alle Frames lesen und alle Korrekturen in einem Durchgang bündeln, bevor neu gerendert wird – jeder Render hat echten Overhead, also jeden zählen lassen, statt nach jeder kleinen Änderung neu zu exportieren.

Den Export bei trivialen oder offensichtlichen Änderungen ganz überspringen.

Pre-Flight-Checkliste

Zusätzlich zur figma-use Pre-Flight-Checkliste prüfen:

  • Easing verwendet die öffentliche Form { type: 'EASE_OUT', easingFunctionCubicBezier?: …, easingFunctionSpring?: … } – keine internen Szenegraphen-Namen wie OUT_CUBIC.
  • Ease-In-Out verwendet den exakten öffentlichen Enum EASE_IN_AND_OUT (oder EASE_IN_AND_OUT_BACK); niemals den ungültigen Alias EASE_IN_OUT ausgeben.
  • Der zu animierende Knoten ist kein Top-Level-Frame (direktes Kind einer Seite). Stattdessen Nachkommen animieren.
  • Zeitachsen-Werte sind Sekunden in der öffentlichen Plugin-API. Verlängern via setTimelineDuration; niemals verkürzen, es sei denn, der Benutzer hat es verlangt.
  • Transform-Keyframe-Felder verwenden öffentliche Namen (TRANSLATION_X, TRANSLATION_Y, ROTATION, SCALE_X, SCALE_Y, SCALE_XY), keine internen MOTION_*-Szenegraphen-Namen.
  • Manuelle Keyframe-Felder stammen aus der öffentlichen Whitelist in motion-patterns.md; generierte/interne Szenegraphen-Felder werfen absichtlich Fehler.
  • Mutierte Knoten-IDs werden zurückgegeben (gemäß figma-use Regel 15).
  • Wenn Motion-Korrektheit nicht offensichtlich ist und ein Frame-Extraktor (ffmpeg) verfügbar ist, via export_video + Frame-Stichproben verifizieren – klein rendern, niedrige fps, iterieren, bis es stimmt (siehe Abschnitt „Animation überprüfen" oben). get_screenshot zeigt nur den Ruhezustand.

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`.

Verwandte Skills