Communitygithub.com

motion-composer

Video and animation skill. Designs the timing and motion layer of a PulseFrame plan — scene transitions, per-element entry motion, stagger and delay, and the overall pacing budget. Select when a plan validates but feels flat, when scenes collide or drag, or when a style pack's motion vocabulary must be applied to a storyboard.

motion-composer란 무엇인가요?

motion-composer is a Claude Code agent skill that video and animation skill. Designs the timing and motion layer of a PulseFrame plan — scene transitions, per-element entry motion, stagger and delay, and the overall pacing budget. Select when a plan validates but feels flat, when scenes collide or drag, or when a style pack's motion vocabulary must be applied to a storyboard.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/virtualnumber20211/PulseFrame/tree/HEAD/skills/motion-composer

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Motion composer

Motion is a reading aid. Every entrance, transition and stagger either helps the viewer parse the frame faster or gets in the way. This skill is about choosing which.

The timing model you are working inside

PulseFrame does not render scenes back to back with gaps. Each scene has a render window that begins leadIn frames before its declared startFrame and ends outFrames after its declared end. Windows overlap exactly across a transition, and the incoming scene is painted beneath the outgoing one so a slide or wipe reveals rather than flashes.

Consequences you must design around:

  • There is never a blank frame between scenes. If you want black, that is dip-to-color, chosen deliberately.
  • outFrames is derived from the transition type and the style's exitDurationFrames, clamped to one third of the scene's duration. A 40-frame scene cannot have a 30-frame transition out of it.
  • Because windows overlap, the outgoing scene's text is still visible for outFrames after its declared end. Do not put a hard cut on the next scene and expect the old text to vanish instantly — it will not, unless the transition is cut with zero duration.

Pacing

creative.pacing ∈ calm | measured | brisk | rapid. It is the single dial that expresses intent; the style pack's motion block supplies the actual numbers.

PacingEntry framesStaggerScene floorReads as
calm18–246–890 framesConsidered, documentary
measured12–16460 framesDefault, most explainers
brisk8–122–345 framesSocial-native
rapid6–81–236 framesMontage, high density

Mismatch is the most common motion defect: a calm pacing with rapid entry durations produces scenes that snap in and then sit still, which reads as broken rather than as calm.

Transitions

Pick from the style pack's motion.transitionVocabulary. If the transition you want is not in the list, either change the pack or pick a different transition — do not add to the vocabulary to solve one scene.

TransitionCostUse for
cut0 framesDefault. Continuation, no time change.
fade~14 framesChange of time, place or register.
slide~16 framesExtension; the next scene continues this one.
wipe~18 framesAdjacent comparison; A gives way to B.
dip-to-color~24 framesChapter break. Once per video, maximum.
zoom~14 framesEmphasis into a detail.

Rules:

  • Two consecutive non-cut transitions is the ceiling.
  • slide in the same direction twice in a row reads as a stuck carousel.
  • dip-to-color twice in a 30-second video is a slideshow, not a chapter structure.
  • Never use a transition to cover a bad cut. If two scenes do not flow, the storyboard is wrong; a wipe will not fix it.

Element motion

MOTION_PRESETS and what each is actually for:

  • fade — the safe default. Works on every background.
  • slide-up — content arriving from below; implies continuation or addition.
  • slide-left — content moving through; implies sequence.
  • scale-in — emphasis; the element claims the frame. Use on one element per scene.
  • reveal — a clip-path wipe. Good for a rule or an accent bar, wrong for a paragraph.
  • stagger — the container spreads its children by elementStaggerFrames. Only meaningful on a group.
  • none — deliberately present from frame 0. Correct for a persistent background or a scene where motion would distract from the voice.

delayFrames sequences elements. A working pattern: headline at 0, subheadline at elementStaggerFrames, accent rule at 2 × stagger, body at 3 × stagger. Total entry completes inside entryDurationFrames + 3 × stagger, which must be under ~25% of the scene duration or the viewer is watching an animation rather than reading.

Readability arithmetic

Before finalising a scene, check it can actually be read:

readable_frames ≈ 0.6 × characters_in_primary_text
available_frames = durationFrames − entryDurationFrames − stagger_total

If available_frames < readable_frames, either shorten the text or lengthen the scene. At 30fps a 60-character headline needs ~36 frames of hold. This is the calculation that separates a scene that feels rushed from one that feels right, and it is cheap to run.

Subtitles interact with motion

If creative.burnedInSubtitles is true, the renderer reserves vertical space for the caption track and shrinks the content box to match. That means:

  • Content placed in the bottom 20% of the frame is not where you put it — it is above the caption reserve.
  • A lower-third scene and a two-line caption stack. Check the result at a real frame; do not assume the layout holds.
  • Long captions with subtitles.maxLines: 3 reserve more space than maxLines: 2, and a three-line reserve can push a tall image out of frame.

Verifying motion without watching the video

Render stills at the frames that matter and look at them:

pulseframe render <project> --still --frame 0    -o out/f00.png
pulseframe render <project> --still --frame 60   -o out/f60.png
pulseframe render <project> --still --frame 140  -o out/f140.png

Choose frames at: a scene's first frame, the midpoint of a transition, and the last frame before a transition starts. A transition that looks fine in the middle can still leave the outgoing text half-visible on the incoming scene's background — that only shows at the boundary frames.

What not to do

  • Do not animate everything. Motion on every element at every scene change is noise; the eye stops tracking entrances and the video becomes exhausting.
  • Do not use scale-in on more than one element per scene.
  • Do not set delayFrames beyond a scene's entry budget; the element will appear mid-scene with no context.
  • Do not tune motion in the plan to compensate for a style pack you have not looked at. Read motion in the pack first.

관련 스킬