Communitygithub.com

motion-qa

Check a papercut reel's stills against the style DNA and the storyboard. Renders contact sheets at a few timestamps, runs the full checklist, then writes the delivery summary. Use for "QA the reel", "check my scenes look like paper", "is this ready to post".

What is motion-qa?

motion-qa is a Claude Code agent skill that check a papercut reel's stills against the style DNA and the storyboard. Renders contact sheets at a few timestamps, runs the full checklist, then writes the delivery summary. Use for "QA the reel", "check my scenes look like paper", "is this ready to post".

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

Ask in your favorite AI

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

Documentation

Papercut QA

Compare stills for style, not content, against the Style DNA and the storyboard. Run it per scene while building and once on the whole reel before the final render.

Preflight

  • Install: Standard or Full. Stills need a scaffolded project with Remotion, and the contact sheets need Python with numpy and Pillow ($MOTION_PY). Missing pieces: ./install.sh --doctor, then motion-setup.
  • A kyfram project needs no Remotion: invoke the kyfram skill before inspecting or fixing Kyfram scene output. qa.sh lifts its stills out of the cached per-scene segments (core/tools/kyfram_qa.py), so render once with core/tools/render.sh before QA. Everything below applies unchanged.
  • Library: $MOTION_LIB, else the MOTION_LIB= line in ~/.config/motion-explainer/config.env, else ask once.
  • Read first: Style DNA in $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md section 2, and the backdrop sheet style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Each image costs about 0.7-1.5k tokens, so open only what the step needs.
  • For density, $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md ("Pacing stats" at the end): scenes average 2.8 s, 2-4 discrete visual events per scene, one every 0.4-0.8 s on a stressed word, a new caption page about every 0.6 s. Copy the density, not the content.

1. Render stills

From the project's video/ folder:

$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • Use 4-6 timestamps per check. For a scene, NTH is about its length in frames divided by 4. Leave FROM-TO out for the whole reel and raise NTH.
  • The output is out/qa/NAME_0.jpg (and _1, _2 for longer ranges), at most 45 frames per sheet. Read the sheet; keep sheets small.
  • One QA command per scene, and never two renders at once. Keep fixes to two rounds per scene.
  • Check against the storyboard: the scene's frame 0, its key events on their words, nothing clipped, nothing covering the banner or caption bands.

2. Checklist

  • Every object reads as paper: grain, rough edge, drop shadow, stacked-piece shading, no outlines or gradients.
  • The world camera moves smoothly. Only the banner and labels boil (stepped, subtle).
  • The banner is fixed in position and taped, 3-7 words, one fact each, never repeats the VO. The banners alone read as a fact sheet.
  • Every set illustrates a concrete word in its VO line, numbers are physical props, and there is one callback set before the CTA.
  • Every number and UI label traces to the facts list. The script has at least one honest limitation and a feature stack of exactly three.
  • Captions: one tag per word, tilted, popping on onset, pages of 1-3, in the 68-80% band, never on a face.
  • Saturation only on characters, captions and signals.
  • A visual event on every stressed word, with ambient motion always running.
  • Cuts on banner changes (sets 1.5-3 s in tours and news, up to 5 s in a metaphor beat), bottom 20% clear.
  • The HOOK block (SAY / WRITE / SHOW / ALIGN) is on screen exactly as written: frame 0 shows the SHOW moment mid-action with the WRITE title on it, and the first VO line is SAY.
  • Every scene has a camera move, at most one page turn or tear, a tape pull or whip into the CTA, and every transition has its SFX.
  • Humour pass visible on screen: one format throughout, a costume prop per idea, one struggling beat, the frame-0 prop returns changed in the CTA set, and every gag reads in under 1 s and never covers the banner, the captions or the key number.
  • Vocabulary in the VO and banners matches the audience level in SERIES.md.
  • Voiceover, captions and events are in sync (scrub the Studio at every cut).

For a failed item, fix the scene file (or the kit in the library, never src/lib/ in the project) and re-run the one scene. Rebuild a scene with motion-build.

3. Deliver

Open the Studio preview, list the scenes with timings, and say what is placeholder: voice, music, SFX, assets. If the voice is a placeholder, say how to re-voice it (motion-voice). After posting, the numbers go to motion-strategy for the autopsy.

Principles pass

Scrub one scene at 5 fps and check against $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: anticipation before each big move (2), everything eased (6), something trailing after impacts (5), one focal prop (3), one exaggerated beat (10), stacked shading and a consistent shadow (11).

Hand-off

Fixes go back to motion-build (scene or sound) or motion-voice (sync). A clean pass ends the reel: render with $MOTION_LIB/core/tools/render.sh when the user asks.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

Related Skills