Editing vertical videos — IT Reelsmaker

How to use. A Claude Code plugin: a depersonalized version of a working skill built on real videos, with its techniques, styles and verified numbers kept. You don't need to edit SKILL.md: your own choices go into the plugin settings, the project defaults (reel-defaults.json) and the brand folder. The ⟨YOURS: …⟩ marks below are places taken from the brand profile (brand.json, rules.md) or decided in the brief.

Brands live in the project folder: {{PROJECT_ROOT}}/brands/<slug>/ holds the brand.json profile, the rules.md design rules, the assets/ files (logos, LUTs, fonts) and, if the brand has them, its video guide guide.md, CTA library cta.md and other documents. Template: ${CLAUDE_SKILL_DIR}/assets/brand-template/. Before editing, the agent asks which brand the video is for. {{NAME}} placeholders are fields of the selected brand's profile (table: references/brands.md).

Long sections live in references/ (table at the end). Scripts for every repeatable step (rough cut, speech mask, faces, visual plan, inserts, brands, cover, mastering) are in ${CLAUDE_SKILL_DIR}/scripts/: run them from {{PROJECT_ROOT}}, don't rewrite them for a video; what differs between videos goes into the video's JSON files. Which script for which step: references/scripts.md.

Language. Talk to the person in their language and translate any fixed labels from this file (style and tone names, question options, plan and report headings). On-screen text (hook, cards, scenes, CTA, subtitles) is in the language of the video, not of these instructions.

0. Environment, settings, brands

Environment, once per plugin version. it-reelsmaker.json → doctor_ok.version equal to the installed version (${CLAUDE_SKILL_DIR}/../../.claude-plugin/plugin.json) → skip this check; run it again after an update or when a script fails for a missing tool. The skill works where the agent runs commands and sees files on your computer, that is, in Claude Code. Run python "${CLAUDE_SKILL_DIR}/scripts/doctor.py" from the project folder (or python3, py -3): it checks ffmpeg, Python, Pillow, Node.js, the Remotion project, the transcriber, the face model and rembg, and prints the install command for this OS for anything missing; exit code 1 means a required program is missing, and a success on everything required and recommended is remembered in doctor_ok. No Remotion project yet → kit.py new <folder> creates one with the kit wired in (then npm install in that folder); an existing project: doctor.py compares its kit with the plugin's, kit.py update if it is missing or older. No tool for commands and files (claude.ai chat, Cowork without computer access) → say it plainly: “Editing runs in Claude Code on your computer: it needs ffmpeg, Node.js with Remotion and Python 3”, and do not pretend to edit. One program missing → name what to install and what won't work without it (without Remotion: graphics and rendering; without Python 3.9+: every script, from the rough cut to mastering). Pillow (pip install Pillow) is needed for contact sheets, covers and logos; OpenCV only for face measurement.

Project settings come from the plugin settings (Claude Code asks for them when the plugin is enabled; change them with /config):