Motion Craft
Scope
The deliverable is a motion specification for a native composition. General
suggestions about animation or interface behavior remain an ordinary text/code
request; do not choose Higgsedit for the user merely because motion is mentioned.
Use native composition motion only. There is no HTML animation, CSS, expression evaluator, runtime callback, or playback physics clock.
Runtime and loading
Use the installed $video-editing skill for project creation, sandbox execution,
media transfer and rendering. Inspect the installed CLI help and types/fable.d.ts
before selecting APIs: a newer skill does not update the hosted renderer. Use only
supported native motion; frame choreography and shared timelines below require a
matching CLI. On older versions, use supported raw tracks for equivalent behavior
or explain the specific missing capability. Do not upgrade the shared runtime.
Read only the references needed for the selected motion technique. Start with the
relevant timing or layout contract; do not load all eight references by default.
Motion APIs
- Frame choreography: set
motion on frame(...) or <frame motion={...}>. It supports named poses, local cues, enter, settle, exit, and literal motion.timeline data. Pose fields are x, y, scale, scaleX, scaleY, opacity, and rotation.
- Raw tracks: set
animate: [{ property, from, to, at, duration, easing }] or use keyframes: [{ at, value, easing? }]. Use raw tracks for properties outside the frame-pose set.
- Token text motion:
<text motion={{ by: "word", from: { opacity: 0, y: 20 }, at: 0, duration: 0.4, overlap: 0.5, easing: "house" }}>Text</text>. by is "character" | "word" | "line"; accepted easing is "linear" | "ease-out" | "house".
- Shared choreography: one timeline leaf can bind the same progress to multiple immediate child frames through
targets. A pose-only leaf remains continuously interpolated. If any binding is a counter, the whole leaf uses held samples at scene fps, including pose bindings, with at most 256 samples.
Choreography compiles into editable native property tracks and bounded text states when the script builds. Rebuilding the script recompiles it; human timeline edits do not rerun choreography.
References
- Timing and phases
- Easing and sampled curves
- Token text motion
- Frame layout and transforms
- Timelines, targets, and cues
- Steps and counters
- Raw animation forms
- Validation and limits
1---2name: motion-craft3description: >4 Design concrete motion tracks for native Higgsedit compositions:5 frame choreography, timed text entrances, shared timelines and counters.6 Use for authoring how a native composition animates. General animation7 ideas, UI advice and CSS or JavaScript snippets do not activate this skill.8 Use video-editing for project assembly, footage edits and rendering.9metadata:10 source: https://skillmd.com/skills/jhamidun/motion-craft11 source_revision: "5073f3a09d3f6b0469db9ff7e8a9df0d339f743a"12---1314# Motion Craft1516## Scope1718The deliverable is a motion specification for a native composition. General19suggestions about animation or interface behavior remain an ordinary text/code20request; do not choose Higgsedit for the user merely because motion is mentioned.2122Use native composition motion only. There is no HTML animation, CSS, expression evaluator, runtime callback, or playback physics clock.2324## Runtime and loading2526Use the installed `$video-editing` skill for project creation, sandbox execution,27media transfer and rendering. Inspect the installed CLI help and `types/fable.d.ts`28before selecting APIs: a newer skill does not update the hosted renderer. Use only29supported native motion; frame choreography and shared timelines below require a30matching CLI. On older versions, use supported raw tracks for equivalent behavior31or explain the specific missing capability. Do not upgrade the shared runtime.3233Read only the references needed for the selected motion technique. Start with the34relevant timing or layout contract; do not load all eight references by default.3536## Motion APIs3738- Frame choreography: set `motion` on `frame(...)` or `<frame motion={...}>`. It supports named `poses`, local `cues`, `enter`, `settle`, `exit`, and literal `motion.timeline` data. Pose fields are `x`, `y`, `scale`, `scaleX`, `scaleY`, `opacity`, and `rotation`.39- Raw tracks: set `animate: [{ property, from, to, at, duration, easing }]` or use `keyframes: [{ at, value, easing? }]`. Use raw tracks for properties outside the frame-pose set.40- Token text motion: `<text motion={{ by: "word", from: { opacity: 0, y: 20 }, at: 0, duration: 0.4, overlap: 0.5, easing: "house" }}>Text</text>`. `by` is `"character" | "word" | "line"`; accepted easing is `"linear" | "ease-out" | "house"`.41- Shared choreography: one timeline leaf can bind the same progress to multiple immediate child frames through `targets`. A pose-only leaf remains continuously interpolated. If any binding is a `counter`, the whole leaf uses held samples at scene fps, including pose bindings, with at most 256 samples.4243Choreography compiles into editable native property tracks and bounded text states when the script builds. Rebuilding the script recompiles it; human timeline edits do not rerun choreography.4445## References4647- [Timing and phases](references/timing.md)48- [Easing and sampled curves](references/easing.md)49- [Token text motion](references/typography.md)50- [Frame layout and transforms](references/composition.md)51- [Timelines, targets, and cues](references/causality.md)52- [Steps and counters](references/stepped.md)53- [Raw animation forms](references/recipes.md)54- [Validation and limits](references/qc.md)