motion
/motion
Makes motion graphics with Apple Motion on a Mac without opening the app - edits Motion's XML project files (.motn, .moti; the ozml format) by parameter name, renders them in the background through Compressor's command line to ProRes 4444 with alpha, and composites the premultiplied alpha exactly in numpy. Use for particle effects (dust motes, impact puffs, sparkles, confetti, snow, bubbles, light rays), animated titles, lower thirds and name cards, end cards, transitions, restyling any of Final Cut Pro's stock title templates, turning a Motion library object into a renderable project, or refe
- Author
- Avant-Concepts-LLC ↗
- Repository
- claude-skills ↗
- Licence
- MIT
- Last repository change
- 11.11.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/graft.py, scripts/motion_kit.py
What it does and when to use it
Makes motion graphics with Apple Motion on a Mac without opening the app - edits Motion's XML project files (.motn, .moti; the ozml format) by parameter name, renders them in the background through Compressor's command line to ProRes 4444 with alpha, and composites the premultiplied alpha exactly in numpy. Use for particle effects (dust motes, impact puffs, sparkles, confetti, snow, bubbles, light rays), animated titles, lower thirds and name cards, end cards, transitions, restyling any of Final Cut Pro's stock title templates, turning a Motion library object into a renderable project, or refe
Original author description
Makes motion graphics with Apple Motion on a Mac without opening the app - edits Motion's XML project files (.motn, .moti; the ozml format) by parameter name, renders them in the background through Compressor's command line to ProRes 4444 with alpha, and composites the premultiplied alpha exactly in numpy. Use for particle effects (dust motes, impact puffs, sparkles, confetti, snow, bubbles, light rays), animated titles, lower thirds and name cards, end cards, transitions, restyling any of Final Cut Pro's stock title templates, turning a Motion library object into a renderable project, or refe
How it works
- Setup
- Read before working
- Tools (scripts/)
- Worked example: restyle a stock title
- Rules that bite
- Final Cut
- Not verified yet
SKILL.md preview
---
name: motion
description: Makes motion graphics with Apple Motion on a Mac without opening the app - edits Motion's XML project files (.motn, .moti; the ozml format) by parameter name, renders them in the background through Compressor's command line to ProRes 4444 with alpha, and composites the premultiplied alpha exactly in numpy. Use for particle effects (dust motes, impact puffs, sparkles, confetti, snow, bubbles, light rays), animated titles, lower thirds and name cards, end cards, transitions, restyling any of Final Cut Pro's stock title templates, turning a Motion library object into a renderable project, or referencing a Motion title from FCPXML. Holds the measured file format (enum tables, parameter ids and flags), an inventory of the stock content to start from, a craft rulebook drawn from 29 tutorials, and the motion_kit.py and graft.py helpers. Pairs with the compressor skill.
compatibility: Claude Code on macOS only, with Apple Motion and Compressor installed (Creator Studio or Mac App Store editions; Final Cut Pro optional, for its stock titles). Needs python3 3.9+, ffmpeg and ffprobe; numpy and Pillow for compositing. Does not work when uploaded to claude.ai.
---
# Motion, driven from Claude Code (never opened)
Motion has **no scripting** (`NSAppleScriptEnabled` is 0). But every project file is plain XML, and **Compressor's command line renders a project in the background**: Motion never launches and nothing takes the front window. So the loop is:
**start from a stock project → change values by parameter name → render (ProRes 4444, alpha) → composite in numpy → look at frames.**
Measured in October 2026 on the Creator Studio editions (Motion 6.4, Compressor 5.4, Final Cut Pro 12.4) on Apple silicon. A production run of the loop (a dust-in-a-sunbeam particle overlay plus a title card) took about 50 s end to end; a 4 s title renders in about 15 s, Compressor's start-up included.
Where it pays: particle emitters, replicators, physics behaviors (bounce, gravity, wriggle), 3D camera moves, and branded titles, lower thirds and end cards that a script fills in identically every time. Where it doesn't: authoring a complex scene from scratch in XML (start from a template and change values), or full character animation.
## Setup
Paths below are relative to this skill's folder, `${CLAUDE_SKILL_DIR}`. On a new Mac, run first:
```sh
python3 "${CLAUDE_SKILL_DIR}/scripts/motion_kit.py" paths
```
It prints where it found Motion, Motion's library, Final Cut Pro and its templates, Compressor, ffmpeg, ffprobe, numpy and Pillow, and which environment variable to set for anything it could not find.
- **Editions.** The Creator Studio editions install as `/Applications/Motion Creator Studio.app` (`com.apple.motionappApp`), `Compressor Creator Studio.app` (`com.apple.CompressorApp`) and `Final Cut Pro Creator Studio.app` (`com.apple.FinalCutApp`). The Mac App Store editions install as `Motion.app` (`com.apple.motionapp`), `Compressor.app` (`com.apple.Compressor`) and `Final Cut Pro.app` (`com.apple.FinalCut`). The scripts look for the Creator Studio edition first, then the Mac App Store one, then ask Spotlight by bundle id; `MOTION_APP`, `FINAL_CUT_APP` and `COMPRESSOR_APP` override. Everything here was measured on Creator Studio: on a Mac App Store edition, check `paths` and the first render's frames before trusting a recipe.
- **Final Cut Pro is optional.** The ~600 stock titles, and the stock effects, transitions and generators, ship inside Final Cut, not Motion. Without it, start from Motion's own library (emitters, replicators, behaviors, shapes) or from a project saved in Motion.
- `numpy` and `Pillow` are needed only for compositing and frame checks (`python3 -m pip install numpy pillow`). ffmpeg and ffprobe come from Homebrew or any static build.
## Read before working
| File | What it holds | When |
|---|---|---|
| `references/ozml.md` | The file format: skeleton, units, channel paths, **enum tables** (emitter shape, arrangement, Sequence Text…), the id/flags table for inserting parameters a preset leaves out, published parameters, text styles, **how FCPXML references a Motion title** | Before editing any file |
| `references/library.md` | Stock content picked by use (poofs, sparkles, confetti, snow, titles, lower thirds, end cards, transitions…), with paths and which items render as they stand | Before choosing a starting point |
| `references/motion-technique.md` | The craft rulebook from 29 tutorials: particles, behaviors, overshoot, text animation, replicators, titles, timing; rules for young children's content marked **[Kids]** | Before designing an effect |
## Tools (`scripts/`)
- **`motion_kit.py`**: `load` / `save` / `P` (a parameter by its name path) / `setv` / `param` (insert a missing parameter) / `node` / `set_scene` / `set_text` / `params` (list every value in a preset: the way to learn one) / `published` (a template's published parameters with their FCPXML keys) / `render` (Compressor, with resubmit) / `composite` / `over` / `frame`.
Shell: `motion_kit.py paths`, `motion_kit.py params FILE [filter]`, `motion_kit.py published FILE`, `motion_kit.py render IN.motn OUT.mov SECS [--no-recover]`.
- **`graft.py`**: turns a library object (`.molo`, ~1,440 of them) into a renderable project by grafting it into a stock skeleton. `graft.py "<object>.molo" out.motn [WxH] [fps] [secs]`.
## Worked example: restyle a stock title
Pop-up is Final Cut's stock title whose letters pop in one by one. These calls were tested end to end, from `load` through `render`:
```python
import sys
from pathlib import Path
sys.path.insert(0, "${CLAUDE_SKILL_DIR}/scripts")
import motion_kit as mk
work = Path("motion-work"); work.mkdir(exist_ok=True) # a folder on the internal disk
root = mk.load(mk.FCP_TITLES + "/Simple.localized/Pop-up.localized/Pop-up.moti") # read only; saved elsewhere
mk.set_scene(root, fps=24, secs=4) # renders as 23.976 fps: the title is NTSC-flagged
mk.set_text(mk.node(root, "Type Text Here"), "Your Title Here", font="AvenirNext-Bold", size=150)
mk.save(root, work / "title.motn")
mk.render(work / "title.motn", work / "title.mov", secs=4) # ProRes 4444, yuva444p12le, 96 frames, ~15 s
mk.composite(work / "title.mp4", (240, 236, 228), [(work / "title.mov", 0.0)], secs=4)
```
Then check a frame (`mk.frame(work / "title.mov", 2.0)` composited with `mk.over`, saved as a PNG) before handing anything over. For an emitter, learn the preset first (`motion_kit.py params "<preset>.mopr" "Birth Rate"`), resize it (`ozml.md` §10), then change values by name.
## Rules that bite
- **Never open Motion or Final Cut to check work.** Render, then look at frames (`motion_kit.frame`) over the real background.
- **Premultiplied alpha:** composite with `out = layer + below × (1 − alpha)` (`motion_kit.over`). **ffmpeg's overlay filter gets it wrong** (gray rims on light backgrounds, even with `alpha=premultiplied`).
- **Compressor jobs: watch the file, not Compressor.** Polling Compressor's status every second or two kills the job, and a submit made while its helpers shut down (~10–15 s after the queue empties) comes back with no batch ID. `render` checks for the batch ID, waits for the helpers, and resubmits. The queue is shared with every other process on the account. More in the compressor skill (`${CLAUDE_SKILL_DIR}/../compressor/SKILL.md` when both are installed).
- **`render` recovers a stuck batch by restarting Compressor's transcoder**, which also stops any other Compressor job on this account. Pass `recover=False` (shell: `--no-recover`) while something else is encoding.
- **Render on the internal disk.** In testing, Compressor could not read or write on an external drive: the job sat at 0 % with no file and blocked every later job. Build the project and render in a folder on the internal disk, then move the movie. `render` prints a warning when a path is on another volume.
- **Never edit the stock files in place.** `load` from the app bundle, `save` to your own folder.
- **Long titles can hang the transcoder.** A Pop-up title at 29.97 fps / 8.2 s hung it where 24 fps / 4 s renders: render the short version and hold a frame in the composite. A Dust 01 emitter at 13 s failed where 10 s rendered. Pop-up builds in by 1.5 s, holds from 1.5 to 2.5 s and exits from 2.6 to 3.5 s.
- **`fps` is nominal.** Final Cut's titles carry `<NTSC>1</NTSC>`, so `set_scene(fps=24)` renders at 24000/1001 (measured: 96 frames, 4.004 s). `set_scene(..., ntsc=False)` writes 0 for an exact rate (not rendered yet).
- **Shrapnel Explosion is not confetti.** Grafted and scaled, it draws an orange fireball of squares. Build confetti from the recipe in `motion-technique.md` §2, or draw it in code.
- **Parameters left at their default are missing from the file.** Insert them (`param`, ids and flags in `ozml.md` §5). Example: the emitter `Shape` (id 302). A line emitter's `Start Point` / `End Point` may hold only `X`: append a `Y` (id 2, flags 8589934608).
- **The menu order is not the stored number.** Emitter Shape: 0 point, 1 line, 2 circle, 4 geometry, 5 image, 6 rectangle, 7 burst, 8 spiral, 9 wave, 10 sphere, 11 box. Arrangement: 0 outline, 1 tile fill, 2 random fill. All measured by render.
- **Stock presets hide their look in gradients:** `Dust 01` peaks at 5 % opacity in its color-over-life gradient.
- **A `.molo` alone renders empty frames.** Graft it (`graft.py`). Never mix ozml generations in one file: v5+ is timed in 7680ths of a second, older files in frames.
- **Title text lays out in a paragraph box.** Move it with the margins (pixels, 1:1, y = 0 is the frame's center), not with `Position`.
- **Fonts are named by PostScript name** (`AvenirNext-Bold`). A system font and fonts installed in `~/Library/Fonts` both rendered. Look at a frame whenever you use a new one.
- **Emitters start empty.** Render a few seconds extra and skip them in the composite.
- **Coordinates are pixels from the frame's center, y up.** Vertical 1080×1920 renders correctly (measured).
- **H.264 or plain HEVC output flattens transparency onto black.** Keep ProRes 4444 for overlays; give a delivery-ready card its own background.
- **Content for young children:** skip the flashing presets `library.md` lists, and recolor stock presets (many are pure red, blue or neon) to the show's palette.
## Final Cut
Final Cut titles (`.moti`) render through Compressor like any project, and hundreds ship inside Final Cut (paths in `library.md`). To use one *in* a Final Cut timeline instead, FCPXML declares `<effect uid=".../Titles.localized/...">` and sets published parameters with keys `9999/<layer ids>/<channel path>` (`ozml.md` §8; `motion_kit.py published FILE` prints the keys for any template). **That round trip is not verified yet.** The first time, import a one-title FCPXML into Final Cut and check that the values arrived.
## Not verified yet
The FCPXML title round trip; Build In/Out marker meanings; most behavior menus' stored order beyond Sequence Text and Oscillate; movie-sprite emitters (Cartoon Smoke rendered as dots); `.moef`/`.motr` with empty drop zones; motion blur; `ntsc=False`; the Mac App Store editions. Details at the end of each reference.
Files in this package (7)
- LICENSE 1 KB
- SKILL.md 11 KB
- references/library.md 26 KB
- references/motion-technique.md 44 KB
- references/ozml.md 29 KB
- scripts/graft.py 6 KB
- scripts/motion_kit.py 19 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · Avant-Concepts-LLC/claude-skills | 100 | MIT |
| AtlasScope/agent-kit | 100 | MIT |
| reuvenkazorer27/pbi-html-content-agent | 100 | MIT |
| nextwork-projects/ai-video-editor-cooked | 100 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
| molveau/skills | 100 | MIT |
| muzimu217/ui-design-agent-kit | 100 | Apache-2.0 |
| icons8/agent-skills | 100 | Apache-2.0 |
| TSrain/ai-cut-studio | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version cb7b2d492360 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100compressor
Encodes and delivers video with Apple Compressor's command line on a Mac, in the background, without opening the app - YouTube uploads, vertical Shorts, Reels, TikTok and Pinterest files, HEVC, ProRes masters, Motion projects and titles rendered to alpha overlays, image… - 100motion-designer
The studio's Motion Designer. Owns stage 4 (motion graphics) for the studio-director, taking a Motion Brief and delivering a finished motion package (look, storyboard, animated titles, lower thirds, kinetic text, transitions, renders with alpha) plus a handoff report back to the… - 100altocue-motion
Adds motion graphics to a video from a JSON file: hook, chips, lower thirds, stats, quotes, steps, title cards and end cards, timed to spoken words and styled from a brand file. Use when the user asks for titles, graphics, lower thirds, a hook, an end card or branded overlays. Part of Altocue. - 100reframe
Create and iterate motion-graphics videos (mp4) — title cards, lower thirds, kinetic typography, product teasers, data-driven video batches. Use when the user asks to make, edit, retime, personalize, or add sound to an animated video. Scenes are declarative data; renders are… - 100lower-thirds
Make animated lower thirds and other broadcast overlays (name straps, corner bugs, subscribe reminders, scripture or song titles) as transparent video files, drawn frame by frame in JavaScript on a canvas and rendered to WebM with alpha for OBS and browsers, or ProRes 4444 for… - 95reelcraft
Add effects, stickers, motion graphics, captions, colour grades, sound effects and ready-made style templates to a video (punch-ins, kinetic titles, stat cards, lower thirds, chat bubbles, notifications, liquid-glass lens, confetti, glitch, VHS, halftone, polaroid frame and…