← ClaudeAtlas

birchlisted

Cut a talking-head video into a finished reel on this Mac with Birch. Use when someone asks to cut, tighten, caption or turn a clip into a reel or short, add a name card, or reframe a wide video to vertical.
veds260/birch · ★ 1 · Code & Development · score 69
Install: claude install-skill veds260/birch
# Birch Birch is a local server with a `birch` command. If the Birch MCP tools (`birch_cut`, `birch_setup`) are available, use those: `birch_cut` does everything below in one call. Otherwise talk to the server over HTTP on 127.0.0.1 as described here. ## 1. Make sure it's running and set up ```sh command -v birch >/dev/null || curl -fsSL https://birch.video/install | sh birch doctor ``` If doctor lists anything missing, run `birch` and ask the user to finish the setup page it opens. Imports and renders are refused until setup is done. ## 2. Import the clip ```sh curl -s -X POST http://127.0.0.1:8796/api/importPath \ -H 'content-type: application/json' -d '{"file":"/Users/me/Movies/talk.mov"}' # → {"id":"..."} ``` Poll `GET /api/job?id=ID` until `stage` is `done`. That covers transcription, alignment and the automatic cut of pauses, retakes and filler. ## 3. Read the plan Birch starts reading the clip on import. Poll `GET /api/birch/direction?id=ID` until `running` is false. You get: - `direction.speaker`: name, role, and `how` it was found. The name is empty when the clip doesn't say it, so ask the user rather than guessing. - `direction.format`: the suggested format key from `refs/templates.json` - `direction.moments`: word indexes with one or two words to show If `error` mentions the claude CLI, skip the plan and just render captions. ## 4. Apply and render Order matters, because overlays are drawn for the frame shape that's saved. 1. `POST /api/settings` wi