Install
opencode-motion-video-director is on npm:
npm i opencode-motion-video-director
Then register the plugin in your opencode.json(c):
{ "$schema": "https://opencode.ai/config.json",
"plugins": ["opencode-motion-video-director"] }
Optionally let it register the recommended MCP servers at runtime (keyless ones
always, keyed ones only when their key is set in the project .env or your
environment — keys never land in config):
{ "$schema": "https://opencode.ai/config.json",
"plugins": [
{ "package": "opencode-motion-video-director",
"options": { "mcps": ["playwright", "scrapling", "elevenlabs", "lottiefiles"] } }
] }
Prefer no plugin? The same skill is available as an HTTP skills catalog:
{ "$schema": "https://opencode.ai/config.json",
"skills": ["https://viksaaskool.github.io/opencode-motion-video-director/"] }
What you get
- The skill — the full director workflow: preflight, planning, voiceover script for ElevenLabs, code-drawn scenes with fast preview loops, final render & asset/licence logging.
/mvd-setup— in your video project directory, it runs Preflight, walks you through missing tools, creates your gitignored.envkey file, and sends the kickoff message.- MCP auto-setup — registers the recommended servers behind
options.mcps; servers you configured yourself are never touched.
Example prompts
Copy one into OpenCode after installing the plugin:
Reel with a hook
Make a 15-second vertical reel (9:16) for shweep.lol, an app for counting sheep instead of doomscrolling. Open with a 2-second hook — "still scrolling at 2am?" — then three quick beats: the problem, the app, the calm. Indigo/cream palette with pastel-yellow accents, kinetic type, a soft lo-fi bed and burned-in captions. Write the voiceover script first, generate the MP3 locally with make_vo.py, then build the scenes and render a 1080x1920 MP4.
Product explainer
Create a 30-second product explainer for the same app: hook → problem → solution → CTA. Pastel night-sky look, a gentle 2D sheep animation that multiplies as the scrolling settles, warm local voiceover mixed to -14 LUFS. Deliver a 1080p MP4 plus the credits/licence list.
Three hook variants
Give me three 6-second hook variants for this video — different opening line and visual metaphor each, same brand colors. Show contact-sheet previews first, then render only the one I pick.
Reference-driven style
Match the pacing and shot rhythm of this reference video [paste link], but rebuild it in our style with SVG + GSAP. Keep the same beat count and use the 60-30-10 palette from our brand.
Examples
All three videos below are promo spots for 🐑 shweep.lol — an app for counting sheep instead of doomscrolling. Each was made end-to-end with this plugin, from the voiceover script through code-drawn scenes to the final ffmpeg render — just with a different model behind the director.
Recommended MCPs
| Name | Needs key | Key (project .env or environment) |
|---|---|---|
playwright | no | — |
scrapling | no | — |
elevenlabs | yes | ELEVENLABS_API_KEY |
lottiefiles | no | — |
Catalog files
What OpenCode fetches from this catalog:
SKILL.md— the skill instructionsscripts/analyze_ref.shscripts/create_env.shscripts/make_vo.pyscripts/normalize_env.pyscripts/preflight.shscripts/preview.mjsscripts/with-env.sh
Created a video with the plugin?
Want something added — a feature, a preset, a fix? Tell me at contact@viktorarsovski.xyz.