ZLHad/open-video-harness

OpenVideoHarness

Harness path (set by install.sh): ~/OpenVideoHarness

This skill is a thin pointer. All workflows, rules and tools live in the OpenVideoHarness repository.

1. Locate the harness

Use the first of these that exists and contains bin/vh:

1. $OVH_DIR
2. the path on the "Harness path" line above
3. ~/OpenVideoHarness
4. the current working directory

If none exists, ask the user for permission, then install it:

curl -fsSL https://raw.githubusercontent.com/ZLHad/OpenVideoHarness/main/install.sh | bash

2. Follow the harness, not this file

Read <harness>/CLAUDE.md (Codex: <harness>/AGENTS.md, which is identical) and follow it exactly:

• route the request to one of the 11 video-types/ docs (09, editing the user's own footage, and 11, a recap of the user's own photos, are experimental);
• create the project with <harness>/bin/vh new <type> <slug>;
• stop for the user where effort and director mode say (CLAUDE.md "effort level" and "director mode"): standard and studio stop at the three human review gates (concept and outline → storyboard → first draft); quick renders straight through. Anything the user said they want to decide themselves (hook, main character, theme music, title and cover …) adds a stop before anything downstream needs it, or rides on the next gate if it can wait. Each stop is by default one local review page from bin/vh review, at most three decisions; send the user only the lines it prints, then wait;
• follow the hard rules: every frame is a pure function of t; when there is sound, audio sets the timing; storyboard before code; self-review every scene; fact discipline;
• keep work inside <harness>/projects/; when the user names another directory, create the project there with <harness>/bin/vh new <type> <slug> --dir <that directory> (or set OVH_PROJECTS).

Audio tools:

• bin/vh tts — voiceover, Chinese or English, local Qwen3-TTS by default;
• bin/vh captions — zh/en/bilingual subtitles;
• bin/vh music — code-composed soundtrack;
• bin/vh sfx — sound effects;
• bin/vh mix and bin/vh mux — mixing and muxing.

Run bin/vh doctor if anything looks missing.