Communitygithub.com

iPolloWork

Contexte d'animation / motion pour l'outil MCP `use_figma` — animation de nœuds Figma via keyframes manuels, styles d'animation, easing et durée de timeline. À charger avec figma-use dès qu'une tâche implique l'ajout, la modification ou l'inspection d'une animation sur un nœud.

Qu'est-ce que iPolloWork ?

Cette compétence fournit le contexte d'animation (motion) pour l'outil MCP `use_figma`. Elle est conçue pour être chargée conjointement avec la compétence `figma-use` (qui couvre les règles fondamentales de l'API Plugin) dès qu'une tâche implique la manipulation d'animations sur des nœuds Figma : keyframes manuels, animation de couleurs de remplissage/trait, styles d'animation, durée de timeline, et easing. L'API de motion est protégée par le flag utilisateur `metronome` ; en son absence, toute tentative d'utilisation renvoie une erreur, et l'agent doit abandonner immédiatement. La compétence expose des propriétés et méthodes comme `node.manualKeyframeTracks`, `node.applyManualKeyframeTrack`, `node.animationStyles`, `node.setTimelineDuration`, ainsi que des styles Figma natifs. Pour vérifier l'animation, il faut utiliser `export_video` (et non `get_screenshot`), avec un plan de rendu économique (taille réduite, fps faible, frames ciblées). La compétence inclut des listes de contrôle pré-vol détaillant les règles d'utilisation des énumérations publiques, l'interdiction d'animer un nœud frame racine, et l'obligation de retourner les ID de nœuds mutés.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/examples/plugin-packages/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

use_figma — Compétence API Plugin Figma pour l'Animation

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

Passez toujours skillNames: "figma-use-motion" (séparé par des virgules avec figma-use) lors de l'appel à use_figma pour un travail d'animation. Uniquement pour le logging.

Gestion d'exécution

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

Abandonnez immédiatement sur cette erreur. Ne réessayez pas ; indiquez à l'utilisateur que l'animation n'est pas activée pour lui et arrêtez-vous. Sinon, vous gaspillerez des appels et confondrez l'utilisateur avec des échecs identiques répétés.

Quand utiliser cette compétence

Chargez cette compétence dès qu'une tâche use_figma implique :

  • L'ajout, la modification ou la suppression de keyframes sur un nœud (manualKeyframeTracks, applyManualKeyframeTrack, removeManualKeyframeTrack).
  • L'animation des couleurs de remplissage ou de trait 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 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 keyframes manuels (y compris les pistes de remplissage, trait et effet).
  • node.applyManualKeyframeTrack(champ, piste) / node.removeManualKeyframeTrack(champ) — ajouter, remplacer ou supprimer une piste de keyframe manuel 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é/relu.
  • node.timelines — liste en lecture seule des timelines du frame racine contenant, avec les durées en secondes.
  • node.setTimelineDuration(id, dureeSecondes) — écrire la durée de timeline du frame racine contenant.
  • node.animations — données de keyframes 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 preset "figma:motion" personnalisé est hors de portée. Si l'utilisateur souhaite un tout nouveau style d'animation, dites-le et arrêtez-vous ; n'en fabriquez pas.

Documentation de référence

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

DocumentQuand le chargerCe qu'il couvre
motion-patterns.mdAjout/modification d'une animationKeyframes manuels, remplissages/traits animés, application de styles d'animation, durée de timeline
motion-easing.mdRéglage de l'easing d'animationObjets d'easing pour keyframes, cubic/spring personnalisé, 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 l'animation. Pour vérifier l'animation, utilisez export_video et échantillonnez des frames — mais le rendu est côté serveur et lent et coûteux (~10s à minutes), alors faites en sorte que chaque rendu compte.

Planifiez avant de rendre — le coût est proportionnel aux pixels × frames, donc gardez les deux aussi petits que nécessaire :

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

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

Itérez jusqu'à ce que ce soit correct. L'export est un diagnostic, pas une validation : si les frames sont erronées (mauvais ordre, mauvais timing, élément manquant, masque qui cache le composite), corrigez les keyframes/styles et réexportez. Lisez toutes les frames et regroupez chaque correction en un seul passage avant de relancer le rendu — chaque rendu a un coût réel, donc faites en sorte que chacun compte au lieu de réexporter après chaque petite modification.

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

Liste de contrôle pré-vol

En plus de la liste de contrôle pré-vol de figma-use, vérifiez :

  • L'easing utilise la forme publique { type: 'EASE_OUT', easingFunctionCubicBezier?: …, easingFunctionSpring?: … } — pas de noms internes 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 frame racine (enfant direct d'une page). Animatez les descendants à la place.
  • Les valeurs de timeline sont en secondes dans l'API Plugin publique. Étendez via setTimelineDuration ; ne raccourcissez jamais sauf demande explicite de l'utilisateur.
  • Les champs de keyframe de transformation utilisent les noms publics (TRANSLATION_X, TRANSLATION_Y, ROTATION, SCALE_X, SCALE_Y, SCALE_XY), pas les noms internes de scène MOTION_*.
  • Les champs de keyframe manuels proviennent de la liste autorisée publique dans motion-patterns.md ; les champs générés/internes de scène lèvent intentionnellement une erreur.
  • Les ID de nœuds mutés sont retournés (selon la règle 15 de figma-use).
  • Lorsque la correction de l'animation n'est pas évidente et qu'un extracteur de frames (ffmpeg) est disponible, vérifiez via export_video + échantillonnage de frames — rendez petit, fps bas, itérez jusqu'à ce que ce soit correct (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 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.

Skills associés