Communitygithub.com

iPolloWork

Contexto de animação/movimento para a ferramenta MCP `use_figma` — animando nós do Figma via keyframes manuais, estilos de animação, easing e duração de timeline. Carregue junto com o `use_figma` sempre que a tarefa envolver adicionar, editar ou inspecionar animação em um nó.

O que é iPolloWork?

This skill provides motion context for the `use_figma` MCP tool, enabling animation of Figma nodes through manual keyframes, animation styles, easing, and timeline duration. It is essential for tasks involving adding, editing, or removing keyframes on a node, animating fill or stroke colors over time, applying or removing animation styles, and reading or writing timeline durations. The skill supports platforms like Claude and Cursor, and requires loading alongside the base `use_figma` skill. Key features include a motion API surface for keyframe tracks, animation styles, timelines, and a pre-flight checklist to ensure correct usage of public API names and prevent common errors. It also includes guidance on verifying animations via `export_video` and frame extraction with `ffmpeg`, emphasizing cost-efficient rendering and iteration.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/examples/plugin-packages/figma/skills/figma-use-motion

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

use_figma — Habilidade de API do Plugin Figma para Movimento

Contexto de movimento para a ferramenta MCP use_figma. figma-use cobre as regras fundamentais da API do Plugin — carregue ambos juntos.

Sempre passe skillNames: "figma-use-motion" (separado por vírgula junto com figma-use) ao chamar use_figma para trabalho de movimento. Apenas para registro.

Bloqueio de Execução

As APIs de Movimento são protegidas pela flag de funcionalidade de usuário metronome. Quando o usuário chamador não a possui, cada propriedade de movimento e auxiliar referenciada nesta habilidade lança "<nome>" não é uma API suportada.

Saia rapidamente desse erro. Não tente novamente; informe ao usuário que o movimento não está habilitado para ele e pare. Caso contrário, você queimará chamadas e confundirá o usuário com falhas idênticas repetidas.

Quando usar esta habilidade

Carregue esta habilidade sempre que uma tarefa use_figma envolver:

  • Adicionar, editar ou remover keyframes em um nó (manualKeyframeTracks, applyManualKeyframeTrack, removeManualKeyframeTrack).
  • Animar cores de preenchimento ou traço ao longo do tempo.
  • Aplicar, editar ou remover estilos de animação (applyAnimationStyle, removeAnimationStyle, animationStyles).
  • Ler ou escrever a duração da timeline via node.timelines / node.setTimelineDuration(id, segundos).
  • Escolher easing para qualquer um dos itens acima.

Trabalho de design estático (criação de formas, componentes, variáveis, layout) passa apenas por figma-use — esta habilidade é apenas para a dimensão temporal.

Superfície da API de Movimento Exposta

  • node.manualKeyframeTracks — leitura/escrita de keyframes manuais (incluindo trilhas de preenchimento, traço e efeito).
  • node.applyManualKeyframeTrack(campo, trilha) / node.removeManualKeyframeTrack(campo) — adicionar, substituir ou remover uma trilha de keyframe manual sem reescrever o objeto inteiro.
  • node.animationStyles — leitura/escrita de metadados de estilo de animação aplicados a um nó.
  • node.applyAnimationStyle(styleId, presetData?) / node.removeAnimationStyle(id) — aplicar um estilo descoberto e remover uma instância de estilo aplicada pelo seu id retornado/lido.
  • node.timelines — lista somente leitura de timelines para o frame de nível superior que contém o nó, com durações em segundos.
  • node.setTimelineDuration(id, durationSeconds) — escrever a duração da timeline do frame de nível superior que contém o nó.
  • node.animations — dados de keyframe resolvidos somente leitura (atualmente apenas trilhas manuais — veja motion-patterns.md).
  • figma.motion.figmaAnimationStyles() — lista somente leitura dos estilos de animação primários do Figma.

Criar código-fonte de módulo de preset personalizado "figma:motion" está fora do escopo. Se o usuário quiser um estilo de animação totalmente novo, diga isso e pare; não invente um.

Documentos de Referência

Carregue estes conforme necessário, com base no que a tarefa envolve:

DocumentoQuando carregarO que cobre
motion-patterns.mdAo adicionar/editar animação de movimentoKeyframes manuais, preenchimentos/traços animados, aplicação de estilos de animação, duração da timeline
motion-easing.mdAo definir easing de animaçãoObjetos de easing de keyframe, cubic/spring personalizado, HOLD, aplicando easing dentro de um estilo de animação

Verificando a Animação

get_screenshot mostra apenas o estado de repouso da timeline, nunca o movimento. Para verificar o movimento, use export_video e amostre frames — mas ele renderiza no servidor e é lento e caro (~10s a minutos), então faça cada renderização valer a pena.

Planeje antes de renderizar — o custo escala com pixels × frames, então mantenha ambos não maiores do que os frames precisam:

  1. Escolha os momentos primeiro. Você precisa de um frame por fase (por exemplo, por passo de escalonamento, ou início / meio / estabilização), não reprodução suave — geralmente 4–6. Essa contagem define seu fps.
  2. Tamanho para o que você precisa ler. Comece pequeno — constraint: { type: 'WIDTH', value: 320 }, quality: "low" — mas texto e elementos pequenos ficam borrados ali, então aumente WIDTH (768+) quando precisar avaliar detalhes finos. Omitir constraint = tamanho completo (1x; o servidor limita a 10x / 4096px).
  3. Defina fps apenas o suficiente para capturar esses frames: fps: 5 cobre alguns; 10 é um limite superior. Mais alto apenas incha a renderização.

Mecânica: export_video funciona apenas em um frame de nível superior cujos filhos carregam a animação (passe esse frame, não o descendente que você keyframed). Ele retorna um jobId com status: "processing" — reinvoke com { fileKey, jobId } para consultar. Em seguida, extraia frames localmente com ffmpeg -ss <t> -i anim.mp4 -frames:v 1 frame_<t>.png — a extração é gratuita, então, uma vez que você pagou pela renderização, explore-a para cada frame que lhe diga algo em vez de reexportar. Sem um extrator de frames como ffmpeg, pule a exportação e raciocine sobre os keyframes.

Itere até acertar. A exportação é um diagnóstico, não uma aprovação: se os frames estiverem errados (ordem errada, tempo errado, um elemento faltando, uma máscara ocultando a composição), corrija os keyframes/estilos e reexporte. Leia todos os frames e agrupe cada correção em uma passagem antes de re-renderizar — cada renderização tem uma sobrecarga real, então faça cada uma valer a pena em vez de reexportar após cada pequena alteração.

Pule a exportação completamente para alterações triviais ou auto-evidentes.

Lista de Verificação Pré-voo

Além da lista de verificação pré-voo do figma-use, verifique:

  • Easing usa a forma pública { type: 'EASE_OUT', easingFunctionCubicBezier?: …, easingFunctionSpring?: … } — não nomes internos de scenegraph como OUT_CUBIC.
  • Ease-in-out usa o enum público exato EASE_IN_AND_OUT (ou EASE_IN_AND_OUT_BACK); nunca emita o alias inválido EASE_IN_OUT.
  • O nó sendo animado não é um frame de nível superior (filho direto de uma página). Anime descendentes.
  • Os valores de timeline são segundos na API pública do Plugin. Estenda via setTimelineDuration; nunca encurte a menos que o usuário tenha solicitado.
  • Campos de keyframe de transformação usam nomes públicos (TRANSLATION_X, TRANSLATION_Y, ROTATION, SCALE_X, SCALE_Y, SCALE_XY), não nomes internos de scenegraph MOTION_*.
  • Campos de keyframe manual vêm da lista de permissões pública em motion-patterns.md; campos de scenegraph gerados/internos intencionalmente lançam erro.
  • IDs de nós mutados são retornados (conforme Regra 15 do figma-use).
  • Quando a correção do movimento não é auto-evidente e um extrator de frames (ffmpeg) estiver disponível, verifique via export_video + amostragem de frames — renderize pequeno, fps baixo, itere até acertar (veja a seção Verificando a Animação acima). get_screenshot mostra apenas o estado de repouso.

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.

Habilidades Relacionadas