Skip to content

Write HTML. Render video. Built for agents.

fix(skills): load shared creative guides for motion graphics (#4970)

Miguel Ángel9031a02cb53d
diff --git a/skills-manifest.json b/skills-manifest.json
index 8b26f8941e..6e2ef014cc 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -58,7 +58,7 @@
"files": 104
},
"motion-graphics": {
- "hash": "3d3a35ffbe8b7e3e",
+ "hash": "99f7d86044e7b8ba",
"files": 23
},
"music-to-video": {
diff --git a/skills/motion-graphics/SKILL.md b/skills/motion-graphics/SKILL.md
index 59ec607875..fb5941153b 100644
--- a/skills/motion-graphics/SKILL.md
+++ b/skills/motion-graphics/SKILL.md
@@ -121,6 +121,8 @@ Dispatch a subagent (prompt = `agents/director.md` Part 2 + dispatch context inc
### Step 4 — Build (subagent: Builder, reuse-first)
+Include the shared [motion principles](../hyperframes-creative/references/motion-principles.md) in the Builder's dispatch context. For `charts` and `stat`, also include [data in motion](../hyperframes-creative/references/data-in-motion.md). The Builder reads these guides before writing the timeline.
+
Dispatch a subagent. prompt = full `agents/builder.md` + dispatch context (`shot-plan.json`, `catalog-map.md`, the category's `module.md`, `references/motion-vocabulary.md`, `references/builder-contract.md`). **Reuse-first**: `npx hyperframes add <block>` + customize in place; hand-author only gaps + the asset-fusion affordance. Output `compositions/index.html` honoring the HF contract (paused GSAP timeline on `window.__timelines`, `class="clip"` + stable ids, `tl.seek(0)`, deterministic).
### Step 5 — Verify (Bash → repair subagent on failure)
diff --git a/skills/motion-graphics/agents/builder.md b/skills/motion-graphics/agents/builder.md
index 2e8a026fa1..2947a8e54d 100644
--- a/skills/motion-graphics/agents/builder.md
+++ b/skills/motion-graphics/agents/builder.md
@@ -36,6 +36,10 @@ Build the **hero-frame end-state** in CSS first (flex + padding; never absolute
Opacity-gate delayed elements (set hidden until their entrance). Clamp at tween bounds (no overshoot past a held value). Allowed eases: `power1–4`, `back`, `bounce`, `circ`, `elastic`, `expo`, `sine` (`.in/.out/.inOut`). One motif per scene. Run `hyperframes check` for overflow / collisions.
+## Motion quality
+
+Before writing the timeline, read and follow the shared [motion principles](../../hyperframes-creative/references/motion-principles.md). For `charts` and `stat`, also read [data in motion](../../hyperframes-creative/references/data-in-motion.md) before laying out or animating the data.
+
## Hand off for verification
Self-check the authored file, then return it to the orchestrator. Step 5 runs `hyperframes lint`, `hyperframes check`, and proof snapshots on the assembled project. Do not render. When redispatched with a finding, fix the offending element and never change a fixed `data-duration` during repair. Remotion-source migrations use `/remotion-to-hyperframes` and its SSIM harness instead.
diff --git a/skills/motion-graphics/categories/charts/module.md b/skills/motion-graphics/categories/charts/module.md
index 04039a50c8..c9b579b58c 100644
--- a/skills/motion-graphics/categories/charts/module.md
+++ b/skills/motion-graphics/categories/charts/module.md
@@ -2,6 +2,8 @@
Animated **data-viz** from data. Asset-free (the "input" is the data). "One chart, one message" for short durations.
+Read [data in motion](../../../hyperframes-creative/references/data-in-motion.md) before planning or building. Apply its guidance to default chart choices; preserve a chart type explicitly requested by the user.
+
## Plan (Director)
`content`: `{ type: bar|line|pie|race|pct, data[], labels[], headline, axes: bool }`. For `race`, data must be cumulative/time-staged.
@@ -10,7 +12,7 @@ Animated **data-viz** from data. Asset-free (the "input" is the data). "One char
- Block: **`data-chart`** (animated **bar + line**, staggered reveal, value labels — proven: borrowed + customized + rendered to MP4 in the prototype `charts-demo`).
- Also in the registry: **`bar-chart-race`** — install it rather than hand-authoring a race.
-- Gaps (hand-author): **pie / donut, ring/%** — no registry block covers these. Search first (`npx hyperframes catalog --query "pie chart reveal" --json`), then use D3/visx for data→geometry + GSAP for motion.
+- Gaps (hand-author): **pie / donut, ring/%** — no registry block covers these. Search first (`npx hyperframes catalog --query "pie chart reveal" --json`), then use SVG/CSS for data→geometry + GSAP for motion.
- Signature animations: bar stagger-grow · line `stroke-dashoffset` draw-on · pie radial sweep · ring fill · KPI count-up · race reorder.
## Build (reuse-first)
diff --git a/skills/motion-graphics/categories/stat/module.md b/skills/motion-graphics/categories/stat/module.md
index a283d87e42..074bfe8570 100644
--- a/skills/motion-graphics/categories/stat/module.md
+++ b/skills/motion-graphics/categories/stat/module.md
@@ -2,6 +2,8 @@
A single **hero number** reveal. Asset-free (the "input" is the number). ~4–6s.
+Read [data in motion](../../../hyperframes-creative/references/data-in-motion.md) before planning or building the number reveal.
+
## Plan (Director)
`content`: `{ value, prefix ($), suffix (% / x / K-M-B), label, ring: bool }`. Envelope: bold display font, restrained palette + one accent.