The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.
TypeScript agent-skillsagentic-aiai-agentsai-videobyokclaude-codecodexdeepseek-harnessdsh-plugingenerative-ailocal-firstmcpmotionmotion-graphicsmultimodalopenmotionreverse-engineeringvideo-editingvideo-generationworkbuddy
fix(recreate): verify pointer shapes and interaction outcomes
qindong140a52f3f4e5
diff --git a/skills/motion-recreate/SKILL.md b/skills/motion-recreate/SKILL.mdindex ecae6699..c6ccb9ec 100644--- a/skills/motion-recreate/SKILL.md+++ b/skills/motion-recreate/SKILL.md@@ -72,6 +72,8 @@ Apply the [production decisions](../motion-director/references/production-decisiThen follow [check and deliver](references/verify.md): export the inspected version, read the automatic technical verification, inspect the exported MP4, measure it against the reference with the bundled measurer and fix every failing row before delivery.+Opening the editor is a preview handoff, not completion of these checks. Keep working after it opens; the shared starter draft default does not replace this recreation workflow. Check small objects whose shape carries meaning with close crops as described in rebuild and verify: numerical similarity does not establish the correct contour. If a required check remains blocked or fails after the bounded retries, identify the project as an incomplete draft and state the specific gap.+## 7. DeliverThe project open in the editor is the deliverable. Do not copy, link or attach the exported MP4 or other files unless the user asks for them.diff --git a/skills/motion-recreate/references/rebuild.md b/skills/motion-recreate/references/rebuild.mdindex 5a9cb399..e69835cf 100644--- a/skills/motion-recreate/references/rebuild.md+++ b/skills/motion-recreate/references/rebuild.md@@ -8,6 +8,10 @@ For a link, obtain a local decodable copy using the host's available capabilitieRead the reference as a whole before choosing an implementation. Inspect representative frames and consecutive frames around every cut, entrance, exit and transition. Explain what persists, enters, changes, holds and exits; keep an object's identity across cuts when it is the same object. Learn from observable behaviour rather than guessing the original author's code. A one-per-second overview is for navigation only and is never evidence of motion: it drops 1–3 frame differences, entry directions, blur and flashes at cuts.+When an interaction changes the scene, identify both the actor and the affected content. Inspect the state before contact, the response during the action and the settled result. For a pointer dragging a module, reconstruct the module following the pointer, neighboring modules making room and the final ordering; animating the pointer alone or sliding one module over a stationary neighbor does not reproduce the interaction. Keep these coupled changes together in the editable timing model.++If decoding, frame extraction or seeking fails, recover the media tools using the runtime paths in the Skill's project step, or use another available method that exposes the required frames. Confirm the actual timestamps and inspect the resulting images; a successful command or a screenshot of an unverified playback position does not establish coverage. Keep any unresolved interval or detail explicitly unverified, and continue work that does not depend on it. Report a concrete blocker if the missing evidence cannot be recovered; do not silently replace it with an approximation.+## Measure with the pinned CLIRun `node <hyperframesCli> measure …` with the `hyperframesCli` path from `motion_get_project`. These commands answer specific questions; running every one is not mandatory. Write images into a working directory outside the live project with `--out`, then read them.@@ -33,6 +37,8 @@ Keep content the user will change easy to locate: wording, brand, images, namedUse code for controlled text, geometry and motion; use supplied or cropped photos, logos, screenshots and textures as local assets. Choose 2D, perspective layers or real 3D according to the observed behaviour and the needed edits. Canvas/WebGL follows the pinned runtime's seek and readiness contract: derive the picture from input time and settings, including deterministic randomness, so the same time always renders the same frame.+For small objects whose shape carries meaning, inspect a close crop before choosing the geometry. Match the silhouette, concavities, orientation, proportions, stroke and attachment to nearby labels, not just the colour and bounding box. For example, a mouse pointer with an inset is not a solid triangle; rotating the triangle cannot restore the missing contour. Use an editable vector path or the appropriate local asset when a CSS primitive cannot represent the observed shape. Check repeated instances and changed states against the reference.+Do not pass off playback of the entire reference, a full-frame image sequence, editable content baked into a background, or an unadaptable per-frame contour transcription as a rebuild. Time-driven functions, loops, arrays, simulations and shape interpolation are valid when the content stays reasonably editable.## Assets, text and fonts in this packagediff --git a/skills/motion-recreate/references/verify.md b/skills/motion-recreate/references/verify.mdindex 7b9fa6e1..e10968ff 100644--- a/skills/motion-recreate/references/verify.md+++ b/skills/motion-recreate/references/verify.md@@ -12,9 +12,13 @@ Inspect representative frames of the exported file at the delivered size:- Unchanged parts and the reference's craft (density, camera motion, type) still look like the original.- Text fits, media crops correctly, and the original's hard cuts stay hard unless a change removed them.+Compare close crops of objects whose shape carries meaning, including any detail the user reported as wrong, at corresponding reference and output times. Check silhouette and orientation as well as size, colour, label placement and motion. Keep these visual results separate from the numerical checks below: the measurer reports brightness, detail, colour and bounds, not whether a pointer, icon or logo has the correct contour. Passing global metrics or equal element heights cannot clear a visibly wrong shape.++Verify the consequence of each meaningful interaction, not only the moving actor. Compare the affected content before, during and after the action in both videos. A drag-to-reorder check must show the dragged module following contact, the displaced module yielding and the expected final ordering persisting after release. Record a missing or incorrect state change as failed even when pointer geometry, trajectory and whole-frame metrics pass.+## 3. Measure with numbers-Looking is not enough, and this step cannot be skipped or recorded as "not run". Measure at least one moment in every segment you found while reading the reference (the parts between cuts and major changes), including the opening, the densest frame and the ending frame (or the end card when there is one). In a segment that moves, such as a zoom, camera move or transition, pick a moment in the middle of the movement, not a hold before or after it. For each moment, view both frames at the delivered size and run the measurer bundled with this Skill (the Skill directory is the one holding this Skill's `SKILL.md`):+Looking is not enough: complete this step before reporting the recreation as checked. If tools or reference frames remain unavailable after recovery, record the affected check as blocked with its cause; do not omit it or treat it as passed. Measure at least one moment in every segment you found while reading the reference (the parts between cuts and major changes), including the opening, the densest frame and the ending frame (or the end card when there is one). In a segment that moves, such as a zoom, camera move or transition, pick a moment in the middle of the movement, not a hold before or after it. For each moment, view both frames at the delivered size and run the measurer bundled with this Skill (the Skill directory is the one holding this Skill's `SKILL.md`):```shnode <skill directory>/scripts/measure_frame.mjs reference.mp4 remix.mp4 --t <remix seconds> --ref-t <reference seconds> [--region x,y,w,h --ref-region x,y,w,h]@@ -27,8 +31,8 @@ It needs only Node and `ffmpeg`/`ffprobe`; run it with the package's own Node wh- `clipped` is true, or any text, logo or UI element touches or crosses the frame edge or its container. A logo is clipped only where the reference clips its own logo the same way; when the user's logo is a wide lockup and the reference shows a square emblem, use the logo's symbol or fit the whole lockup inside the frame.- `brightness_ok`, `detail_ok` or `accent_ok` is false: the remix is darker, sparser (fewer lines, labels, wireframes) or has lost the reference's coloured lines and fills.-Fix failures by resizing, wrapping, moving, re-timing or adding the missing layers. Never fix them by deleting labels, tiles or layers the reference shows. Export again and re-measure until every row passes. Do not deliver while a row fails; when a row still fails after a changed approach, name it in the reply as a limitation.+Fix failures by correcting geometry, resizing, wrapping, moving, re-timing or adding the missing layers. Never fix them by deleting labels, tiles or layers the reference shows. Export again and repeat the affected visual and numerical checks on that version. Apply the bounded retry guidance in [rebuild](rebuild.md); if a check still fails or is blocked, leave the project available as an incomplete draft and name the remaining difference or blocker. Do not report it as a completed recreation.## 4. Record-Keep the record outside the live project, in the workspace `VERIFY.md` described by the shared verification: the source video and checksum, the material used, requested changes, assumptions, remaining differences, the measurement table (moments, elements, regions, values, results) and every check as passed, failed or not run. Real review evidence can also be stored with `action: "record_review"` on `motion_export_request`. Humans decide visual acceptance.+Keep the record outside the live project, in the workspace `VERIFY.md` described by the shared verification: the source video and checksum, the inspected output version, the material used, requested changes, assumptions, remaining differences, the measurement table (moments, elements, regions, values, results), the compared crops and visual findings, and every check as passed, failed, blocked or not run. Real review evidence can also be stored with `action: "record_review"` on `motion_export_request`, using only statuses supported by its schema and explaining blockers in the evidence. Humans decide visual acceptance.