cinematic-skill
cinematic-skill is a skill that teaches coding agents to make narrated documentary and explainer films drawn entirely by code, for creators without video editing skills.
What it is good for
- Making a narrated documentary from a topic without filming
- Turning a script into an explainer video with timed animation
- Creating a product launch or founder story video from my photos
- Adding sound effects, captions and a score to a narrated film
At a glance
- Who it is for
- Setup difficulty
- Technical ยท Guided command-line setup
Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.
- Cost
- Free and open source
- Type
- Skill or plugin
- Tasks
- Works with
- Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Wikimedia Commons
How to get started with cinematic-skill
- Run
npx skills add Moh4696/cinematic-skillin a terminal, or use the Claude Code, Codex or Gemini CLI install commands. - Start a new agent session after installing.
- Run
pip install -r requirements.txtand make sure ffmpeg is on your PATH. - Run the skill's
check_setup.pyto see what is missing. - Ask your agent for a short documentary on a topic and approve the beat table, look and draft.
From the project's own documentation. If a step does not match what you see, the official pages have the latest instructions.
Before you try it
- Needs Node 22.20+ for the npx installer, Python packages, and ffmpeg on your PATH.
- The agent pauses for your approval after the beat table, the look, and a 30 second draft.
- A 92 second 1080p film took about 6 minutes to render on a 16 GB laptop.
- Only free-licensed Wikimedia Commons images are downloaded; non-free files are refused.
Momentum
- Rank this week
- Not ranked yet
- Best rank
- None yet
- GitHub stars
- 550
GitHub numbers as of Nov 16, 2026. Updated weekly.
Official links
Questions
- Is cinematic-skill free?
- Yes. It is free and open source (MIT license).
- Do I need to know how to code to use cinematic-skill?
- You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
- What does cinematic-skill work with?
- According to its own documentation, it works with Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Wikimedia Commons.
- How do I get started with cinematic-skill?
- 1. Run npx skills add Moh4696/cinematic-skill in a terminal, or use the Claude Code, Codex or Gemini CLI install commands. 2. Start a new agent session after installing. 3. Run pip install -r requirements.txt and make sure ffmpeg is on your PATH. 4. Run the skill's check_setup.py to see what is missing. 5. Ask your agent for a short documentary on a topic and approve the beat table, look and draft.
- What should I know before trying cinematic-skill?
- Needs Node 22.20+ for the npx installer, Python packages, and ffmpeg on your PATH. The agent pauses for your approval after the beat table, the look, and a 30 second draft. A 92 second 1080p film took about 6 minutes to render on a 16 GB laptop. Only free-licensed Wikimedia Commons images are downloaded; non-free files are refused.
- What is cinematic-skill good for?
- Making a narrated documentary from a topic without filming, turning a script into an explainer video with timed animation, creating a product launch or founder story video from my photos, and adding sound effects, captions and a score to a narrated film.
Similar agents to cinematic-skill
- cinecode
Also builds short films and explainers in code, but the text does not describe narration timing or a documentary workflow.
- vibe-knowledge
Focuses on fact-checked narrated explainer shorts from one topic, rather than one continuous camera over a designed world.
- onetake
Makes continuous-take motion films aimed at product launches and feature demos instead of documentaries.
- OpenMontage
A broader video production system that turns an AI assistant into a studio for full videos.
- lanshu-create-ai-presenter-video
Guides explainer videos with a digital presenter or styled scenes rather than a camera moving over photos and maps.
- openfilm
openfilm is an open source video agent tool that lets a coding agent make videos you can then edit by hand, for creators and developers.