Communitygithub.com

Devin-AXIS/iPolloWork

Motion-/Animationskontext für das `use_figma` MCP-Tool — ermöglicht das Animieren von Figma-Knoten mittels manueller Keyframes, Animationsstilen, Easing und Zeitliniendauer. Zusammen mit `figma-use` laden, sobald eine Aufgabe das Hinzufügen, Bearbeiten oder Inspizieren von Animationen an einem Knoten umfasst.

Was ist iPolloWork?

Diese Skill erweitert das `use_figma` MCP-Tool um vollständige Animationsfähigkeiten für Figma-Knoten. Sie ermöglicht das Lesen und Schreiben manueller Keyframe-Tracks, das Anwenden und Entfernen von Animationsstilen, die Steuerung der Zeitliniendauer und die Auswahl von Easing-Funktionen. Die Skill ist essenziell für alle Aufgaben, die zeitbasierte Änderungen an Füllungen, Strichen, Effekten oder Transformationen erfordern – statische Designarbeit wird hingegen allein durch die Basis-Skill `figma-use` abgedeckt. Sie unterstützt die Plattformen von Figma (Plugin API) und arbeitet mit dem MCP-Protokoll. Die Skill dokumentiert außerdem die eingeschränkte Verfügbarkeit (Feature-Flag `metronome`), eine Vorgehensweise zur Überprüfung von Animationen mittels `export_video` (Bild-für-Bild-Extraktion) und eine detaillierte Pre-Flight-Checkliste, um häufige Fehler wie falsche interne Szenengraphen-Namen oder das Animieren des obersten Frames zu vermeiden.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/examples/plugin-packages/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 Bewegungsarbeit aufgerufen wird. Nur zum Loggen.

Runtime-Gating

Motion-APIs sind hinter dem Benutzer-Feature-Flag metronome geschützt. Wenn der aufrufende Benutzer es nicht hat, wirft jede in diesem Skill referenzierte Motion-Eigenschaft und -Hilfsfunktion den Fehler "<name>" is not a supported API.

Bei diesem Fehler schnell aussteigen. Nicht wiederholen; dem Benutzer mitteilen, dass Motion für ihn nicht aktiviert ist, und abbrechen. Andernfalls werden Aufrufe verschwendet und der Benutzer durch wiederholte identische Fehler verwirrt.

Wann diese Skill verwenden

Diese Skill laden, wenn eine use_figma-Aufgabe 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 Zeitliniendauer über node.timelines / node.setTimelineDuration(id, seconds).
  • Auswählen von Easing für eine der oben genannten Aktionen.

Statische Designarbeit (Erstellen von Formen, Komponenten, Variablen, Layout) erfolgt allein über figma-use – diese Skill ist nur für die Zeitdimension.

Freigegebene Motion-API-Oberfläche

  • node.manualKeyframeTracks – manuelle Keyframes lesen/schreiben (einschließlich Füll-, Strich- und Effekt-Tracks).
  • node.applyManualKeyframeTrack(field, track) / node.removeManualKeyframeTrack(field) – einen manuellen Keyframe-Track hinzufügen, ersetzen oder entfernen, ohne das gesamte Objekt neu zu schreiben.
  • node.animationStyles – auf einen Knoten angewendete Animationsstil-Metadaten lesen/schreiben.
  • node.applyAnimationStyle(styleId, presetData?) / node.removeAnimationStyle(id) – einen entdeckten Stil anwenden und eine angewendete Stilinstanz anhand ihrer zurückgegebenen/zurückgelesenen id entfernen.
  • node.timelines – schreibgeschützte Zeitlinienliste für den enthaltenden obersten Frame mit Dauern in Sekunden.
  • node.setTimelineDuration(id, durationSeconds) – die Zeitliniendauer des enthaltenden obersten Frames schreiben.
  • node.animations – schreibgeschützte aufgelöste Keyframe-Daten (derzeit nur manuelle Tracks – siehe motion-patterns.md).
  • figma.motion.figmaAnimationStyles() – schreibgeschützte Liste der erstklassigen Animationsstile von Figma.

Das Erstellen benutzerdefinierter Quellcode für "figma:motion"-Preset-Module liegt außerhalb des Rahmens. Wenn der Benutzer einen brandneuen Animationsstil wünscht, dies mitteilen und abbrechen; keinen erfinden.

Referenzdokumente

Diese je nach Aufgabenbereich nach Bedarf laden:

DokumentWann ladenWas es abdeckt
motion-patterns.mdHinzufügen/Bearbeiten von BewegungsanimationenManuelle Keyframes, animierte Füllungen/Striche, Anwenden von Animationsstilen, Zeitliniendauer
motion-easing.mdEinstellen des Animations-EasingsKeyframe-Easing-Objekte, benutzerdefiniertes Cubic/Spring, HOLD, Anwenden von Easing innerhalb eines Animationsstils

Überprüfen der Animation

get_screenshot zeigt nur den Ruhezustand der Zeitleiste, niemals Bewegung. Zur Überprüfung der Bewegung export_video verwenden und Einzelbilder entnehmen – dies rendert jedoch serverseitig und ist langsam und teuer (~10 s bis Minuten). Daher jedes Rendern sinnvoll nutzen.

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

  1. Zuerst die Momente auswählen. Es wird ein Frame pro Phase benötigt (z. B. pro Staffelungsschritt oder Start / Mitte / Ende), nicht flüssige Wiedergabe – normalerweise 4–6. Diese Anzahl bestimmt die fps.
  2. **Auf das Nötigste verkleinern Klein anfangen – constraint: { type: 'WIDTH', value: 320 }, quality: "low" – aber Text und kleine Elemente werden dort unscharf, also WIDTH (768+) erhöhen, wenn feine Details zu beurteilen sind. constraint weglassen = volle Größe (1x; Server begrenzt auf 10x / 4096 Pixel).
  3. Fps gerade so hoch einstellen, dass diese Frames erreicht werden: fps: 5 deckt eine Handvoll ab; 10 ist eine Obergrenze. Höhere Werte blähen das Rendern nur auf.

Mechanik: export_video funktioniert nur auf einem obersten Frame, dessen Kinder die Animation tragen (diesen Frame übergeben, nicht den Nachkommen, der mit Keyframes versehen wurde). Es gibt eine jobId mit status: "processing" zurück – erneut mit { fileKey, jobId } aufrufen, um abzufragen. Anschließend lokal mit ffmpeg -ss <t> -i anim.mp4 -frames:v 1 frame_<t>.png Einzelbilder extrahieren – Extraktion ist kostenlos. Sobald das Rendern bezahlt ist, jeden Frame ausnutzen, der etwas aussagt, anstatt erneut zu exportieren. Ohne einen Frameextraktor wie ffmpeg den Export überspringen und stattdessen die Keyframes analysieren.

Iterieren, bis es stimmt. Der Export ist eine Diagnose, keine Freigabe: Wenn die Frames falsch sind (falsche Reihenfolge, falsches Timing, fehlendes Element, eine Maske, die die Komposition ausblendet), die Keyframes/Style korrigieren und erneut exportieren. Alle Frames lesen und jede Korrektur in einem Durchgang bündeln, bevor erneut gerendert wird – jedes Rendern verursacht echten Aufwand, also jeden Durchgang zählen lassen, anstatt 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 Folgendes prüfen:

  • Easing verwendet die öffentliche Form { type: 'EASE_OUT', easingFunctionCubicBezier?: …, easingFunctionSpring?: … } – nicht interne Szenengraphen-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 oberster Frame (direktes Kind einer Seite). Stattdessen Nachkommen animieren.
  • Zeitlinienwerte sind Sekunden in der öffentlichen Plugin-API. Über setTimelineDuration verlängern; niemals verkürzen, es sei denn, der Benutzer hat darum gebeten.
  • Transform-Keyframe-Felder verwenden öffentliche Namen (TRANSLATION_X, TRANSLATION_Y, ROTATION, SCALE_X, SCALE_Y, SCALE_XY), nicht interne MOTION_* Szenengraphen-Namen.
  • Manuelle Keyframe-Felder stammen aus der öffentlichen Whitelist in motion-patterns.md; generierte/interne Szenengraphen-Felder werfen absichtlich Fehler.
  • Mutierte Knoten-IDs werden zurückgegeben (gemäß figma-use Regel 15).
  • Wenn die Richtigkeit der Bewegung nicht offensichtlich ist und ein Frameextraktor (ffmpeg) verfügbar ist, mittels export_video + Framestichproben überprüfen – klein rendern, niedrige fps, iterieren, bis es stimmt (siehe Abschnitt „Überprüfen der Animation“ oben). get_screenshot zeigt nur den Ruhezustand.

Individual skills in this repo

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

Devin-AXIS/iPolloWork

Create deterministic animation and transitions for the active iPollo Video project.

Devin-AXIS/iPolloWork

Inspect, validate, preview, and render the active iPollo Video project with its bundled HyperFrames CLI.

Devin-AXIS/iPolloWork

Apply the core composition, timing, media, and determinism contract used by iPollo Video.

Devin-AXIS/iPolloWork

Plan visual direction, typography, pacing, audio, and composition for iPollo Video projects.

Devin-AXIS/iPolloWork

Build seek-safe keyframe animation for the active iPollo Video timeline.

Devin-AXIS/iPolloWork

Reuse approved HyperFrames blocks and components inside the active iPollo Video project.

Devin-AXIS/iPolloWork

Route video creation and editing through the active iPollo Video project and its built-in HyperFrames runtime.

Devin-AXIS/iPolloWork

Create or edit the active iPolloWork video's visual assets, installed recipes, editable composition and seek-safe motion; use for assembly or local picture/text/theme changes.

Devin-AXIS/iPolloWork

Add or revise music, sound effects and their mix in the active iPolloWork video, using authorized sources, real editable tracks and measured event cues.

Devin-AXIS/iPolloWork

Write or revise the active iPolloWork video's native STORYBOARD.md, with source coverage, content-led sequence and provisional timing; use for script-only work.

Devin-AXIS/iPolloWork

Route the active iPolloWork video request to its current storyboard, compose, voiceover or soundtrack work, preserving the client-owned delivery flow.

Devin-AXIS/iPolloWork

Add or revise scene-bound narration or speech-linked captions in the active iPolloWork video using actual voice settings, measured audio and alignment.

Devin-AXIS/iPolloWork

Create product launch and promotional videos through the active iPollo Video workflow.

Devin-AXIS/iPolloWork

Develop or update reusable visual components for iPolloWork Video, including maps, charts, rankings, diagrams, openings and endings. Use for component authoring rules, manifests, editable variables, shared data forms, inherited design themes, AI editing slots and seekable HyperFrames timelines. Not for producing a whole video, authoring a full-project template, or packaging a DeepSeek host plugin.

Devin-AXIS/iPolloWork

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

Devin-AXIS/iPolloWork

Plan and create short videos using the installed short-video-studio workspace app. Manage its creative canvas, scripts, storyboards, characters and local assets, generate images or video through connected Work channels, and hand off editable tracks to Work Video Studio.

Devin-AXIS/iPolloWork

Find, generate, process, and reuse media through the active iPollo Video session's media services.

Verwandte Skills