Repolode
Submit
win4r

win4r/video-director

A Claude Code skill that guides Claude Opus 5.5 to plan, build, render and QA short videos written as HTML, Canvas, SVG, Three.js, GSAP or Remotion code.

View on GitHub
Stars
385
Forks
33
Open issues
0
Last commit
8 hours ago

What is it?

video-director is a Claude skill for making short videos as code. It guides the model to plan a film in numbers, write the animation in HTML, Canvas, SVG, Three.js, GSAP or Remotion, render it frame by frame to MP4, and then check the result. It targets launch films, promos, explainers, data stories, kinetic type, illustrated shorts, loops and social reels, and is designed primarily for Claude Opus 5.5 in Claude Code.

The skill bundles principles with their reasons, a workflow with a gate at each phase, and two Python scripts. check_timeline.py validates the plan before any code is written. qa_video.py measures the rendered file for text size and contrast on the opening frame, flashes, cuts, freezes, loop seams, loudness, silences, and contact sheets. It intentionally does not ship a shot library to copy.

Installation means copying the skill folder into ~/.claude/skills/ or uploading a zipped folder as a custom skill. The scripts require ffmpeg, Python 3 with numpy and Pillow, and for HTML rendering Node with Playwright and Chromium.

Key features

  • 01Plans films with a timeline file, validated by check_timeline.py before any code is written.
  • 02Builds animations in HTML, Canvas, SVG, Three.js, GSAP or Remotion.
  • 03Measures rendered MP4s for opening text size, contrast, flashes, cuts and freezes.
  • 04Checks loop seams and audio loudness and silences with qa_video.py.
  • 05Includes test briefs with graders for evaluating the skill.

Use cases

  • Making a short looping launch video for a CLI tool from its README.
  • Producing a narrated explainer on an algorithm with code-drawn animation.
  • Turning a CSV data set into a social reel with honest, measured numbers.
  • Reviewing an existing coded video to fix slow pacing or unreadable text.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/win4r/video-director.git
  2. 2

    Copy the skill folder into your personal Claude Code skills

    cp -R video-director/video-director ~/.claude/skills/
  3. 3

    Validate a plan with the timeline checker

    python3 video-director/scripts/check_timeline.py timeline.json

Things to know

  • Built primarily for Claude Opus 5.5 in Claude Code; other models are not evaluated.
  • Rendering HTML films needs Node with Playwright and Chromium, plus ffmpeg and Python packages.
  • Eval results are based on one run per configuration, so the evidence is limited.

In collections

Claude Code tools, skills & pluginsAI agent skill librariesAI video & audio tools

Topics

#claude-code#video-generation#animation#remotion#threejs#html-canvas#ffmpeg#agent-skill

FAQ

What is video-director?
A Claude Code skill that guides Claude Opus 5.5 to plan, build, render and QA short videos written as HTML, Canvas, SVG, Three.js, GSAP or Remotion code. video-director is a Claude skill for making short videos as code. It guides the model to plan a film in numbers, write the animation in HTML, Canvas, SVG, Three.js, GSAP or Remotion, render it frame by frame to MP4, and then check the result. It targets launch films, promos, explainers, data stories, kinetic type, illustrated shorts, loops and social reels, and is designed primarily for Claude Opus 5.5 in Claude Code.
Is video-director free to use? What license does it have?
video-director is open source under the MIT license. Check the license terms before using it in commercial products.
Is video-director still maintained?
Actively maintained. The last commit to video-director was on Nov 7, 2026.
What can I use video-director for?
Making a short looping launch video for a CLI tool from its README. Producing a narrated explainer on an algorithm with code-drawn animation. Turning a CSV data set into a social reel with honest, measured numbers. Reviewing an existing coded video to fix slow pacing or unreadable text.
How do I install video-director?
Clone the repository: git clone https://github.com/win4r/video-director.git Copy the skill folder into your personal Claude Code skills: cp -R video-director/video-director ~/.claude/skills/ Validate a plan with the timeline checker: python3 video-director/scripts/check_timeline.py timeline.json
Where can I get video-director?
The source code and installation instructions are on GitHub: https://github.com/win4r/video-director

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects