Film craft for AI video. cinewright makes an agent plan a film like a crew and check it like a script supervisor, so separately generated shots keep the same people, wardrobe, props, eyelines, screen direction and light. Each shot is a generator-neutral shot card; a compiler turns a card plus the project's bibles into a given model's prompt.
Status: 0.5.4. Install routes proved on Windows 11: Claude Code, GitHub Copilot CLI and gh skill.
| Plugin | Skills | For |
|---|---|---|
cinewright |
cinewright (director and router), cinewright-shots (shot list and coverage), cinewright-continuity (script supervisor), cinewright-genvideo (prompt compiler for nine models), cinewright-qc (take review with ffmpeg), cinewright-analyze (take an existing video apart into notation, measure its sets, rebuild; AI-made video tells) |
everyone |
cinewright-craft |
cinewright-script (logline, beats, dialogue), cinewright-design (turnarounds, props, costume, color), cinewright-sets (set plans, wall strings, plates), cinewright-movement (weight, fights, battles, hard subjects), cinewright-camera (lens, light, format), cinewright-history (style cards), cinewright-edit (cutting, pacing), cinewright-finish (grade, crop, VFX, delivery), cinewright-sound (layers, mix, loudness), cinewright-voice (character voices that match shot to shot) |
deeper craft |
cinewright-dev |
cinewright-curate (add, verify and retire knowledge-base entries; refresh model cards; works in a clone of this repository) |
maintainers |
The wiki has the pipeline step by step, every cine.py command with real output, the video models and an FAQ.
A worked example lives in examples/three-shot/: a one-line idea taken through brief, script, shot list, bibles, design notes, a continuity diff that catches a planted error, and compiled Veo and MiniMax H3 prompts.
| Host | How |
|---|---|
| Claude Code | /plugin marketplace add m4bwav/cinewright, then /plugin install cinewright@cinewright (and cinewright-craft@cinewright for the craft skills) |
| GitHub Copilot CLI | copilot plugin marketplace add m4bwav/cinewright, then copilot plugin install cinewright@cinewright |
| Any agent with the GitHub CLI | gh skill install m4bwav/cinewright cinewright-continuity --agent claude-code (plain skill names; --agent picks the host folder) |
| claude.ai | Customize > Skills > Upload skill, one ZIP per skill from the release assets |
Install the core plugin first: the craft skills compile through cinewright-genvideo's model cards. Installing copies the skill folders; nothing runs until a skill is used.
Each skill ships scripts/cine.py (Python 3.9+, standard library only). It reads and writes JSON and Markdown in your project folder. It makes no network calls and never renders: writing a prompt never starts a paid render. The qc commands call ffmpeg and ffprobe on clips you already have.
python -m unittest discover -s tests # tests
python scripts/cine.py kb lint # schemas, links, copies, manifests
python scripts/cine.py budget # size budgets (green, yellow, red)
python scripts/cine.py build # copy shared/ into skills, rebuild indexes
python scripts/cine.py zip cinewright-continuity # claude.ai upload ZIP in dist/
python scripts/cine.py kb due # entries past their re-check interval (cinewright-curate)
python scripts/cine.py scrub --names FILE # private details in tracked files, before going public
Edit shared vocabulary, schemas and the library in shared/, never the copies inside skills; build copies them and kb lint fails on drift. The plan is ai-docs/plans/PLAN.md.
Each partner is optional. cinewright works alone, and the plugins share files, not code.
- voicewright:
cinewright-voicehands it the cast, and each character keeps one voice from shot to shot, read from a sharedvoices.json. - sfxwright: the shot list becomes a sound list, and cinewright reads
sounds.jsonback at the edit, so effects are planned per shot. - musicwright:
musicwright-scorefits a score to the cut, landing hits on beats and ducking under dialogue. Sound design and dialogue stay here. - polywright: 3D blockouts, crowd and army passes, and MP4 encodes at an exact frame count for previs and battle shots. Shot planning stays here.
- askwright: take picks and route choices go on a review page instead of into chat.
- grindwright: on a long film it keeps the video and edit lanes moving between other jobs.
- readwright: when a film adapts a book, it finds the scene's passages without loading the whole book.
- tokenwright: film sessions are long and full of reads, and tokenwright shows where the tokens went and how to cut them.
- fractalwright: fractalwright renders fractal zooms and stills; cinewright encodes, cuts and delivers them as finished video.
More on the wiki's Works with page.
Ideas (not text) from MIT-licensed skill repositories, including DirectorSKILL: response-size ceilings, the repair cost ladder, one owning reference per dimension, continuing from the previous take's observed end state, one change per reroll. Film craft from Arijon, Block, Bordwell and Thompson, Brown, Cousins, Field, Katz, Landis, LoBrutto, Mascelli, McKee, Miller, Murch, Riley, Rowlands, Snyder, Thomas and Johnston, and Weston, cited in each entry.
Banner image generated locally with Z-Image Turbo in ComfyUI, seed 18210612; prompt and workflow in assets/banner-workflow.api.json. The social preview, assets/social-preview.jpg, is the same image cropped to 1280 by 640 with the title added.
MIT, see LICENSE.
