[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6BY11T76SD3XQ74BYFFT886":3,"skill-same:01M6BY11T76SD3XQ74BYFFT886":72},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":54,"ownerHtmlUrl":55,"ownerBlogUrl":12,"ownerDescription":56,"updatedAt":57,"install":58,"resources":71},"01M6BY11T76SD3XQ74BYFFT886","motion-principles",null,"Choose timing, easing, stagger, anticipation, and follow-through for a NodeTool timeline. Use when motion feels stiff, floaty, busy, or late, or when an entrance, transition, or beat-bound animation needs a duration and curve. The op contract lives in timeline-edit-ops; the build loop is motion-graphics.","nodetool-ai\u002Fnodetool","nodetool-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F164873569?v=4","01M6BXPFDW36K9K1MR8ZH63HG2","nodetool.ai","01M6BXPFJ893XM219GQN60B0WK",635,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fmotion-principles\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"motion principles","principles","motion","when","graphics","transition","curve","for","motion-graphics","timing","contract","build","use","ops","edit","nodetool","choose","loop","Animation","timeline","2026-11-10 10:12:30",false,"---\nname: motion-principles\ndescription: Choose timing, easing, stagger, anticipation, and follow-through for a NodeTool timeline. Use when motion feels stiff, floaty, busy, or late, or when an entrance, transition, or beat-bound animation needs a duration and curve. The op contract lives in timeline-edit-ops; the build loop is motion-graphics.\n---\n\n# Motion Principles → the numbers before the call\n\n`timeline-edit-ops` is how to write an animation onto a clip with\n`edit_timeline`. This is how to decide what to write. Every number here is in\nthe units `animate_clip` takes: milliseconds, a normalized 0..1 distance, an\neasing string.\n\n## The same numbers, written as code\n\nBuilding with `@nodetool-ai\u002Fsandbox-timeline` instead (`motion-graphics`\npicks the surface)? Every number below still applies — only the unit\nchanges. `durationMs` becomes `dur` in seconds (divide by 1000: 400ms is\n`dur: 0.4`). A normalized 0..1 distance becomes actual px, against the\nframe's own `width`\u002F`height` (0.3 on a 1920-wide frame is `offsetX: 576` in\n`from`). Easing strings are identical — `ease: \"outExpo\"` or a raw curve —\nand every role still means the same thing: `el.enter()` is `in`, `el.exit()`\nis `out`, `el.animate()` covers `emphasis` and general keyframing,\n`el.loop()` is `loop`. `el.count()`, `el.draw()`, `el.scramble()`,\n`el.typewriter()`, `el.expr()` and `el.morph()` have no ops equivalent\nbelow; they are shortcuts for a ticker, a `trimEnd` draw-on, a scramble\nreveal, a whole-clip typewriter entrance, a hand-written keyframe function,\nand a path outline morph.\n\n## Settle three things before picking a number\n\n| Pillar | The question | What it decides |\n|---|---|---|\n| Emotional intent | What should the viewer feel? | Easing, duration, overshoot |\n| Visual narrative | Setup, action, resolution — what enters when? | Sequencing, `delayMs`, stagger |\n| Motion craft | Why does it look believable? | Anticipation, follow-through, arcs |\n\nA number chosen before the intent is a number you will change twice.\n\n## Three layers, or the frame reads flat\n\nPlan three levels of attention. Track index controls their z-order, while\ntiming decides which one the eye follows:\n\n- **Primary** — the one move the eye follows. The clip the shot is about.\n- **Secondary** — supporting motion reacting to the primary: a scrim settling\n  late, a label arriving 80ms after the plate.\n- **Ambient** — background life that never asks for attention. A `loop` preset\n  at low amplitude on the bed.\n\n`motion-direction` ranks the same three as Hero \u002F Support \u002F Texture and decides\nwhich elements earn each. Two clips carrying primary motion at once is the most\ncommon cause of a busy frame.\n\n## Easing is the biggest lever\n\n`linear` reads as robotic. Keep it for motion that never lands: the `loop`\npresets `float`, `rotate` and `hueShift`, and the `shake` emphasis, whose\nzig-zag is linear by default. Everything the eye reads as an event decelerates\ninto rest.\n\n| Action | Easing | Why |\n|---|---|---|\n| Entrance (`in`) | `easeOut`, or `cubic-bezier(0.16,1,0.3,1)` for a sharper landing | Arrives with energy, settles |\n| Exit (`out`) | `easeIn`, or `cubic-bezier(0.7,0,0.84,0)` | Accelerates away |\n| A move that stays on screen | `easeInOut`, or `cubic-bezier(0.65,0,0.35,1)` | Symmetric, no false weight |\n| Playful landing | `easeOutBack`, or `cubic-bezier(0.34,1.56,0.64,1)` | The value past 1 is the overshoot |\n| Physical settle | `spring(180,12,1)` one overshoot, `spring(180,26,1)` none | Solves a real spring; all three constants positive |\n| Held pose, then jump | `hold` on the ending keyframe's segment | Keeps the prior value until the segment ends |\n\nThe role defaults already do the right thing: `in` gets `easeOut`, `out` gets\n`easeIn`. Leave `easing` unset unless you want something the default is not.\nA string the parser cannot read eases linearly and reports `unknown_easing` —\n`easeOut`, never `ease-out`.\n\nOvershoot reads as toy-like. Keep `easeOutBack`, `easeOutElastic` and\n`easeOutBounce` off anything financial, medical or corporate.\n\n## Duration carries weight\n\n| Element | `durationMs` |\n|---|---|\n| Micro beat: a `flash`, a `pulse` on a small element | 150–250 |\n| Title, lower third, overlay entrance | 300–500 |\n| Hero element, full-frame plate, a `blur` rack | 500–800 |\n| Camera move: a slow push or drift | 1500–4000 |\n\nDistance and area scale it. A caption travelling `distance: 0.05` and a\nfull-bleed plate travelling `0.5` must not share 400ms — the plate looks\nweightless. Add roughly 30–50% when the travel or the area doubles.\n\nTwo limits the engine enforces rather than warns about in prose:\n\n- `in` + `out` must fit the clip with hold left over. Over-long windows report\n  `animation_exceeds_clip`.\n- A `loop` cycle longer than the clip shows a fragment. `kenBurns` is the\n  exception: it ignores `durationMs` and always spans the whole clip, so the\n  clip's length is its duration. Give a Ken Burns move a clip in the camera-move\n  range above.\n\n## Holds\n\nThese are the hold values every other motion skill defers to:\n\n- **Read hold.** Anything meant to be read — a title, a lower third, an end\n  card, a logo — rests at least 1000ms between its `in` settling and its `out`\n  starting, or before the cut. A 3000ms title with 500ms each way holds 2000ms.\n  Under 1000ms the element never settles and reads as a glitch.\n- **Rest between moves.** Two consecutive moves on the same hero or support\n  element leave at least 400ms with that element still. Ambient `loop` motion\n  on the bed does not count against it and keeps running.\n\n## Stagger is rhythm, and it is clamped\n\nNever reveal a group in one event. On a text clip, `stagger` splits the\nanimation per word, grapheme or wrapped line. Which `unit` counts what, and how\nthe count changes with the frame, is in `timeline-edit-ops`.\n\n| Content | `offsetMs` |\n|---|---|\n| A short mark or word revealed per character | 30–50 |\n| A phrase that should arrive with texture | 60–100 |\n| A short punchline landing word by word | 150–250 |\n| More than five words | do not stagger — the reader is waiting on the sentence |\n\nThe span is `durationMs + offsetMs × (units − 1)`, halved for `from: \"center\"`.\nWork it out and compare it against the clip's `durationMs` minus `delayMs`. A\nspan that does not fit is **compressed silently**: the engine shrinks the offset,\nnever the per-unit duration, so the line lands flatter than written and only\n`validate_timeline` says so, as `stagger_compressed`.\n\nFor a group of separate clips — three lower-third parts, five icons — stagger by\ngiving each clip's `in` animation a `delayMs` 60–80ms apart, and start the last\nclip no more than about 700ms after the first. Past that the tail drags. This\nstep applies to every clip-to-clip build, including logo parts and strokes.\n\n## The 1\u002F3 rule, in both forms\n\n- **Distance.** Nothing travels more than about a third of the frame in one\n  unbroken move. `slide` with `distance` above 0.35 reads as \"the template\n  moved\". Break it with a scale or opacity change on the same window, or shorten\n  the travel.\n- **Simultaneity.** With three or more elements, keep at most a third in active\n  motion at any instant. The rest hold, or run ambient loops.\n\n## Anticipation, follow-through, arcs\n\nThe three that separate animated from moved. None has a preset; each is a\n`custom` animation, which is where a short `code` body earns its place.\n\n**Anticipation** — a counter-move of 60–120ms before the main action. Ask for a\ndip before a pop:\n\n```json\n{\"role\": \"in\", \"preset\": \"custom\", \"durationMs\": 520,\n \"curves\": [{\"property\": \"scale\", \"keyframes\": [\n   {\"t\": 0, \"value\": 1}, {\"t\": 0.2, \"value\": 0.94, \"easing\": \"easeInOut\"},\n   {\"t\": 0.75, \"value\": 1.06, \"easing\": \"easeOut\"}, {\"t\": 1, \"value\": 1}]}]}\n```\n\n**Follow-through** — attached parts settle 40–80ms after the body. Give the\nchild clip the same preset and a `delayMs` 60ms later, rather than animating the\nwhole group as one block.\n\n**Arcs** — straight-line translation of anything organic looks mechanical. Drive\n`offsetX` linearly and `offsetY` as a shallow curve over the same window; the\ntwo fold as `add`, so they compose.\n\nA decaying bounce, an arc, or a settle written as a function of time is a `code`\nbody returning `samples` — one bag per point, `{t, offsetY}`, at\n`inputs.sampleCount` points. The body runs once at author time, hermetically, and\nreads `role`, `durationMs`, `clipDurationMs`, `canvasWidth`, `canvasHeight`,\n`params`, `staggerCount` and `sampleCount` off `inputs`:\n\n```js\n\u002F\u002F fragment\nconst n = inputs.sampleCount;\nconst h = 0.06 * inputs.canvasHeight;\nconst samples = [];\nfor (let i = 0; i \u003C n; i++) {\n  const t = i \u002F (n - 1);\n  \u002F\u002F three decaying hops, ending exactly at rest\n  const y = -h * Math.abs(Math.sin(Math.PI * 3 * t)) * (1 - t);\n  samples.push({ t, offsetY: y });\n}\nreturn { samples };\n```\n\nLand the last sample on the identity value — 0 for an offset, 1 for a scale or\nan opacity — when the motion should settle. An `in` curve contributes nothing\nafter its window, an `out` curve holds its last value after the window, and an\n`emphasis` curve returns to its base outside the window.\n\n## Rhythm against audio\n\nLand impact keyframes on the beat. At 120 BPM a beat is 500ms and the eighth\ngrid is 250ms. `beat-sync-editing` turns detected onsets into markers and\nsnaps. For motion that should follow later tempo edits, store `beat` on the\nanimation in the full timeline document. Its `index` is one-based, `scope`\nis `clip` or `sequence`, and `offsetMs` can place anticipation before the hit.\n`edit_timeline`'s `animate_clip` input does not author this field; use\n`get_timeline` and `set_timeline_document` as described in `timeline-edit-ops`.\n\n```json\n{\"id\":\"impact\",\"role\":\"emphasis\",\"preset\":\"pulse\",\"durationMs\":240,\"beat\":{\"index\":3,\"scope\":\"sequence\",\"offsetMs\":-20}}\n```\n\nA move ending 80ms after a hit reads late, and one ending 80ms before it can\nweaken the impact. Use `offsetMs` deliberately for anticipation.\n\nWith no music, keep one major event per 500–800ms so the piece breathes at a\nconstant pulse.\n\n## Spring or duration\n\n`spring(stiffness,damping,mass)` shapes the motion inside the animation's\n`durationMs`; it is scaled to settle near the end of that window. Use it for a\nphysical-looking landing, then set `durationMs` against the cut as you would\nfor any other easing. For a precise held pose or hard timecode, write\nkeyframes and put `hold` on the segment that should stay still.\n\n## Frame texture\n\nUse per-clip `motionBlur` when a fast move strobes. Start with a 180-degree\nshutter and raise `samplesPerFrame` only as far as the frame needs; the highest\nrequested sample count is shared by the scene. Use `steppedTime.fps` for a\ndeliberate low-frame-rate look, or `temporalEcho` for delayed copies. These are\nstored clip fields written through `set_timeline_document`, not\n`animate_clip` parameters.\n\n## Diagnosing\n\n| It feels | Because | Fix |\n|---|---|---|\n| Stiff, robotic | `linear` or a symmetric curve on an entrance | `easeOut`, or drop `easing` and take the role default |\n| Floaty, slow | Duration too long, curve too gentle | Cut 30%, sharpen to `cubic-bezier(0.16,1,0.3,1)` |\n| Cheap, janky | Everything arrives at once, one duration for every size | Stagger, and scale duration with area |\n| Mechanical despite easing | No anticipation, no overlap, straight-line paths | A `custom` dip before the move; 60ms offsets on attached parts |\n| Busy | Two primary moves in one frame | Demote one to a loop or hold it still |\n| Staggered text does not look staggered | Span exceeded the clip and was compressed | Lengthen the clip or lower `offsetMs` yourself |\n\n## Quick reference\n\n| Need | Value |\n|---|---|\n| Entrance | `easeOut` \u002F `cubic-bezier(0.16,1,0.3,1)`, 300–500ms |\n| Exit | `easeIn` \u002F `cubic-bezier(0.7,0,0.84,0)`, 200–300ms |\n| Move in place | `easeInOut`, 300–400ms |\n| Playful landing | `easeOutBack`, 400–600ms |\n| Word stagger | 60–100ms, five words or fewer |\n| Character stagger | 30–50ms |\n| Clip-to-clip stagger | 60–80ms `delayMs` steps, last clip starts ≤ 700ms after the first |\n| Read hold | ≥ 1000ms at rest before the `out` or the cut |\n| Rest between moves | ≥ 400ms still between two moves of one element |\n| Continuous loop | `linear` when constant speed is intended |\n| Travel cap | `distance` ≤ 0.35 without a second channel |\n","# Motion Principles → the numbers before the call\n\n`timeline-edit-ops` is how to write an animation onto a clip with\n`edit_timeline`. This is how to decide what to write. Every number here is in\nthe units `animate_clip` takes: milliseconds, a normalized 0..1 distance, an\neasing string.\n\n## The same numbers, written as code\n\nBuilding with `@nodetool-ai\u002Fsandbox-timeline` instead (`motion-graphics`\npicks the surface)? Every number below still applies — only the unit\nchanges. `durationMs` becomes `dur` in seconds (divide by 1000: 400ms is\n`dur: 0.4`). A normalized 0..1 distance becomes actual px, against the\nframe's own `width`\u002F`height` (0.3 on a 1920-wide frame is `offsetX: 576` in\n`from`). Easing strings are identical — `ease: \"outExpo\"` or a raw curve —\nand every role still means the same thing: `el.enter()` is `in`, `el.exit()`\nis `out`, `el.animate()` covers `emphasis` and general keyframing,\n`el.loop()` is `loop`. `el.count()`, `el.draw()`, `el.scramble()`,\n`el.typewriter()`, `el.expr()` and `el.morph()` have no ops equivalent\nbelow; they are shortcuts for a ticker, a `trimEnd` draw-on, a scramble\nreveal, a whole-clip typewriter entrance, a hand-written keyframe function,\nand a path outline morph.\n\n## Settle three things before picking a number\n\n| Pillar | The question | What it decides |\n|---|---|---|\n| Emotional intent | What should the viewer feel? | Easing, duration, overshoot |\n| Visual narrative | Setup, action, resolution — what enters when? | Sequencing, `delayMs`, stagger |\n| Motion craft | Why does it look believable? | Anticipation, follow-through, arcs |\n\nA number chosen before the intent is a number you will change twice.\n\n## Three layers, or the frame reads flat\n\nPlan three levels of attention. Track index controls their z-order, while\ntiming decides which one the eye follows:\n\n- **Primary** — the one move the eye follows. The clip the shot is about.\n- **Secondary** — supporting motion reacting to the primary: a scrim settling\n  late, a label arriving 80ms after the plate.\n- **Ambient** — background life that never asks for attention. A `loop` preset\n  at low amplitude on the bed.\n\n`motion-direction` ranks the same three as Hero \u002F Support \u002F Texture and decides\nwhich elements earn each. Two clips carrying primary motion at once is the most\ncommon cause of a busy frame.\n\n## Easing is the biggest lever\n\n`linear` reads as robotic. Keep it for motion that never lands: the `loop`\npresets `float`, `rotate` and `hueShift`, and the `shake` emphasis, whose\nzig-zag is linear by default. Everything the eye reads as an event decelerates\ninto rest.\n\n| Action | Easing | Why |\n|---|---|---|\n| Entrance (`in`) | `easeOut`, or `cubic-bezier(0.16,1,0.3,1)` for a sharper landing | Arrives with energy, settles |\n| Exit (`out`) | `easeIn`, or `cubic-bezier(0.7,0,0.84,0)` | Accelerates away |\n| A move that stays on screen | `easeInOut`, or `cubic-bezier(0.65,0,0.35,1)` | Symmetric, no false weight |\n| Playful landing | `easeOutBack`, or `cubic-bezier(0.34,1.56,0.64,1)` | The value past 1 is the overshoot |\n| Physical settle | `spring(180,12,1)` one overshoot, `spring(180,26,1)` none | Solves a real spring; all three constants positive |\n| Held pose, then jump | `hold` on the ending keyframe's segment | Keeps the prior value until the segment ends |\n\nThe role defaults already do the right thing: `in` gets `easeOut`, `out` gets\n`easeIn`. Leave `easing` unset unless you want something the default is not.\nA string the parser cannot read eases linearly and reports `unknown_easing` —\n`easeOut`, never `ease-out`.\n\nOvershoot reads as toy-like. Keep `easeOutBack`, `easeOutElastic` and\n`easeOutBounce` off anything financial, medical or corporate.\n\n## Duration carries weight\n\n| Element | `durationMs` |\n|---|---|\n| Micro beat: a `flash`, a `pulse` on a small element | 150–250 |\n| Title, lower third, overlay entrance | 300–500 |\n| Hero element, full-frame plate, a `blur` rack | 500–800 |\n| Camera move: a slow push or drift | 1500–4000 |\n\nDistance and area scale it. A caption travelling `distance: 0.05` and a\nfull-bleed plate travelling `0.5` must not share 400ms — the plate looks\nweightless. Add roughly 30–50% when the travel or the area doubles.\n\nTwo limits the engine enforces rather than warns about in prose:\n\n- `in` + `out` must fit the clip with hold left over. Over-long windows report\n  `animation_exceeds_clip`.\n- A `loop` cycle longer than the clip shows a fragment. `kenBurns` is the\n  exception: it ignores `durationMs` and always spans the whole clip, so the\n  clip's length is its duration. Give a Ken Burns move a clip in the camera-move\n  range above.\n\n## Holds\n\nThese are the hold values every other motion skill defers to:\n\n- **Read hold.** Anything meant to be read — a title, a lower third, an end\n  card, a logo — rests at least 1000ms between its `in` settling and its `out`\n  starting, or before the cut. A 3000ms title with 500ms each way holds 2000ms.\n  Under 1000ms the element never settles and reads as a glitch.\n- **Rest between moves.** Two consecutive moves on the same hero or support\n  element leave at least 400ms with that element still. Ambient `loop` motion\n  on the bed does not count against it and keeps running.\n\n## Stagger is rhythm, and it is clamped\n\nNever reveal a group in one event. On a text clip, `stagger` splits the\nanimation per word, grapheme or wrapped line. Which `unit` counts what, and how\nthe count changes with the frame, is in `timeline-edit-ops`.\n\n| Content | `offsetMs` |\n|---|---|\n| A short mark or word revealed per character | 30–50 |\n| A phrase that should arrive with texture | 60–100 |\n| A short punchline landing word by word | 150–250 |\n| More than five words | do not stagger — the reader is waiting on the sentence |\n\nThe span is `durationMs + offsetMs × (units − 1)`, halved for `from: \"center\"`.\nWork it out and compare it against the clip's `durationMs` minus `delayMs`. A\nspan that does not fit is **compressed silently**: the engine shrinks the offset,\nnever the per-unit duration, so the line lands flatter than written and only\n`validate_timeline` says so, as `stagger_compressed`.\n\nFor a group of separate clips — three lower-third parts, five icons — stagger by\ngiving each clip's `in` animation a `delayMs` 60–80ms apart, and start the last\nclip no more than about 700ms after the first. Past that the tail drags. This\nstep applies to every clip-to-clip build, including logo parts and strokes.\n\n## The 1\u002F3 rule, in both forms\n\n- **Distance.** Nothing travels more than about a third of the frame in one\n  unbroken move. `slide` with `distance` above 0.35 reads as \"the template\n  moved\". Break it with a scale or opacity change on the same window, or shorten\n  the travel.\n- **Simultaneity.** With three or more elements, keep at most a third in active\n  motion at any instant. The rest hold, or run ambient loops.\n\n## Anticipation, follow-through, arcs\n\nThe three that separate animated from moved. None has a preset; each is a\n`custom` animation, which is where a short `code` body earns its place.\n\n**Anticipation** — a counter-move of 60–120ms before the main action. Ask for a\ndip before a pop:\n\n```json\n{\"role\": \"in\", \"preset\": \"custom\", \"durationMs\": 520,\n \"curves\": [{\"property\": \"scale\", \"keyframes\": [\n   {\"t\": 0, \"value\": 1}, {\"t\": 0.2, \"value\": 0.94, \"easing\": \"easeInOut\"},\n   {\"t\": 0.75, \"value\": 1.06, \"easing\": \"easeOut\"}, {\"t\": 1, \"value\": 1}]}]}\n```\n\n**Follow-through** — attached parts settle 40–80ms after the body. Give the\nchild clip the same preset and a `delayMs` 60ms later, rather than animating the\nwhole group as one block.\n\n**Arcs** — straight-line translation of anything organic looks mechanical. Drive\n`offsetX` linearly and `offsetY` as a shallow curve over the same window; the\ntwo fold as `add`, so they compose.\n\nA decaying bounce, an arc, or a settle written as a function of time is a `code`\nbody returning `samples` — one bag per point, `{t, offsetY}`, at\n`inputs.sampleCount` points. The body runs once at author time, hermetically, and\nreads `role`, `durationMs`, `clipDurationMs`, `canvasWidth`, `canvasHeight`,\n`params`, `staggerCount` and `sampleCount` off `inputs`:\n\n```js\n\u002F\u002F fragment\nconst n = inputs.sampleCount;\nconst h = 0.06 * inputs.canvasHeight;\nconst samples = [];\nfor (let i = 0; i \u003C n; i++) {\n  const t = i \u002F (n - 1);\n  \u002F\u002F three decaying hops, ending exactly at rest\n  const y = -h * Math.abs(Math.sin(Math.PI * 3 * t)) * (1 - t);\n  samples.push({ t, offsetY: y });\n}\nreturn { samples };\n```\n\nLand the last sample on the identity value — 0 for an offset, 1 for a scale or\nan opacity — when the motion should settle. An `in` curve contributes nothing\nafter its window, an `out` curve holds its last value after the window, and an\n`emphasis` curve returns to its base outside the window.\n\n## Rhythm against audio\n\nLand impact keyframes on the beat. At 120 BPM a beat is 500ms and the eighth\ngrid is 250ms. `beat-sync-editing` turns detected onsets into markers and\nsnaps. For motion that should follow later tempo edits, store `beat` on the\nanimation in the full timeline document. Its `index` is one-based, `scope`\nis `clip` or `sequence`, and `offsetMs` can place anticipation before the hit.\n`edit_timeline`'s `animate_clip` input does not author this field; use\n`get_timeline` and `set_timeline_document` as described in `timeline-edit-ops`.\n\n```json\n{\"id\":\"impact\",\"role\":\"emphasis\",\"preset\":\"pulse\",\"durationMs\":240,\"beat\":{\"index\":3,\"scope\":\"sequence\",\"offsetMs\":-20}}\n```\n\nA move ending 80ms after a hit reads late, and one ending 80ms before it can\nweaken the impact. Use `offsetMs` deliberately for anticipation.\n\nWith no music, keep one major event per 500–800ms so the piece breathes at a\nconstant pulse.\n\n## Spring or duration\n\n`spring(stiffness,damping,mass)` shapes the motion inside the animation's\n`durationMs`; it is scaled to settle near the end of that window. Use it for a\nphysical-looking landing, then set `durationMs` against the cut as you would\nfor any other easing. For a precise held pose or hard timecode, write\nkeyframes and put `hold` on the segment that should stay still.\n\n## Frame texture\n\nUse per-clip `motionBlur` when a fast move strobes. Start with a 180-degree\nshutter and raise `samplesPerFrame` only as far as the frame needs; the highest\nrequested sample count is shared by the scene. Use `steppedTime.fps` for a\ndeliberate low-frame-rate look, or `temporalEcho` for delayed copies. These are\nstored clip fields written through `set_timeline_document`, not\n`animate_clip` parameters.\n\n## Diagnosing\n\n| It feels | Because | Fix |\n|---|---|---|\n| Stiff, robotic | `linear` or a symmetric curve on an entrance | `easeOut`, or drop `easing` and take the role default |\n| Floaty, slow | Duration too long, curve too gentle | Cut 30%, sharpen to `cubic-bezier(0.16,1,0.3,1)` |\n| Cheap, janky | Everything arrives at once, one duration for every size | Stagger, and scale duration with area |\n| Mechanical despite easing | No anticipation, no overlap, straight-line paths | A `custom` dip before the move; 60ms offsets on attached parts |\n| Busy | Two primary moves in one frame | Demote one to a loop or hold it still |\n| Staggered text does not look staggered | Span exceeded the clip and was compressed | Lengthen the clip or lower `offsetMs` yourself |\n\n## Quick reference\n\n| Need | Value |\n|---|---|\n| Entrance | `easeOut` \u002F `cubic-bezier(0.16,1,0.3,1)`, 300–500ms |\n| Exit | `easeIn` \u002F `cubic-bezier(0.7,0,0.84,0)`, 200–300ms |\n| Move in place | `easeInOut`, 300–400ms |\n| Playful landing | `easeOutBack`, 400–600ms |\n| Word stagger | 60–100ms, five words or fewer |\n| Character stagger | 30–50ms |\n| Clip-to-clip stagger | 60–80ms `delayMs` steps, last clip starts ≤ 700ms after the first |\n| Read hold | ≥ 1000ms at rest before the `out` or the cut |\n| Rest between moves | ≥ 400ms still between two moves of one element |\n| Continuous loop | `linear` when constant speed is intended |\n| Travel cap | `distance` ≤ 0.35 without a second channel |\n",{"name":5,"description":7},"main","c7226baa82daca42a19a5855c116544f97aa8bac","packages\u002Fsystem-skills\u002Fmotion-principles",91,"https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool","https:\u002F\u002Fnodetool.ai\u002F","https:\u002F\u002Fgithub.com\u002Fnodetool-ai","No-code AI development","2026-11-15 03:27:49",{"source":8,"skillName":5,"commands":59,"prompt":69,"zipAvailable":70},[60,63,66],{"tool":61,"command":62},"npx","npx skills add nodetool-ai\u002Fnodetool --skill motion-principles",{"tool":64,"command":65},"bunx","bunx skills add nodetool-ai\u002Fnodetool --skill motion-principles",{"tool":67,"command":68},"pnpm","pnpm dlx skills add nodetool-ai\u002Fnodetool --skill motion-principles","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fmotion-principles\u002FSKILL.md",true,[],[73,82,114,142,156,172],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":81},"01M742MX3Y2ZYK884ZXTRFKB9P","humanizer","Rewrite AI-sounding text so it reads like the writer without changing what it says.\nUse when editing or reviewing prose for AI tells: not-X-but-Y contrasts, one-line\nclosers, staged openers, forced triads, dashes everywhere, inflated claims, sales\nlanguage, stock AI words, bold labels, or filler.","MIT","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fhumanizer\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":83,"name":39,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":95,"publishedAt":44},"01M6BY4D93R0Q9400ZHJ04DXP1","Use the NodeTool MCP server to build, validate, run, and debug visual AI workflows, and to work with assets, collections, and jobs. Use when the user mentions NodeTool or asks for a workflow graph, a node, or a media generation run on their NodeTool server.","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fplugins\u002Fchatgpt\u002Fnodetool\u002Fskills\u002Fnodetool\u002FSKILL.md",[87,90],{"categoryNo":88,"categoryName":89,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":91,"categoryName":92,"taxonomyType":93,"taxonomyTypeDesc":94},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[39,96,97,98,27,99,100,101,102,36,103,31,104,105,106,107,108,109,110,111,112,113],"MCP","Media","workflows","generation","media generation","with","visual","collections","node","work","debug","graph","validate","assets","run","server","mcp server","workflow",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":121,"publishedAt":44},"01M6BY4AEB05ZPBRVD078ATR2H","wan-2-6-prompting","Prompt Alibaba's Wan 2.6 video — text-to-video with a global style line plus timing-bracketed shots, and image-to-video that describes only what changes over time. Covers the shot-mode switch per provider, the prompt budget, negative prompts, motion intensity wording, audio input and prompt expansion. Use whenever the model id names a Wan 2.6 video route (alibaba\u002Fwan-2.6\u002Ftext-to-video, alibaba\u002Fwan-2.6\u002Fimage-to-video, wan-video\u002Fwan-2.6-t2v, wan-video\u002Fwan-2.6-i2v, wan-video\u002Fwan2.6-i2v-flash) on generate_video, animate_image or a TextToVideo node. Not for Wan 2.5 or 2.7, or the Wan 2.6 image routes.","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fwan-2-6-prompting\u002FSKILL.md",[120],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[122,123,124,125,126,127,128,104,129,130,131,132,133,134,135,136,137,138,139,140,141],"prompting","wan 2 6 prompting","line","expansion","input","image-to-video","text-to-video","route","only","mode","time","flash","Budget","generate","text","image","animate","model","Audio","Video",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":150,"publishedAt":44},"01M6BY47T4748ZG5ZMTAR97ZWZ","video-workflow","Build a reusable NodeTool video workflow for batches or repeated inputs. For a single finished piece, use a storyboard skill.","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fvideo-workflow\u002FSKILL.md",[148,149],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":88,"categoryName":89,"taxonomyType":21,"taxonomyTypeDesc":22},[113,151,141,152,153,35,154,36,155,39,31],"video workflow","reusable","storyboard","batches","single",{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":163,"publishedAt":44},"01M6BY4587N2SYN315SXGEMZC3","video-clone","Analyze a reference video and recreate its shot structure with a new product or cast in NodeTool.","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fvideo-clone\u002FSKILL.md",[162],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[164,165,141,101,166,167,39,168,169,170,171],"clone","video clone","cast","new","analyze","product","structure","reference",{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":176,"categories":177,"keywords":179,"publishedAt":44},"01M6BY4257C2KQYYMD9EK6DK8E","video-audio-continuity","Keep sound continuous across a multi-scene piece cut from generated video — why one clip per scene hard-cuts the audio at every boundary, when to write all the scenes into a single generation instead, the sound-design vocabulary that survives a provider's copyright filter, and how to check the length, the aspect ratio and the mix of what came back. Use when a piece has more than one scene and the video model writes its own audio (Seedance 2, Veo 3, MiniMax H3, Kling 2.6 and later), or when a cut's sound drops out at the shot changes.","https:\u002F\u002Fgithub.com\u002Fnodetool-ai\u002Fnodetool\u002Fblob\u002Fmain\u002Fpackages\u002Fsystem-skills\u002Fvideo-audio-continuity\u002FSKILL.md",[178],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[180,141,140,181,182,183,184,185,186,187,188,189,190,27,191,192,139,193,194,195,196],"video audio continuity","continuity","write","why","back","veo 3","at","cut","later","across","filter","generated","how to","mix","design","boundary","how"]