Video Explainer

Video Explainer

Version note: v0.3.0-rc.1 / 2026-07-22 / Add the first guarded brief-to-video workflow with script-bound review receipts, a no-key demo path, and local verification. Keep upload, account access, credentials, private voice assets, and hosted rendering out of scope. Rollback: remove this skill and continue using the legacy scripts directly.

Produce a local video and evidence packet. Never upload or publish from this skill.

Install

This Skill orchestrates a local clone of claude-video-kit; it does not bundle the renderer. From the repository root, install the runtime and register the Skill with:

npm ci --prefix remotion
npx skills add runesleo/claude-video-kit --skill video-explainer

For repository development, run commands from the repository root.

Workflow

1. Run the read-only doctor before changing a project:

``bash node scripts/video-explainer.mjs doctor --output ``

Read [setup-and-doctor.md](references/setup-and-doctor.md) when doctor blocks or the environment is new.

1. Convert the brief into script.json. Keep claims traceable, use supported slide types, and target 9:16. Read [brief-to-script.md](references/brief-to-script.md) for the input/output contract.

1. Require an independent review. Write review-input.json, then run:

``bash node scripts/video-explainer.mjs review --input /review-input.json ``

Read [review-gate.md](references/review-gate.md) for the six required checks. If any check is fix or block, revise and review again. Never render from that receipt.

1. Render only after a current pass receipt:

``bash node scripts/video-explainer.mjs render ``

On macOS, use --demo-quality only for a credential-free first success. It forces the built-in say voice and script-timed captions; label the result as demo-quality. Read [render-and-verify.md](references/render-and-verify.md) before running a custom project.

1. Verify the MP4 locally and report the video path, review receipt, verification result, elapsed time, and known limitations. Do not claim publication quality from the fallback voice.

Canonical first success

Run the repository-owned neutral demo:

node scripts/video-explainer.mjs demo --output /tmp/video-explainer-first-success

The demo must create a current pass receipt before TTS, render locally without an API key on supported macOS, and run the shorts verifier. It must not read an account, upload media, or send the brief to a remote service.

Stop conditions

• Stop before TTS/render when review is missing, stale, fix, or block.
• Stop when doctor reports a required runtime missing; give its exact action.
• Stop before any upload, public post, deploy, paid API call, credential setup, or account action and return that boundary to the user.
• Read [errors-and-privacy.md](references/errors-and-privacy.md) for recovery and data-handling rules.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: runesleo
• Source: runesleo/claude-video-kit
• License: MIT
• Homepage: https://github.com/runesleo/claude-video-kit/releases/tag/v0.3.0-rc.1

Install and usage instructions live in the source repository linked above.