Skip to content

Getting Started

m4bwav edited this page Nov 1, 2026 · 1 revision

Install

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.

What it needs

  • Python 3.9 or newer. cine.py uses only the standard library.
  • ffmpeg and ffprobe for the qc and voice commands, which read clips you already have.
  • Optional: a local Ollama vision model for qc judge.

First steps

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.

Clone this wiki locally