Short vertical cut-paper explainer reels, made by your coding agent. Nine Agent Skills plus a Remotion library. Works with Claude Code, OpenCode, Codex, Gemini CLI, Cursor, Copilot and more.
TypeScript agent-skillsagents-mdclaude-codeclaude-code-skillscodexexplainer-videosgemini-cliopencodepapercutremotiontext-to-speechvideo-generation
docs: Claude Code or opencode throughout (install, use, troubleshooting)
José Naves7967dbc299e1
diff --git a/README.md b/README.mdindex 3dce0d2..ec656d0 100644--- a/README.md+++ b/README.md@@ -1,6 +1,6 @@# papercut-explainer-Make short vertical explainer reels that look like layered construction paper, with Claude Code doing the work.+Make short vertical explainer reels that look like layered construction paper, with Claude Code or opencode doing the work.@@ -8,7 +8,7 @@ Make short vertical explainer reels that look like layered construction paper, wThis repo is two things that work together:-- **Nine Claude Code skills** that run the whole pipeline: strategy, hook, script, storyboard, voice, build, QA, and an installer. Ask for a reel, or run one stage on its own.+- **Nine agent skills** (Claude Code and opencode) that run the whole pipeline: strategy, hook, script, storyboard, voice, build, QA, and an installer. Ask for a reel, or run one stage on its own.- **A Remotion library** the skills build on: a paper-cut component kit, 24 backdrops, 17 camera moves, 10 scene transitions, film-look layers, 79 sound effects and 8 music beds, plus the scripts that tie them into an episode.You describe the video ("explain this repo in 25 seconds"). The skills research it, write a script on a fixed spoken spine, plan every camera move and cut, make or fake the voiceover, and build the scenes in Remotion. You review stills and the final cut.@@ -38,7 +38,7 @@ Each camera move and cut, with its props and when to use it, is in [`library/pap## Install-You need Node 20+, npm, ffmpeg, rsync and Python 3. Claude Code is the front end.+You need Node 20+, npm, ffmpeg, rsync and Python 3. Claude Code or opencode is the front end.**With `npx skills`** (skills only, fastest):@@ -79,15 +79,21 @@ Non-interactive and scoped installs:./install.sh --uninstall # remove the links it made```-By default skills are symlinked into `~/.claude/skills` and the subagent into `~/.claude/agents`, so a `git pull` updates them. The installer writes `~/.config/papercut-explainer/config.env` with `PAPERCUT_LIB` and the Python paths it created; the library scripts and the skills read it. It never installs system packages (it prints the `brew` or `apt` line instead), replaces an identical existing skill folder (such as one from `npx skills add`) and moves a different one to `~/.config/papercut-explainer/backups/` instead of the skills folder, and does not touch your shell profile.+By default skills are symlinked into `~/.claude/skills` and `~/.config/opencode/skills` (pass `--target claude` or `--target opencode` for only one) and the subagent into the sibling `agents` folders (`~/.claude/agents`, `~/.config/opencode/agents`; opencode also discovers the `.claude` paths), so a `git pull` updates them. The installer writes `~/.config/papercut-explainer/config.env` with `PAPERCUT_LIB` and the Python paths it created; the library scripts and the skills read it. It never installs system packages (it prints the `brew` or `apt` line instead), replaces an identical existing skill folder (such as one from `npx skills add`) and moves a different one to `~/.config/papercut-explainer/backups/` instead of the skills folder, and does not touch your shell profile.-Prefer to let Claude do it? Open Claude Code in this folder and say **"set up papercut-explainer"**. The `papercut-setup` skill asks which mode you want, confirms any large download, runs the installer with the right flags and checks the result.+Opencode-only minimal install:-Install by hand: symlink or copy each folder in `skills/` into `~/.claude/skills/`, `agents/papercut-scene.md` into `~/.claude/agents/`, then `export PAPERCUT_LIB="$PWD/library"`.+```bash+./install.sh --mode minimal --target opencode --yes+```++Prefer to let the agent do it? Open Claude Code or opencode in this folder and say **"set up papercut-explainer"**. The `papercut-setup` skill asks which mode you want, confirms any large download, runs the installer with the right flags and checks the result.++Install by hand: symlink or copy each folder in `skills/` into `~/.claude/skills/` and `~/.config/opencode/skills/`, `agents/papercut-scene.md` into `~/.claude/agents/` and `~/.config/opencode/agents/`, then `export PAPERCUT_LIB="$PWD/library"`.## Use it-Open Claude Code in any folder you want the episode to live in and ask for a reel:+Open Claude Code or opencode in any folder you want the episode to live in and ask for a reel:> Make a papercut explainer about https://github.com/example/echolark. 25 seconds, comment keyword PAPER.@@ -219,7 +225,7 @@ Projects keep a snapshot of the kit in `src/lib/`, so an old episode renders the| Python | 3.9+ for the tools; 3.10–3.12 for the voice venv (the installer uses `uv` if you have it, else `python3.12`/`3.11`/`3.10`) || Chrome or Chromium | for the SFX and music render only (`CHROME_PATH` to override). Video renders use Remotion's own headless browser, downloaded on first render. || Disk | about 0.7 GB per project for `node_modules` (shared by APFS cloning on macOS; plain copy elsewhere, or set `DONOR`); 4–6 GB for local voice |-| Claude Code | the skills and subagent target it |+| Claude Code / opencode | the skills and subagent target both (see `--target`) |## Cost@@ -247,7 +253,7 @@ What moves the cost, largest first:| Model download stalls | Rerun `library/voice/setup_tts.sh`; finished files are kept. It already sets `HF_HUB_DISABLE_XET=1`. || First render is slow | Remotion downloads its headless browser (about 200 MB) once. || `--gl=angle` rejected | Edit the flag in `library/tools/render.py` and `qa.sh` for your Chrome build. |-| A skill does not trigger | Check `ls ~/.claude/skills`; restart Claude Code after installing. |+| A skill does not trigger | Check `ls ~/.claude/skills` and `ls ~/.config/opencode/skills`; restart Claude Code after installing (opencode reloads automatically). |## Limitsdiff --git a/examples/prompts.md b/examples/prompts.mdindex f209db7..346ba6f 100644--- a/examples/prompts.md+++ b/examples/prompts.md@@ -2,7 +2,7 @@Copy-paste prompts for each skill, in the order of the workflow, with what to expect. Replace anything in `<angle brackets>`.-Claude Code picks a skill from your wording. If the wrong one loads, or none does, name it: "use papercut-hook to write 5 hooks for this fact list". Each skill reads the files the stage before it wrote, so you can stop after any stage and pick up in a new session. `examples/paper-trail/` shows what every stage writes.+Claude Code or opencode picks a skill from your wording. If the wrong one loads, or none does, name it: "use papercut-hook to write 5 hooks for this fact list". Each skill reads the files the stage before it wrote, so you can stop after any stage and pick up in a new session. `examples/paper-trail/` shows what every stage writes.## End to end@@ -32,7 +32,7 @@ Set up papercut-explainer, partial install- Loads `papercut-setup`. It runs `./install.sh --doctor` from the repo root and tells you in plain words what is installed and which mode that adds up to.- Asks, in one question: how much (Minimal, Standard, Full or Custom), skills for every project or one, symlink or copy. "Partial" usually means Minimal, or Custom with the components you name (`skills,deps,pytools,verify`). It asks again before any multi-GB download.-- Runs `install.sh --yes` with the matching flags and writes `~/.config/papercut-explainer/config.env`, which every later skill reads for the library path. A new Claude Code session picks up the linked skills.+- Runs `install.sh --yes` with the matching flags and writes `~/.config/papercut-explainer/config.env`, which every later skill reads for the library path. A new Claude Code session picks up the linked skills (restart it); opencode reloads them automatically.## 2. Strategy