Communitygithub.com

motion-render

Render, deliver and re-brand mg shots — presets, output versions, mg deliver (verify + freeze + copy finals), and mg rebrand for applying brand changes to delivered projects.

What is motion-render?

motion-render is a Claude Code agent skill that render, deliver and re-brand mg shots — presets, output versions, mg deliver (verify + freeze + copy finals), and mg rebrand for applying brand changes to delivered projects.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ryodeushii/motion-graphics/tree/HEAD/skills/motion-render

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Rendering and delivery

Run pnpm mg check <client>/<project> first; render only when it reports no issues.

Render

pnpm mg render <client>/<project>            all shots
pnpm mg render <client>/<project> lt-ceo     one shot
pnpm mg render <client>/<project> --force    re-render even if unchanged

Output: renders/<shot>_v<NNN>.<ext>. Each render that changes pixels gets the next version; older versions stay. renders/manifest.json records the hash of everything that affects pixels (props, resolved tokens, font/logo/asset contents, preset, toolkit version, client template code). Unchanged shots are skipped.

Presets

PresetFileUse
overlay (default)ProRes 4444 .mov with alphaLower thirds, titles over footage in Resolve/Premiere/FCP
deliveryH.264 .mp4, transparent areas blackReview links, full-frame graphics
webm-alphaVP9 .webm with alphaWeb players; most editors ignore WebM alpha

Set per shot ("preset"), per project (project.json), or per run (--preset).

Deliver

When the user hands a project over (or says the graphics are final):

pnpm mg deliver <client>/<project> [shot…]

It renders what changed, verifies every file (alpha for overlay/webm-alpha, frame size, fps), freezes the project, and copies the finals to deliver/<YYYY-MM-DD>/<shot>.<ext>. If verification fails, nothing is frozen or copied; fix the reported problem and run it again. Tell the user the deliver/ folder path.

Frozen means: later house, client or variant edits do not change this project's renders.

Apply brand changes

After the user changes client or variant tokens (new colors, fonts, logos):

  1. Preview: pnpm mg rebrand <client> (or <client>/<project> for one project). It changes nothing and lists, per project, what the current brand would change. Projects with "extends": "none" are skipped.
  2. Show the list to the user and ask which to update: all of them, some projects, or none (new work only).
  3. Apply what they chose: pnpm mg rebrand <client> --apply or pnpm mg rebrand <client>/<project> --apply per project. Frozen projects are re-locked to the current brand; every listed project re-renders into a new version. Old versions stay in renders/.
  4. Run motion-qa on the new renders. For projects the user hands over again, run pnpm mg deliver to refresh deliver/.

Not running rebrand is also a valid answer: frozen projects keep their delivered look, and only unfrozen projects follow the brand on their next render.

Other brand commands:

  • pnpm mg diff <client>/<project>: one project's differences from its lock (frozen) or last render (unfrozen).
  • A render of an unfrozen project whose brand changed since its last render prints a warning with the changes.
  • Project-only token edits on a frozen project: edit tokens.json, then pnpm mg rebrand <client>/<project> --apply.

Failures

  • Errors that name a prop, token, font or text width come from validation; fix the JSON, not the template. pnpm mg check lists them all at once.
  • Browser launch, missing libraries, codec or path errors: pnpm mg doctor.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Related Skills