← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Nov 7, 2026 · 00:09 UTC · version 2.4.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for figma-storyboard-animation

Full description — Now says: scene. A Figma design made into a finished video starts in animate-design.

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Picsart and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Full description

Before

Nov 3, 2026 · 18:14 UTC

scene.

After

Nov 7, 2026 · 00:09 UTC

scene. A Figma design made into a finished video starts in animate-design.

Skill instructions

Before

Nov 3, 2026 · 18:14 UTC

scene.

After

Nov 7, 2026 · 00:09 UTC

scene. A Figma design made into a finished video starts in animate-design. ported-from: figma-storyboard-to-scene 1.3 at 55.75.0

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,8 +1,9 @@
 ---
 name: figma-storyboard-animation
-description: Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to "make move", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene.
+description: Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to "make move", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene. A Figma design made into a finished video starts in animate-design.
 metadata:
   version: '1.3'
+  ported-from: figma-storyboard-to-scene 1.3 at 55.75.0
 ---
 
 # Figma storyboard → scene motion design
Full technical diff · 2 changed fields

changed /description

BEFORE
"Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene."
AFTER
"Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene. A Figma design made into a finished video starts in animate-design."

changed /skill_md_contents

BEFORE
"---\nname: figma-storyboard-animation\ndescription: Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene.\nmetadata:\n  version: '1.3'\n---\n\n# Figma storyboard → scene motion design\n\nA storyboard is a series of static 1920×1080 frames. Your job is to produce one scene whose\ntimeline moves between them. Most of the motion is **already in the design** — recover it rather\nthan invent it.\n\n> **Can't run code?** Everywhere this recipe says \"author a generator script\", build the scene\n> through `picsart_scene_patch` instead and pin the same invariants with\n> `picsart_scene_query_layout` after each change (see Commands below). The method is identical — only the\n> execution surface differs.\n\n## The flow\n\n1. **Read the tree once** — if the user has shared the storyboard through their Figma connector,\n   read the page's frame tree once: it returns every frame, layer, name and box. Everything below is derived from it. Do not walk the board frame by frame to explore.\n2. **Plan the beats** — write the beat table down before authoring (below).\n3. **Extract each element as its own layer** from the design the user shared: construct editable\n   shape geometry from its source measurements and use `picsart_scene_import_figma_paint` for CSS\n   fill, shadow or gradient paint on an existing layer. Keep text live. Automatic shape-node\n   conversion is not exposed here. Use an image only for an unsupported treatment or a genuinely\n   unlayered source; see [extraction](references/figma-extraction.md).\n4. **Build the scene from the geometry, and pin every rule.** Where you can run code, author a\n   generator script (not hand-written JSON) so each rule becomes an `assert`; where you can't,\n   build it through `picsart_scene_patch` and pin the same invariants with\n   `picsart_scene_query_layout`. Geometry comes from the metadata, never from eyeballing.\n5. **Verify numerically**, then export.\n\nSteps 3–5 run **once per scene**, in order — that loop is the method.\n\n## One static frame\n\nWhen the ask is a single frame (a still, a store image, a card), there is no storyboard. Skip the\nbeats and build that frame as a still scene:\n\n1. **Read the selected frame through the user's shared Figma connector.** Its size is `composition.width` and `height`, its fill is\n   `composition.background`, and a short `duration` (`1`) is enough.\n2. **One layer per child, in paint order** (the tree's first child at the bottom). A layer's\n   `position` is its box CENTRE in the frame, `[x + width/2, y + height/2]`: a layer turns and\n   scales about its centre. Cross-check one nested child against the frame: some groups store\n   children relative to the group ([references/figma-extraction.md](references/figma-extraction.md)).\n3. **Each child in the medium that keeps it editable**: author shape geometry, then apply its CSS paint through `picsart_scene_import_figma_paint`,\n   text as live text, and each IMAGE fill as a media layer on its original\n   bitmap — never the node `export`, which flattens transparency onto the frame's background —\n   by its `scaleMode` (`FILL`→`cover`,\n   `FIT`→`contain`, `CROP`→`cover` + `crop`, `TILE`→not expressible; the table and the crop maths are\n   in [references/figma-extraction.md](references/figma-extraction.md), \"Image fills\"). Upload each\n   image first; a Figma asset URL expires.\n4. **A local group that clips or fades as one is usually an inline `composition` layer.** Use a\n   scene reference when it is intentionally a reusable, separately owned component.\n5. **Verify with numbers, then one full picture.** `picsart_scene_query_layout` at `0`: every `box` within a\n   pixel of its Figma box. A top-level image without `crop` carries `drawn`: its box and\n   `sourceCrop` as the design shows them. An image inside a group reads `clippedBox`, the part its\n   group leaves showing.\n   Then one `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions: a thumbnail drops 2 px lines and small text.\n\n## Layers, not screens\n\nThe scene is a composite of **movable layers**, never a montage of flat screens. A design comes in\nas layers; keep them separable so each can move on its own — that is the whole reason for building a\nscene rather than cross-fading screenshots.\n\n- **Reconstruct, don't rasterise.** Build editable `shape` geometry from the user-shared design.\n  Apply CSS paint to that existing layer with `picsart_scene_import_figma_paint`. Complete Figma\n  design-node import is not supported here. Keep corners, paths and placement editable and text live.\n  Flattening these into a PNG or SVG prevents independent animation of their parts.\n- **When you take assets from a design shared through the user's Figma connector, never take a\n  parent frame in place of its children.** The children are what move.\n- **Flattening to an image is the fallback only** — for a genuinely un-layered source (a rasterised\n  asset, no layer access). When you fall back, say so plainly.\n- The \"export a node for faithful appearance\" habit in\n  [references/figma-extraction.md](references/figma-extraction.md) is about fidelity of *one* element\n  you have already chosen to bring in whole. Do not generalise it into \"raster everything\".\n\n## Build scene by scene, in order\n\nThis matters more than any individual rule below. Do not author the whole timeline and then present\nit. Do not prototype a striking mid-story beat first either: motion designed in the middle has\nnothing to be joined to, so it gets thrown away.\n\nStart at the first frame and walk forward. Per scene:\n\n1. **Split by semantic motion units, not just editable layers.** A control, its label and its icon\n   normally share one placement owner. Add child-local motion only for a deliberate state change.\n   Stillness is useful hierarchy and reading time, not a defect. For grouping, panel growth and\n   reflow use linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`).\n2. **Author its motion by adding to what is already built** — appending to the generator where you\n   can run code, patching the same scene where you can't. Never start over: every earlier beat's\n   constants and checks stay, so a new beat cannot silently break a settled one.\n3. **Render that beat and show it as video** over its own window. Motion cannot be reviewed in a\n   still or a contact sheet.\n4. **Take direction and re-render.** Expect several passes on one beat. Direction arrives as\n   qualities, not numbers — \"snappier\", \"decouple the tiles\", \"that element makes noise, drop it\" —\n   and each maps to timing, staggering or element inventory, not to a new design.\n5. **Then design the join into the next scene as its own explicit step.** A scene is not done when\n   it looks right; it is done when its exit and the next scene's entrance are agreed. The join is\n   the part the storyboard does *not* contain, so it is where direction is most specific (\"zoom out,\n   then the next scene arrives *from the camera*, not zoomed in\") and where guessing wastes most.\n\nWhen autonomous iteration is authorized, use these as internal verification gates and show meaningful\nmilestones rather than requesting approval for every beat. For large timelines, use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`) to keep components independently editable.\n\nOnly then move on. Keep the beat table updated as you go — it is the record of what was agreed, and\nthe timeline is long before the build is finished.\n\n## Read the storyboard\n\n- **Canvas x-order is temporal order.** Frames are laid left to right; sort by `x`, not by name.\n- **Frame names lie; the order doesn't.** Duplicate names are common (a designer duplicates a\n  frame and forgets to renumber). Count frames against numbers before concluding one is missing.\n- **Duplicate-named frames are usually A→B poses of one beat.** Diff their layer sets: same\n  children, different transforms means the designer encoded the motion as a delta. That motion is\n  **measurable**, not a design decision you have to make.\n- When the design comes through the user's Figma connector, capture frames one at a time: a whole\n  board captured at once is far wider than it is tall and shrinks to a sliver.\n\nWhat is genuinely yours to design: dwell, easing, and the joins between unpaired frames.\n\nFor each unpaired join, use motion-scene-continuity (fetch with `picsart_scene_recipe`, name `motion-scene-continuity`) to name the\nsemantic relationship and choose persistent layer, catalog transition, hard cut, crossfade, or\ncustom transition before writing mechanics. This storyboard workflow still owns recovery of motion\nimplied by paired design frames; continuity owns only the relationship and representation at their\nboundaries.\n\n## Solve transforms, don't choose them\n\nA uniform scale `s` about an unknown pivot `C` maps `p → C + s(p − C)`. So **one corresponding\ncoordinate pair pins the pivot**:\n\n```\nC = (p2 − s·p1) / (1 − s)\n```\n\nTake `s` from any element's size ratio between the two frames, solve `C`, then **check it against\na second, independent element**. Agreement to a fraction of a pixel means you have the designer's\nactual transform; disagreement means the element moved on its own and needs its own treatment.\n\nWrite the beat table down — measured deltas, the solved pivot, the time allocation.\nNine beats of choreography with numbers will not survive scrollback, and you will want to diff it\nagainst renders.\n\n## Motion rules\n\nFull detail and worked numbers: [references/motion-rules.md](references/motion-rules.md). The\nrules that decide whether a beat reads correctly:\n\n- **Rigid vs independent.** Stagger position/scale only for genuinely *independent* objects (grid\n  tiles, stickers). A card, a lockup, or any object with parts must share **one** geometry clock,\n  or its parts drift out of register mid-flight. Put the stagger on the fade instead.\n- **A fade must be co-terminous with its motion** to read as one gesture. If the fade finishes\n  before the move does, the eye sees two events. Match the easing curves too.\n- **On a flat frame render, a zoom-in is safe; a translate is not.** Scaling up never exposes an\n  edge; translating exposes the image's own trailing edge.\n- **Size entry travel** so the leading part starts just off-canvas — travel `≥ canvas − leftmost_x`.\n  Too little and it begins on screen; far too much is dead time.\n- **Exits accelerate** (`ease_in`). Give two objects different spans for differential acceleration.\n- **Selection chrome is exclusive** — never two marquees at once, and it must not outlive its beat.\n  If element steps overlap their spans, an element loses its selection mid-manipulation.\n\n## Rendering facts that change the authoring\n\n- **Opacity composites in linear light.** It does not scale the encoded sRGB value. To hit a\n  measured brightness, convert through gamma: `opacity = linear(target) / linear(source)`.\n- **Opacity is only a *darkness* control over a black background.** Over a light backdrop it\n  makes a dark subject *lighter* as the backdrop bleeds through. A real dim there needs a dark\n  scrim on top, not opacity on the subject.\n- **`anchor` gives a non-centre pivot** (layer-local pixels from the layer's top-left). Use it for\n  corner-pivot scaling — e.g. scaling about a selection box's top-left so it reads as dragging the\n  bottom-right handle. Do not fake pivots with position keyframes.\n- **Per-character text animation is built in.** A text layer's `content.animations[]` is an After Effects\n  animator + range selector: `basedOn: \"character\"`, plus `randomizeOrder`/`randomizeSeed` for\n  flicker. Stack entries on different seeds so they don't beat in lockstep. The active span is\n  `[start + offset, end + offset]`: a narrow window parks its far edge at the text's end at\n  `offset: 1 − end`, or clears every glyph at `offset: 1 − start` (`1 − w` / `1` only when `start`\n  is 0 — don't use them otherwise). A FULL window (`start:0,end:1`) with a ramp shape is instead\n  one ramp exactly as wide as the text: sweep `offset` `-1 → 1` and each glyph eases over half the\n  sweep, staggered by position rather than switching all at once — see\n  `textAnimationAuthoring.rawSelector` in `picsart_scene_capabilities` for the worked numbers.\n- **Inline SVG must be url-encoded with `#` percent-encoded.** A raw `#` starts a URI fragment and\n  truncates the SVG at its first hex colour.\n- **Measure easing, don't trust preset names.** Sample the value at 25%/75% of a keyframe window\n  and confirm the curve is what you intended.\n\n## Verify numerically\n\nEyeballing a downscaled contact sheet will produce false alarms — it reliably reports position\nerrors that measurement disproves. Compare frames at full resolution, or measure.\n\n- `picsart_scene_validate` checks structure only. It passes on a scene whose layers render nothing.\n- `picsart_scene_query_layout` resolves boxes without rendering — use it to confirm geometry against the\n  Figma numbers before spending a render. It is geometry-only: a resolved box says nothing about\n  whether the content decodes.\n- To find gaps where nothing is on canvas, look at the suspect times with `picsart_scene_contact_sheet` with `times: [t1, t2, …]` and `resolution` set to the scene's `composition.width` and `composition.height`.\n  A frame holding only a small logo can look empty at a glance — check it before calling it a gap.\n- Where you can run code, put the invariants in the **generator** as asserts (solved pivots agreeing, travel long enough,\n  one selection at a time, bounds sane). They catch regressions that a still frame hides.\n\n## Commands\n\nWhere you can run code, maintain the same generator and self-checks. Otherwise use bounded `picsart_scene_patch` edits. Validate with `picsart_scene_validate`, query event geometry with `picsart_scene_query_layout`, and inspect full-resolution stills using `picsart_scene_contact_sheet` with `times: [t1, t2]` (at most 8 times per call) and `resolution` set to the scene's `composition.width` and `composition.height`. Inspect continuous exported video for motion claims.\n\nWithout the generator you lose its `assert`s, so pin each invariant explicitly with `picsart_scene_query_layout`\nafter every `picsart_scene_patch` — solved pivots agreeing, entry travel long enough, one selection at a\ntime, bounds sane.\n\nEach `picsart_scene_patch` returns the patched scene as `scene`: pass that as `scene` to the next\npatch, query, contact sheet or translate.\n"
AFTER
"---\nname: figma-storyboard-animation\ndescription: Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene. A Figma design made into a finished video starts in animate-design.\nmetadata:\n  version: '1.3'\n  ported-from: figma-storyboard-to-scene 1.3 at 55.75.0\n---\n\n# Figma storyboard → scene motion design\n\nA storyboard is a series of static 1920×1080 frames. Your job is to produce one scene whose\ntimeline moves between them. Most of the motion is **already in the design** — recover it rather\nthan invent it.\n\n> **Can't run code?** Everywhere this recipe says \"author a generator script\", build the scene\n> through `picsart_scene_patch` instead and pin the same invariants with\n> `picsart_scene_query_layout` after each change (see Commands below). The method is identical — only the\n> execution surface differs.\n\n## The flow\n\n1. **Read the tree once** — if the user has shared the storyboard through their Figma connector,\n   read the page's frame tree once: it returns every frame, layer, name and box. Everything below is derived from it. Do not walk the board frame by frame to explore.\n2. **Plan the beats** — write the beat table down before authoring (below).\n3. **Extract each element as its own layer** from the design the user shared: construct editable\n   shape geometry from its source measurements and use `picsart_scene_import_figma_paint` for CSS\n   fill, shadow or gradient paint on an existing layer. Keep text live. Automatic shape-node\n   conversion is not exposed here. Use an image only for an unsupported treatment or a genuinely\n   unlayered source; see [extraction](references/figma-extraction.md).\n4. **Build the scene from the geometry, and pin every rule.** Where you can run code, author a\n   generator script (not hand-written JSON) so each rule becomes an `assert`; where you can't,\n   build it through `picsart_scene_patch` and pin the same invariants with\n   `picsart_scene_query_layout`. Geometry comes from the metadata, never from eyeballing.\n5. **Verify numerically**, then export.\n\nSteps 3–5 run **once per scene**, in order — that loop is the method.\n\n## One static frame\n\nWhen the ask is a single frame (a still, a store image, a card), there is no storyboard. Skip the\nbeats and build that frame as a still scene:\n\n1. **Read the selected frame through the user's shared Figma connector.** Its size is `composition.width` and `height`, its fill is\n   `composition.background`, and a short `duration` (`1`) is enough.\n2. **One layer per child, in paint order** (the tree's first child at the bottom). A layer's\n   `position` is its box CENTRE in the frame, `[x + width/2, y + height/2]`: a layer turns and\n   scales about its centre. Cross-check one nested child against the frame: some groups store\n   children relative to the group ([references/figma-extraction.md](references/figma-extraction.md)).\n3. **Each child in the medium that keeps it editable**: author shape geometry, then apply its CSS paint through `picsart_scene_import_figma_paint`,\n   text as live text, and each IMAGE fill as a media layer on its original\n   bitmap — never the node `export`, which flattens transparency onto the frame's background —\n   by its `scaleMode` (`FILL`→`cover`,\n   `FIT`→`contain`, `CROP`→`cover` + `crop`, `TILE`→not expressible; the table and the crop maths are\n   in [references/figma-extraction.md](references/figma-extraction.md), \"Image fills\"). Upload each\n   image first; a Figma asset URL expires.\n4. **A local group that clips or fades as one is usually an inline `composition` layer.** Use a\n   scene reference when it is intentionally a reusable, separately owned component.\n5. **Verify with numbers, then one full picture.** `picsart_scene_query_layout` at `0`: every `box` within a\n   pixel of its Figma box. A top-level image without `crop` carries `drawn`: its box and\n   `sourceCrop` as the design shows them. An image inside a group reads `clippedBox`, the part its\n   group leaves showing.\n   Then one `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions: a thumbnail drops 2 px lines and small text.\n\n## Layers, not screens\n\nThe scene is a composite of **movable layers**, never a montage of flat screens. A design comes in\nas layers; keep them separable so each can move on its own — that is the whole reason for building a\nscene rather than cross-fading screenshots.\n\n- **Reconstruct, don't rasterise.** Build editable `shape` geometry from the user-shared design.\n  Apply CSS paint to that existing layer with `picsart_scene_import_figma_paint`. Complete Figma\n  design-node import is not supported here. Keep corners, paths and placement editable and text live.\n  Flattening these into a PNG or SVG prevents independent animation of their parts.\n- **When you take assets from a design shared through the user's Figma connector, never take a\n  parent frame in place of its children.** The children are what move.\n- **Flattening to an image is the fallback only** — for a genuinely un-layered source (a rasterised\n  asset, no layer access). When you fall back, say so plainly.\n- The \"export a node for faithful appearance\" habit in\n  [references/figma-extraction.md](references/figma-extraction.md) is about fidelity of *one* element\n  you have already chosen to bring in whole. Do not generalise it into \"raster everything\".\n\n## Build scene by scene, in order\n\nThis matters more than any individual rule below. Do not author the whole timeline and then present\nit. Do not prototype a striking mid-story beat first either: motion designed in the middle has\nnothing to be joined to, so it gets thrown away.\n\nStart at the first frame and walk forward. Per scene:\n\n1. **Split by semantic motion units, not just editable layers.** A control, its label and its icon\n   normally share one placement owner. Add child-local motion only for a deliberate state change.\n   Stillness is useful hierarchy and reading time, not a defect. For grouping, panel growth and\n   reflow use linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`).\n2. **Author its motion by adding to what is already built** — appending to the generator where you\n   can run code, patching the same scene where you can't. Never start over: every earlier beat's\n   constants and checks stay, so a new beat cannot silently break a settled one.\n3. **Render that beat and show it as video** over its own window. Motion cannot be reviewed in a\n   still or a contact sheet.\n4. **Take direction and re-render.** Expect several passes on one beat. Direction arrives as\n   qualities, not numbers — \"snappier\", \"decouple the tiles\", \"that element makes noise, drop it\" —\n   and each maps to timing, staggering or element inventory, not to a new design.\n5. **Then design the join into the next scene as its own explicit step.** A scene is not done when\n   it looks right; it is done when its exit and the next scene's entrance are agreed. The join is\n   the part the storyboard does *not* contain, so it is where direction is most specific (\"zoom out,\n   then the next scene arrives *from the camera*, not zoomed in\") and where guessing wastes most.\n\nWhen autonomous iteration is authorized, use these as internal verification gates and show meaningful\nmilestones rather than requesting approval for every beat. For large timelines, use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`) to keep components independently editable.\n\nOnly then move on. Keep the beat table updated as you go — it is the record of what was agreed, and\nthe timeline is long before the build is finished.\n\n## Read the storyboard\n\n- **Canvas x-order is temporal order.** Frames are laid left to right; sort by `x`, not by name.\n- **Frame names lie; the order doesn't.** Duplicate names are common (a designer duplicates a\n  frame and forgets to renumber). Count frames against numbers before concluding one is missing.\n- **Duplicate-named frames are usually A→B poses of one beat.** Diff their layer sets: same\n  children, different transforms means the designer encoded the motion as a delta. That motion is\n  **measurable**, not a design decision you have to make.\n- When the design comes through the user's Figma connector, capture frames one at a time: a whole\n  board captured at once is far wider than it is tall and shrinks to a sliver.\n\nWhat is genuinely yours to design: dwell, easing, and the joins between unpaired frames.\n\nFor each unpaired join, use motion-scene-continuity (fetch with `picsart_scene_recipe`, name `motion-scene-continuity`) to name the\nsemantic relationship and choose persistent layer, catalog transition, hard cut, crossfade, or\ncustom transition before writing mechanics. This storyboard workflow still owns recovery of motion\nimplied by paired design frames; continuity owns only the relationship and representation at their\nboundaries.\n\n## Solve transforms, don't choose them\n\nA uniform scale `s` about an unknown pivot `C` maps `p → C + s(p − C)`. So **one corresponding\ncoordinate pair pins the pivot**:\n\n```\nC = (p2 − s·p1) / (1 − s)\n```\n\nTake `s` from any element's size ratio between the two frames, solve `C`, then **check it against\na second, independent element**. Agreement to a fraction of a pixel means you have the designer's\nactual transform; disagreement means the element moved on its own and needs its own treatment.\n\nWrite the beat table down — measured deltas, the solved pivot, the time allocation.\nNine beats of choreography with numbers will not survive scrollback, and you will want to diff it\nagainst renders.\n\n## Motion rules\n\nFull detail and worked numbers: [references/motion-rules.md](references/motion-rules.md). The\nrules that decide whether a beat reads correctly:\n\n- **Rigid vs independent.** Stagger position/scale only for genuinely *independent* objects (grid\n  tiles, stickers). A card, a lockup, or any object with parts must share **one** geometry clock,\n  or its parts drift out of register mid-flight. Put the stagger on the fade instead.\n- **A fade must be co-terminous with its motion** to read as one gesture. If the fade finishes\n  before the move does, the eye sees two events. Match the easing curves too.\n- **On a flat frame render, a zoom-in is safe; a translate is not.** Scaling up never exposes an\n  edge; translating exposes the image's own trailing edge.\n- **Size entry travel** so the leading part starts just off-canvas — travel `≥ canvas − leftmost_x`.\n  Too little and it begins on screen; far too much is dead time.\n- **Exits accelerate** (`ease_in`). Give two objects different spans for differential acceleration.\n- **Selection chrome is exclusive** — never two marquees at once, and it must not outlive its beat.\n  If element steps overlap their spans, an element loses its selection mid-manipulation.\n\n## Rendering facts that change the authoring\n\n- **Opacity composites in linear light.** It does not scale the encoded sRGB value. To hit a\n  measured brightness, convert through gamma: `opacity = linear(target) / linear(source)`.\n- **Opacity is only a *darkness* control over a black background.** Over a light backdrop it\n  makes a dark subject *lighter* as the backdrop bleeds through. A real dim there needs a dark\n  scrim on top, not opacity on the subject.\n- **`anchor` gives a non-centre pivot** (layer-local pixels from the layer's top-left). Use it for\n  corner-pivot scaling — e.g. scaling about a selection box's top-left so it reads as dragging the\n  bottom-right handle. Do not fake pivots with position keyframes.\n- **Per-character text animation is built in.** A text layer's `content.animations[]` is an After Effects\n  animator + range selector: `basedOn: \"character\"`, plus `randomizeOrder`/`randomizeSeed` for\n  flicker. Stack entries on different seeds so they don't beat in lockstep. The active span is\n  `[start + offset, end + offset]`: a narrow window parks its far edge at the text's end at\n  `offset: 1 − end`, or clears every glyph at `offset: 1 − start` (`1 − w` / `1` only when `start`\n  is 0 — don't use them otherwise). A FULL window (`start:0,end:1`) with a ramp shape is instead\n  one ramp exactly as wide as the text: sweep `offset` `-1 → 1` and each glyph eases over half the\n  sweep, staggered by position rather than switching all at once — see\n  `textAnimationAuthoring.rawSelector` in `picsart_scene_capabilities` for the worked numbers.\n- **Inline SVG must be url-encoded with `#` percent-encoded.** A raw `#` starts a URI fragment and\n  truncates the SVG at its first hex colour.\n- **Measure easing, don't trust preset names.** Sample the value at 25%/75% of a keyframe window\n  and confirm the curve is what you intended.\n\n## Verify numerically\n\nEyeballing a downscaled contact sheet will produce false alarms — it reliably reports position\nerrors that measurement disproves. Compare frames at full resolution, or measure.\n\n- `picsart_scene_validate` checks structure only. It passes on a scene whose layers render nothing.\n- `picsart_scene_query_layout` resolves boxes without rendering — use it to confirm geometry against the\n  Figma numbers before spending a render. It is geometry-only: a resolved box says nothing about\n  whether the content decodes.\n- To find gaps where nothing is on canvas, look at the suspect times with `picsart_scene_contact_sheet` with `times: [t1, t2, …]` and `resolution` set to the scene's `composition.width` and `composition.height`.\n  A frame holding only a small logo can look empty at a glance — check it before calling it a gap.\n- Where you can run code, put the invariants in the **generator** as asserts (solved pivots agreeing, travel long enough,\n  one selection at a time, bounds sane). They catch regressions that a still frame hides.\n\n## Commands\n\nWhere you can run code, maintain the same generator and self-checks. Otherwise use bounded `picsart_scene_patch` edits. Validate with `picsart_scene_validate`, query event geometry with `picsart_scene_query_layout`, and inspect full-resolution stills using `picsart_scene_contact_sheet` with `times: [t1, t2]` (at most 8 times per call) and `resolution` set to the scene's `composition.width` and `composition.height`. Inspect continuous exported video for motion claims.\n\nWithout the generator you lose its `assert`s, so pin each invariant explicitly with `picsart_scene_query_layout`\nafter every `picsart_scene_patch` — solved pivots agreeing, entry travel long enough, one selection at a\ntime, bounds sane.\n\nEach `picsart_scene_patch` returns the patched scene as `scene`: pass that as `scene` to the next\npatch, query, contact sheet or translate.\n"
Full snapshot data
{
  "description": "Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene. A Figma design made into a finished video starts in animate-design.",
  "included_files": [
    {
      "relative_path": "references/figma-extraction.md",
      "size_in_bytes": 10023
    },
    {
      "relative_path": "references/motion-rules.md",
      "size_in_bytes": 7545
    }
  ],
  "name": "figma-storyboard-animation",
  "skill_md_contents": "---\nname: figma-storyboard-animation\ndescription: Turn a Figma storyboard of static frames into an animated scene — read the frame tree, recover the motion the designer already encoded, then build scene by scene, agreeing each transition before moving on; or build a single frame as a still scene. Use when converting a Figma design or storyboard into video/animation, when a designer hands over frames to \"make move\", or when the user mentions Figma frames, storyboard, motion design from design, design-to-animation, animating scene to scene, or turning a mockup into a scene. A Figma design made into a finished video starts in animate-design.\nmetadata:\n  version: '1.3'\n  ported-from: figma-storyboard-to-scene 1.3 at 55.75.0\n---\n\n# Figma storyboard → scene motion design\n\nA storyboard is a series of static 1920×1080 frames. Your job is to produce one scene whose\ntimeline moves between them. Most of the motion is **already in the design** — recover it rather\nthan invent it.\n\n> **Can't run code?** Everywhere this recipe says \"author a generator script\", build the scene\n> through `picsart_scene_patch` instead and pin the same invariants with\n> `picsart_scene_query_layout` after each change (see Commands below). The method is identical — only the\n> execution surface differs.\n\n## The flow\n\n1. **Read the tree once** — if the user has shared the storyboard through their Figma connector,\n   read the page's frame tree once: it returns every frame, layer, name and box. Everything below is derived from it. Do not walk the board frame by frame to explore.\n2. **Plan the beats** — write the beat table down before authoring (below).\n3. **Extract each element as its own layer** from the design the user shared: construct editable\n   shape geometry from its source measurements and use `picsart_scene_import_figma_paint` for CSS\n   fill, shadow or gradient paint on an existing layer. Keep text live. Automatic shape-node\n   conversion is not exposed here. Use an image only for an unsupported treatment or a genuinely\n   unlayered source; see [extraction](references/figma-extraction.md).\n4. **Build the scene from the geometry, and pin every rule.** Where you can run code, author a\n   generator script (not hand-written JSON) so each rule becomes an `assert`; where you can't,\n   build it through `picsart_scene_patch` and pin the same invariants with\n   `picsart_scene_query_layout`. Geometry comes from the metadata, never from eyeballing.\n5. **Verify numerically**, then export.\n\nSteps 3–5 run **once per scene**, in order — that loop is the method.\n\n## One static frame\n\nWhen the ask is a single frame (a still, a store image, a card), there is no storyboard. Skip the\nbeats and build that frame as a still scene:\n\n1. **Read the selected frame through the user's shared Figma connector.** Its size is `composition.width` and `height`, its fill is\n   `composition.background`, and a short `duration` (`1`) is enough.\n2. **One layer per child, in paint order** (the tree's first child at the bottom). A layer's\n   `position` is its box CENTRE in the frame, `[x + width/2, y + height/2]`: a layer turns and\n   scales about its centre. Cross-check one nested child against the frame: some groups store\n   children relative to the group ([references/figma-extraction.md](references/figma-extraction.md)).\n3. **Each child in the medium that keeps it editable**: author shape geometry, then apply its CSS paint through `picsart_scene_import_figma_paint`,\n   text as live text, and each IMAGE fill as a media layer on its original\n   bitmap — never the node `export`, which flattens transparency onto the frame's background —\n   by its `scaleMode` (`FILL`→`cover`,\n   `FIT`→`contain`, `CROP`→`cover` + `crop`, `TILE`→not expressible; the table and the crop maths are\n   in [references/figma-extraction.md](references/figma-extraction.md), \"Image fills\"). Upload each\n   image first; a Figma asset URL expires.\n4. **A local group that clips or fades as one is usually an inline `composition` layer.** Use a\n   scene reference when it is intentionally a reusable, separately owned component.\n5. **Verify with numbers, then one full picture.** `picsart_scene_query_layout` at `0`: every `box` within a\n   pixel of its Figma box. A top-level image without `crop` carries `drawn`: its box and\n   `sourceCrop` as the design shows them. An image inside a group reads `clippedBox`, the part its\n   group leaves showing.\n   Then one `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions: a thumbnail drops 2 px lines and small text.\n\n## Layers, not screens\n\nThe scene is a composite of **movable layers**, never a montage of flat screens. A design comes in\nas layers; keep them separable so each can move on its own — that is the whole reason for building a\nscene rather than cross-fading screenshots.\n\n- **Reconstruct, don't rasterise.** Build editable `shape` geometry from the user-shared design.\n  Apply CSS paint to that existing layer with `picsart_scene_import_figma_paint`. Complete Figma\n  design-node import is not supported here. Keep corners, paths and placement editable and text live.\n  Flattening these into a PNG or SVG prevents independent animation of their parts.\n- **When you take assets from a design shared through the user's Figma connector, never take a\n  parent frame in place of its children.** The children are what move.\n- **Flattening to an image is the fallback only** — for a genuinely un-layered source (a rasterised\n  asset, no layer access). When you fall back, say so plainly.\n- The \"export a node for faithful appearance\" habit in\n  [references/figma-extraction.md](references/figma-extraction.md) is about fidelity of *one* element\n  you have already chosen to bring in whole. Do not generalise it into \"raster everything\".\n\n## Build scene by scene, in order\n\nThis matters more than any individual rule below. Do not author the whole timeline and then present\nit. Do not prototype a striking mid-story beat first either: motion designed in the middle has\nnothing to be joined to, so it gets thrown away.\n\nStart at the first frame and walk forward. Per scene:\n\n1. **Split by semantic motion units, not just editable layers.** A control, its label and its icon\n   normally share one placement owner. Add child-local motion only for a deliberate state change.\n   Stillness is useful hierarchy and reading time, not a defect. For grouping, panel growth and\n   reflow use linked-element-motion (fetch with `picsart_scene_recipe`, name `linked-element-motion`).\n2. **Author its motion by adding to what is already built** — appending to the generator where you\n   can run code, patching the same scene where you can't. Never start over: every earlier beat's\n   constants and checks stay, so a new beat cannot silently break a settled one.\n3. **Render that beat and show it as video** over its own window. Motion cannot be reviewed in a\n   still or a contact sheet.\n4. **Take direction and re-render.** Expect several passes on one beat. Direction arrives as\n   qualities, not numbers — \"snappier\", \"decouple the tiles\", \"that element makes noise, drop it\" —\n   and each maps to timing, staggering or element inventory, not to a new design.\n5. **Then design the join into the next scene as its own explicit step.** A scene is not done when\n   it looks right; it is done when its exit and the next scene's entrance are agreed. The join is\n   the part the storyboard does *not* contain, so it is where direction is most specific (\"zoom out,\n   then the next scene arrives *from the camera*, not zoomed in\") and where guessing wastes most.\n\nWhen autonomous iteration is authorized, use these as internal verification gates and show meaningful\nmilestones rather than requesting approval for every beat. For large timelines, use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`) to keep components independently editable.\n\nOnly then move on. Keep the beat table updated as you go — it is the record of what was agreed, and\nthe timeline is long before the build is finished.\n\n## Read the storyboard\n\n- **Canvas x-order is temporal order.** Frames are laid left to right; sort by `x`, not by name.\n- **Frame names lie; the order doesn't.** Duplicate names are common (a designer duplicates a\n  frame and forgets to renumber). Count frames against numbers before concluding one is missing.\n- **Duplicate-named frames are usually A→B poses of one beat.** Diff their layer sets: same\n  children, different transforms means the designer encoded the motion as a delta. That motion is\n  **measurable**, not a design decision you have to make.\n- When the design comes through the user's Figma connector, capture frames one at a time: a whole\n  board captured at once is far wider than it is tall and shrinks to a sliver.\n\nWhat is genuinely yours to design: dwell, easing, and the joins between unpaired frames.\n\nFor each unpaired join, use motion-scene-continuity (fetch with `picsart_scene_recipe`, name `motion-scene-continuity`) to name the\nsemantic relationship and choose persistent layer, catalog transition, hard cut, crossfade, or\ncustom transition before writing mechanics. This storyboard workflow still owns recovery of motion\nimplied by paired design frames; continuity owns only the relationship and representation at their\nboundaries.\n\n## Solve transforms, don't choose them\n\nA uniform scale `s` about an unknown pivot `C` maps `p → C + s(p − C)`. So **one corresponding\ncoordinate pair pins the pivot**:\n\n```\nC = (p2 − s·p1) / (1 − s)\n```\n\nTake `s` from any element's size ratio between the two frames, solve `C`, then **check it against\na second, independent element**. Agreement to a fraction of a pixel means you have the designer's\nactual transform; disagreement means the element moved on its own and needs its own treatment.\n\nWrite the beat table down — measured deltas, the solved pivot, the time allocation.\nNine beats of choreography with numbers will not survive scrollback, and you will want to diff it\nagainst renders.\n\n## Motion rules\n\nFull detail and worked numbers: [references/motion-rules.md](references/motion-rules.md). The\nrules that decide whether a beat reads correctly:\n\n- **Rigid vs independent.** Stagger position/scale only for genuinely *independent* objects (grid\n  tiles, stickers). A card, a lockup, or any object with parts must share **one** geometry clock,\n  or its parts drift out of register mid-flight. Put the stagger on the fade instead.\n- **A fade must be co-terminous with its motion** to read as one gesture. If the fade finishes\n  before the move does, the eye sees two events. Match the easing curves too.\n- **On a flat frame render, a zoom-in is safe; a translate is not.** Scaling up never exposes an\n  edge; translating exposes the image's own trailing edge.\n- **Size entry travel** so the leading part starts just off-canvas — travel `≥ canvas − leftmost_x`.\n  Too little and it begins on screen; far too much is dead time.\n- **Exits accelerate** (`ease_in`). Give two objects different spans for differential acceleration.\n- **Selection chrome is exclusive** — never two marquees at once, and it must not outlive its beat.\n  If element steps overlap their spans, an element loses its selection mid-manipulation.\n\n## Rendering facts that change the authoring\n\n- **Opacity composites in linear light.** It does not scale the encoded sRGB value. To hit a\n  measured brightness, convert through gamma: `opacity = linear(target) / linear(source)`.\n- **Opacity is only a *darkness* control over a black background.** Over a light backdrop it\n  makes a dark subject *lighter* as the backdrop bleeds through. A real dim there needs a dark\n  scrim on top, not opacity on the subject.\n- **`anchor` gives a non-centre pivot** (layer-local pixels from the layer's top-left). Use it for\n  corner-pivot scaling — e.g. scaling about a selection box's top-left so it reads as dragging the\n  bottom-right handle. Do not fake pivots with position keyframes.\n- **Per-character text animation is built in.** A text layer's `content.animations[]` is an After Effects\n  animator + range selector: `basedOn: \"character\"`, plus `randomizeOrder`/`randomizeSeed` for\n  flicker. Stack entries on different seeds so they don't beat in lockstep. The active span is\n  `[start + offset, end + offset]`: a narrow window parks its far edge at the text's end at\n  `offset: 1 − end`, or clears every glyph at `offset: 1 − start` (`1 − w` / `1` only when `start`\n  is 0 — don't use them otherwise). A FULL window (`start:0,end:1`) with a ramp shape is instead\n  one ramp exactly as wide as the text: sweep `offset` `-1 → 1` and each glyph eases over half the\n  sweep, staggered by position rather than switching all at once — see\n  `textAnimationAuthoring.rawSelector` in `picsart_scene_capabilities` for the worked numbers.\n- **Inline SVG must be url-encoded with `#` percent-encoded.** A raw `#` starts a URI fragment and\n  truncates the SVG at its first hex colour.\n- **Measure easing, don't trust preset names.** Sample the value at 25%/75% of a keyframe window\n  and confirm the curve is what you intended.\n\n## Verify numerically\n\nEyeballing a downscaled contact sheet will produce false alarms — it reliably reports position\nerrors that measurement disproves. Compare frames at full resolution, or measure.\n\n- `picsart_scene_validate` checks structure only. It passes on a scene whose layers render nothing.\n- `picsart_scene_query_layout` resolves boxes without rendering — use it to confirm geometry against the\n  Figma numbers before spending a render. It is geometry-only: a resolved box says nothing about\n  whether the content decodes.\n- To find gaps where nothing is on canvas, look at the suspect times with `picsart_scene_contact_sheet` with `times: [t1, t2, …]` and `resolution` set to the scene's `composition.width` and `composition.height`.\n  A frame holding only a small logo can look empty at a glance — check it before calling it a gap.\n- Where you can run code, put the invariants in the **generator** as asserts (solved pivots agreeing, travel long enough,\n  one selection at a time, bounds sane). They catch regressions that a still frame hides.\n\n## Commands\n\nWhere you can run code, maintain the same generator and self-checks. Otherwise use bounded `picsart_scene_patch` edits. Validate with `picsart_scene_validate`, query event geometry with `picsart_scene_query_layout`, and inspect full-resolution stills using `picsart_scene_contact_sheet` with `times: [t1, t2]` (at most 8 times per call) and `resolution` set to the scene's `composition.width` and `composition.height`. Inspect continuous exported video for motion claims.\n\nWithout the generator you lose its `assert`s, so pin each invariant explicitly with `picsart_scene_query_layout`\nafter every `picsart_scene_patch` — solved pivots agreeing, entry travel long enough, one selection at a\ntime, bounds sane.\n\nEach `picsart_scene_patch` returns the patched scene as `scene`: pass that as `scene` to the next\npatch, query, contact sheet or translate.\n"
}

SHA-256 of public snapshot: 9d9172e9e57649d081f0e6c27fd302c622a2c55f7d497087f42f47192f1b73ef