apple-motion

Automates Apple Motion project inspection, text editing, and Compressor rendering through native XML tools.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill apple-motion-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-motion
Source: https://github.com/kkkaoru/dotfiles/tree/main/.agents/skills-stroage/apple-motion
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill apple-motion-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing Apple Motion projects and rendering them normally requires repetitive GUI clicking, and undocumented project XML makes scripted edits risky. This Skill replaces manual Motion UI work with verified native file operations: inspecting ozml project XML, copying text layers with hash-checked edits, patching parameters, and rendering projects through the official Compressor CLI. ## Core Features & Use Cases - Native XML inspection and editing: Inspect Motion project files (.motn, .moti, .motr, .moef, .mogen) via interchange_inspect/interchange_query, and perform hash-verified text copy edits with motion_text_inspect and motion_text_copy without touching the GUI. - Compressor CLI rendering: Submit Motion projects to Compressor with trusted presets and verify actual output duration, frame count, decoded animation, Japanese text, and audio instead of assuming submission equals completion. - Bounded GUI fallback: When native adapters cannot cover rigs, particles, plugins, or template publishing, follow an explicit, documented Peekaboo UI fallback only after explaining the exact capability gap. - Use Case: Update the lower-third text in a known-good Snap template, write it to a new file with explicit authorization, then render it to H.264 via compressor_submit and verify the decoded frames before delivery. ## Quick Start Ask the agent to inspect a Motion project file, replace the title text in a specific layer, and render the result to MP4 using the Compressor CLI.

Frequently Asked Questions about apple-motion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit text in a Motion project without opening the GUI?

Use motion_text_inspect to get the source SHA-256, layer IDs, and current text, then motion_text_copy with that hash, explicit expected and replacement text per layer, a new output path, and allowUndocumentedFormat enabled. It updates character objects, kerning IDs, and style-run lengths together.

How to render a Motion project to video from the command line?

Submit the .motn file through compressor_submit with a trusted preset, filesystem source path, unique output directory, and the returned job ID. Then verify actual output duration, frame count, decoded animation at multiple times, and audio, since submission is not completion.

What Motion file formats does native XML editing support?

The workflow supports .motn, .moti, .motr, .moef, and .mogen documents with an ozml root. Text copy editing is limited to observed ozml 4.0, single-style, neutral-kerning, single-line BMP text up to 120 units.

Can Motion projects be rendered with alpha transparency through Compressor?

A first ap4h.setting alpha attempt failed with a className is null error, so alpha output is not verified. Any corrected preset must be tested independently before promising alpha exports, and opaque versus alpha outputs must be distinguished.

When is GUI automation still needed for Motion tasks?

GUI fallback is needed for capabilities with no established native API, such as unknown factories, rigs, tracking, particles, plugins, and template publishing. The exact gap must be explained first, and repetitive GUI work should not resume while native adapter development remains actionable.