procedural-film README

The project's README from github.com/kuhnhomeuk-cell/procedural-film. As one markdown file: README.md.

procedural-film

Six frames from the butterfly-life film, alternating hand-inked paper shots and navy blueprint shots

An agent skill that turns a topic into a 30-second vertical film. Every pixel is drawn in vanilla JavaScript on a canvas and every sound is synthesised in Web Audio, so the film ships with zero media assets. The output is one self-contained HTML player plus MP4 exports.

The reference film is examples/butterfly-life, the life cycle of a monarch butterfly: 17 shots, 32 seconds, 120 bpm, 1080x1920 at 24 fps.

What is in the repo

Path Contents
skills/procedural-film/ The skill. SKILL.md is the pipeline, foundation/ is the engine and tools copied into each new film, templates/ holds the four planning documents, reference/ holds the shot-type index, scene and music guides, and frames from the example as the visual target.
examples/butterfly-life/ The butterfly film as the skill produces it: planning docs, source, tools, the HTML player and the phone MP4.

Requirements

Install the skill

Clone the repo, then link the skill into your agent's skills folder. A link keeps the worked example reachable at examples/butterfly-life/ beside the skill.

git clone https://github.com/kuhnhomeuk-cell/procedural-film.git
ln -s "$PWD/procedural-film/skills/procedural-film" ~/.claude/skills/procedural-film

For another agent, link it into that agent's skills folder.

Make a film

Ask your agent for a procedural film about a subject, for example "make a procedural film about the life of a honeybee". skills/procedural-film/SKILL.md holds the full pipeline. Expect a long run: one agent per shot writes a scene file of 1000+ lines, then critic waves review every shot, so a film spends a large share of a usage plan.

Rebuild the butterfly film

npm install --prefix examples/butterfly-life/tools
node examples/butterfly-life/tools/check.cjs
node examples/butterfly-life/tools/render.cjs

check.cjs runs the six-check gate and exits 0 when green. render.cjs writes examples/butterfly-life/exports/butterfly-life.mp4. node examples/butterfly-life/tools/build.cjs rebuilds the HTML player.

Credit

The look and editing are modelled on Kevin Ngo's "The life of a fruit fly". examples/butterfly-life/docs/reference-analysis.md records what was taken from it.

License

MIT. See LICENSE.

procedural-film (kuhnhomeuk-cell/procedural-film)

Searching Database…

Что это?Навык для агента, который превращает тему в 30-секундный вертикальный фильм: каждый пиксель рисуется на canvas на чистом JavaScript, а каждый звук синтезируется через Web Audio — стоковые видео и аудиофайлы не используются. На выходе — автономный HTML-плеер плюс экспорт в MP4.
Это отдельное приложение или то, что подключается к агенту?Это навык (пайплайн SKILL.md плюс движок), который подключается в папку навыков ИИ-агента; затем агент ведёт весь процесс генерации, отправляя параллельных субагентов.
Как установить и использовать?Склонируйте репозиторий и подключите папку навыка в каталог навыков агента, затем просто попросите агента снять фильм о чём-нибудь, например 'сними процедурный фильм о жизни медоносной пчелы'.
Что должно быть установлено для запуска?Node.js 20+, ffmpeg в PATH, Chromium, установленный через Playwright, и агент, способный запускать навыки и отправлять параллельных субагентов, например Claude Code.
Сколько времени занимает генерация фильма?Ожидайте долгой работы: один агент пишет файл сцены на 1000+ строк на каждый кадр, затем волны критиков просматривают каждый кадр, так что один фильм может съесть большую долю лимитов агентского тарифа.
Он работает только с Claude Code?Claude Code — пример агента, но в README сказано, что навык можно подключить в папку навыков любого агента, если тот умеет запускать навыки и отправлять параллельных субагентов.
Что за референсный фильм, включённый в репозиторий?Готовый пример о жизненном цикле бабочки-монарха (examples/butterfly-life): 17 кадров, 32 секунды, 120 bpm, рендер в 1080x1920 при 24 fps, поставляется и как интерактивный HTML-плеер, и как MP4 с кадрированием под телефон.
Как пересобрать фильм-пример?Запустите check.cjs, чтобы пройти шесть проверок, render.cjs, чтобы записать MP4 с бабочкой, и node examples/butterfly-life/tools/build.cjs, чтобы пересоздать HTML-плеер.
Что вдохновило визуальный стиль?Внешний вид и монтаж смоделированы по 'The life of a fruit fly' Кевина Нго; конкретные влияния задокументированы в examples/butterfly-life/docs/reference-analysis.md.
Что на самом деле содержит пакет навыка?В skills/procedural-film/ лежат SKILL.md (пайплайн), базовый движок и инструменты, копируемые в каждый новый фильм, шаблоны документов планирования и папка референсов с гайдами по типам кадров, сценам и музыке плюс целевые кадры.
Size
24.1 MB
Stars
511
Age
1mo
Commits · 90 Days