cinematic-skill README

项目的 README,来自 github.com/Moh4696/cinematic-skill。合并为一个 markdown 文件:README.md。

Cinematic Skill

Narrated cinematic films, built entirely from code, by your coding agent.

MIT License   Works with Claude Code, Codex, Cursor, Gemini CLI and OpenCode   Checks

The cold open of a code-built documentary about the first flight: the date set big on a yellow block, the camera pulls back to a map pin on the Outer Banks, then glides to the 1903 first-flight photograph pinned to a cork wall as counters roll up to 12 seconds and 120 feet.

Ask your agent for "a 90 second documentary about the Wright brothers" and it writes the script, records a voice, finds public-domain photos with their licences, and builds one continuous camera move over a single designed world. Stamps slam, highlighters swipe and numbers roll up on the exact word the narrator says. It finishes with sound effects, an optional score and burned-in captions.

Nothing is generated video. Every frame is drawn by code (Skia, in Python), so the film renders the same every time, changes are cheap, and a new voice re-times the whole film by itself.

The final pull-back of the documentary: a US map print with Ohio and North Carolina filled, a route from Dayton to Kill Devil Hills, portraits, a typeset letter, Langley's failed machine with two stamps, and the first-flight photo with its counters, all on one cork wall The starter explainer in the light studio look: the title From Cherry to Cup over four cards, Grow, Pick, Roast and Brew, joined by arrows, with a 200 degree counter

Left: the final frame of "Twelve Seconds", the 90 second documentary that ships as the worked example, made from seven public-domain photos. Right: the starter explainer that every new project begins as.

Install

npx skills add Moh4696/cinematic-skill

That uses the npx skills CLI (Node 22.20+). It installs for Claude Code, Codex, Cursor, Gemini CLI, OpenCode and dozens more. Start a new agent session afterwards.

Claude Code plugin
/plugin marketplace add Moh4696/cinematic-skill
/plugin install cinematic-skill@cinematic-skill
Codex plugin
codex plugin marketplace add Moh4696/cinematic-skill
codex plugin add cinematic-skill@cinematic-skill
Gemini CLI
gemini extensions install https://github.com/Moh4696/cinematic-skill
Without Node: the shell installer
curl -fsSL https://raw.githubusercontent.com/Moh4696/cinematic-skill/main/install.sh | bash

It clones to ~/.cinematic-skill and links the skill into every coding agent it finds. Run it again to update. From a clone: ./install.sh --claude --codex, ./install.sh --dir path/to/skills, ./install.sh --copy, ./install.sh --uninstall.

Then install what the scripts use:

pip install -r requirements.txt      # skia-python, numpy, pillow (scipy optional)

ffmpeg must be on your PATH. The skill's check_setup.py checks everything and says what's missing.

What it makes

Kind Look Images
Documentary, history, true crime Cork evidence wall, slate Archive photos and documents, black and white
Product launch, brand or founder story Studio, charcoal Your own product shots and photos, in colour
Science, engineering, how it works Blueprint, paper Diagrams, archive or AI stills
Tech, space, trailers Night Screenshots, renders, AI stills

The items work on every look:

A spotlight follows the camera so each line has one hero.

How it works

  1. Story. The agent researches, fact-checks and writes the script: one idea per line, and time only moves forward after the opening. Each line also says what the camera shows. A beat table with a chronology lint goes to you for approval.
  2. Voice. A free scratch voice (macOS say or espeak-ng) times the film first. The final voice can be any TTS or a person, recorded one section at a time and split into timed lines automatically. Suspect cuts get flagged.
  3. Images. Wikimedia Commons search and download, with each licence recorded. Non-free files are refused. You can also add your own photos or AI stills. credits.md is written for you.
  4. Scene. A short Python file places items on the voice's timing (doc.W(line, "word")) and keys the camera.
  5. Review. The agent renders stills and contact strips of every move and checks them for known mistakes before showing you a draft.
  6. Sound and finish. It synthesises the sound effects (nothing to license) and mixes them with the voice and an optional score, ducked and loudness-normalised. A memory-aware parallel render follows, then four caption styles and an SRT.

The agent stops for your approval after the beat table, the look, and a 30 second draft.

Try the example

cd skills/cinematic-film/scripts
python3 new_project.py ~/wright --example
python3 fetch_commons.py get --project ~/wright
python3 make_map.py --project ~/wright && python3 prep_assets.py --project ~/wright
python3 tts_say.py --project ~/wright && python3 split_takes.py --project ~/wright && python3 build_narration.py --project ~/wright
python3 render.py --project ~/wright --size 1280x720 --out out/draft.mp4 --audio audio/narration.m4a

On a 16 GB laptop the 92 second film renders at 1080p in about 6 minutes.

Credits

Built from a 5 minute documentary about Al Capone that exploraX made with an agent, then opened up to any subject. The rules and code here were written from what broke along the way. The example film uses public-domain photographs from Wikimedia Commons; see its photos.json.

Works well with

Feedback

Open an issue or a pull request, or find me on X at @exploraX_.

License

MIT License · Copyright (c) 2026 exploraX

cinematic-skill (Moh4696/cinematic-skill)

正在搜索数据库…

这是什么?一个代理技能,可以完全通过代码制作带旁白的电影感短片。你的编程代理负责撰写脚本、录制配音、查找公有领域的照片,并制作一个与旁白时间对齐的连续运镜。
它会用 AI 生成视频吗?不会。每一帧都由代码通过 Python 中的 Skia 绘制,因此每次渲染的结果都一样,修改起来也很省事。
怎么让它运行起来?通过 npx skills 命令行工具安装(需要 Node 22.20+),它会为 Claude Code、Codex、Cursor、Gemini CLI 等工具完成配置;也可以使用 shell 安装脚本,它会克隆到 ~/.cinematic-skill。然后开启一个新的代理会话,请它制作一部影片即可。
除了代理,我还需要什么?使用 npx 方式需要 Node 22.20+,渲染器需要 Python,并且 ffmpeg 要在你的 PATH 中。运行该技能中的 checksetup.py,可以查看缺少哪些组件。
安装时有什么容易踩的坑,或者哪些环节比较慢?首先要检查的是 PATH 中是否缺少 ffmpeg。渲染也需要不少时间:在一台 16 GB 内存的笔记本上,92 秒的示例以 1080p 渲染大约需要 6 分钟。
它能在哪些系统上运行?README 中为临时配音指定了 macOS,并附带了 shell 安装脚本,但没有提及 Windows。macOS 和 Linux 是比较稳妥的选择。
它需要联网吗?照片搜索和下载使用 Wikimedia Commons,所以这一步需要网络连接。README 没有说明最终配音会使用哪种 TTS 服务。
我能用自己的照片,而不是公有领域的照片吗?可以。你可以添加自己的照片、截图或 AI 生成的静态图,而撕边剪报、邮票、卡片、地图和红线等元素在每种风格中都可以使用。
它能制作哪些类型的影片?纪录片、产品发布、科普讲解以及科技或预告片类影片。每种类型都有自己的风格,例如软木证据墙、影棚、蓝图或夜景。
有没有可以观看的成品示例?有。技能中附带了一个完整示例 Twelve Seconds,这是一部用七张公有领域照片制作的 90 秒纪录片。
代码从哪里来?代码是从 exploraX 借助代理制作的一部关于阿尔·卡彭的 5 分钟纪录片中提取出来的,其中的规则则是根据制作过程中出现的问题总结而成。
作者
Moh4696
大小
1.9 MB
星标
732
更新
提交Nov 09
时长
9天
提交 · 90 天