Repository navigation
Getting Started
Install the core plugin first: the craft skills compile through cinewright-genvideo's model cards.
| 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 |
The three install routes for Claude Code, Copilot CLI and gh skill were proved on Windows 11. Installing copies skill folders; nothing runs until a skill is used.
- Python 3.9 or newer.
cine.pyuses only the standard library. - ffmpeg and ffprobe for the
qcandvoicecommands, which read clips you already have. - Optional: a local Ollama vision model for
qc judge.
Ask the agent for a film the way you would brief a crew ("a 15-second scene: an old woman hands a boy her last match"). The cinewright skill routes the request: script, shot list, bibles, continuity check, then a compiled prompt per shot for the model you name.
To see each step on disk, clone the repository and run the worked example from its root:
python scripts/cine.py cards list examples/three-shot| # | Slate | Size | Angle | Az | Move | Lens | Cast | Action | s |
|---|---|---|---|---|---|---|---|---|---|
| 1 | 1A | WS | eye-level | 90 | static | 24 | Maren, Tomas | Maren thumbs the tin matchbox open with a click and pinches out a single match, holding it still between finger and thumb. | 6 |
| 2 | 1B | MCU | eye-level | 45 | dolly-in | 50 | Maren | Maren slowly stretches her arm out toward Tomas, off screen, the match steady in her fingers. | 4 |
| 3 | 1C | MCU | eye-level | 135 | static | 50 | Tomas | Tomas takes the match from a hand entering frame left and closes his fist tight around it, pulling it to his chest. | 4 |
shot list: 3 shots, 1 scene(s), 14s
Inside an installed skill, run that skill's own scripts/cine.py instead of the repository's. Next: The pipeline.
This wiki describes cinewright 0.3.0 and was last updated on 2026-11-05. The plugin is MIT licensed. Report problems in the issues.
Using it
The releases
Contributing
Elsewhere