Communitygithub.com

Gavin152/promo-clip

Render a promo-clip video to MP4 in every chosen format and size, and QA the results.

What is promo-clip?

promo-clip is a Claude Code agent skill that render a promo-clip video to MP4 in every chosen format and size, and QA the results.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gavin152/promo-clip/tree/HEAD/skills/export

Ask in your favorite AI

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

Documentation

/promo-clip:export

Read ${CLAUDE_PLUGIN_ROOT}/skills/promo-clip/protocol.md first, and ${CLAUDE_PLUGIN_ROOT}/skills/promo-craft/qa.md (what QA checks and how to fix each failure). stage export start.

  1. export --all — master + web MP4 for every format × size in promo.json output, at its fps (one build). Rendering takes roughly 1–2 s of wall time per second of film at 1080p per format; 4K about four times that. Run it in the background for long jobs and report progress.
  2. qa → out/qa_report.md + .json: duration, size, fps, audio/video length, loudness (−14 LUFS, ≤ −1 dBTP), QR decode on the end card, layout in every format. Exit 2 lists the issues; fix them in the stage they belong to (see qa.md), re-export only what changed (export --format F --size S), re-run qa.

Done when qa passes.

Gate: the file list in out/ (sizes, durations), the QA summary, and a suggestion to watch the web version of the primary format first. Gate per the protocol — this is the final cut; a change request names the stage to revisit (e.g. "the music is too loud" → music mix; "scene 3 too busy" → scenes). Then stage export done.

Individual skills in this repo

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

Related Skills