PluginPartly tested (needs an account)
Short video director for Claude Code
video-director
Plugin that directs short videos: you pick from still options, review a storyboard page with notes, then it builds and checks the film with HyperFrames.
- Works with
- Claude Code
- Good for
- Graphic designers
What it does
Video Director is a Claude Code skill, shipped as a plugin, for short films of about 6 seconds to 3 minutes. It covers 8 video types: product launch, explainer, brand film, demo or tutorial, social short, event or data video, showcase and live-action story ad. You direct and the assistant designs and builds.
Nothing is animated until you approve still frames. At each design decision you pick from two or three real options, and for motion graphics you first pick a look from a page of 44 animation styles. You then get one HTML storyboard page where you can zoom, flip through frames and pin numbered notes, a motion spec that names every move with its timing and easing, an animated test, and the full build with HyperFrames.
Python scripts check frames around each cut, choppy motion, text size and reading time, sound levels and delivery size. A bundled copy of Clipwing's real-sfx places recorded effects from your own sound library, and music is fitted to the cut on its bar lines. Every choice you make goes into a direction-notes.md file, so a later session can pick up where you stopped.
Example prompts
- "animate this script"
- "make an explainer"
- "cut a 15-second version"
- "I want to see the storyboard first"
- "it feels like slides"
How to install
/plugin marketplace add SallyRS/video-director/plugin install video-director@video-directorHow to use it
Ask for a short film in plain words, for example "animate this script" or "make an explainer". The skill asks brief questions first, shows 2-3 still options at each design decision, builds a storyboard HTML page, then a motion spec, an animated test and the full HyperFrames render.
Check it works
Run claude plugin list in a terminal. It should show video-director 1.5.0 as enabled. Then start a new Claude Code session and say "make an explainer". The assistant should load the video-director skill and ask brief questions first (the type, the format, narration, what the film is made of) instead of writing animation code.
Common problems
- Storyboard frames do not render ("no Chrome or Chromium found") — install Google Chrome, or set CHROME to the path of your Chrome or Chromium — https://github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/scripts/render_frames.py
- The build stops before the animated test — the skill checks for the HyperFrames command line, Chrome, ffmpeg, Playwright and numpy and pauses if one is missing; run
npx hyperframes doctor— https://github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/build-and-qa.md - Sound placement fails on macOS — real-sfx needs ffmpeg with drawtext and rubberband (Homebrew ffmpeg-full, first in PATH) and numpy — https://github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/sound-stage.md
- Motion watch does not run — it needs GEMINI_API_KEY and the --upload-allowed flag; on a quota error (429) try another Gemini model with --model — https://github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/build-and-qa.md
Other assistants
- No Codex or Gemini CLI install route is documented. The README only says you can copy skills/video-director/ into ~/.claude/skills/ for Claude Code — https://github.com/SallyRS/video-director
What to watch out for
- Needs Python 3, ffmpeg, Google Chrome or Chromium (storyboard frames stop without it) and the HyperFrames command line (Node.js). Sound placement needs ffmpeg with the drawtext and rubberband filters (Homebrew ffmpeg-full on macOS) and numpy
- The build runs npx hyperframes (docs, doctor, check, snapshot, preview). The HyperFrames command line sends usage data by default; turn it off with npx hyperframes telemetry disable
- Optional motion watch (scripts/watch_cut.py) uploads your rendered MP4 to the Gemini API with your GEMINI_API_KEY, only with --upload-allowed. It deletes the upload afterwards; on Google's free tier your content may be used to improve Google's products
- Optional stills: the skill starts codex exec in the background (nohup, model gpt-6.1-sol, Codex's default sandbox) with an image brief, which uses your Codex plan
- Optional generated clips use the Higgsfield command line, which costs Higgsfield credits and uploads your still frames; the skill checks the cost and balance first
- Optional music from Suno (a paid plan for any commercial use). With your OK, it downloads reference films with yt-dlp into the project
- Optional sound tools download large files only when run with install --yes: listen.py about 45 MB (onnxruntime, numpy, a 16 MB model from Hugging Face) and hear.py about 3.1 GB (torch and a 2.75 GB model from Hugging Face), into the plugin folder
- The uisfx interface sounds (CC0) ship inside the plugin; setup.py init --uisfx would install them again from npm, version not pinned
- Reads your project's direction-notes.md and any design-taste notes or memory files you keep, writes project folders and versioned review pages, and writes its sound settings to ~/.config/real-sfx/
- No disable-model-invocation, and the description asks to be used whenever you want to make, storyboard or fix a short video, so the assistant can start it on its own
- Repo created on 2026-11-06 with no releases or tags (version 1.5.0 in plugin.json). The README and repo description still say 57 animation styles; the 1.5.0 skill has 44
Licence and author
- Licence
- MIT
- Author
- Sally Slater (SallyRS)
- Source code
- github.com/SallyRS/video-director
How we tested it
We installed it on an empty test computer on 8 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
In the test container the marketplace was added and the plugin installed; claude plugin list shows video-director 1.5.0 enabled. The README says every example on its page comes from a real 52-second ad made with it. We did not make a film, because that needs a signed-in session, Chrome and HyperFrames.
Technical details of the test
- Date
- 8 Nov 2026
- Method
- Reviewed by our team against the repository at commit 205060f: README, plugin.json, marketplace.json, SKILL.md, the reference files and the scripts with network calls. We ran the two install lines in a clean test container.
Checked again on 8 Nov 2026
Alternatives
- HyperFrames — the HTML-to-video engine this plugin builds every film with; Video Director adds the brief, options, storyboard and check steps on top
- Animate — a Claude Code skill for short animated explainers in set styles that also shows a storyboard first
- Motion Graphics Skill Pack — skills for launch videos and animated charts, without the options-and-storyboard review steps
FAQ
- Q: Do I need paid tools? A: Not for the core flow. Codex stills, Higgsfield clips, Suno music and the Gemini motion watch are optional, and some cost money. The skill says what it cannot do or check without them.
- Q: Does anything leave my computer? A: The core storyboard and checks run on your computer, but HyperFrames sends usage data unless you turn it off. Codex stills, Higgsfield clips and the Gemini motion watch send your briefs, stills or the video to those services, and only if you use them.
- Q: Can it record my real app screen? A: No. SKILL.md says it is not for recording a real product screen, adding captions to existing footage, or a single logo sting.
Sources
- github.com/SallyRS/video-director
- github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/SKILL.md
- github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/.claude-plugin/plugin.json
- github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/media.md
- github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/build-and-qa.md
- github.com/SallyRS/video-director/blob/205060feef1bdbb54fcc38d0fbbeb9dd6aa1b3e7/skills/video-director/references/sound-stage.md