film-studio-agents
AI agent film studio: one prompt to a finished narrated film. Claude Code skills, local TTS, HyperFrames, Remotion, Three.js, ffmpeg.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 21 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aiyu-ayaan/film-studio-agents with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aiyu-ayaan/film-studio-agents'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/aiyu-ayaan--film-studio-agents)HTML
<a href="/listings/aiyu-ayaan--film-studio-agents"><img src="/api/listings/aiyu-ayaan--film-studio-agents/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
bin/new-project.sh my-film # makes projects/<date>-my-film/ from templates/project/ # then, in your agent: /film-studio "a 60 s explainer about ..."
Narrated film: `/film-studio`. Music-led film with no speech: `/film-studio-nospeech`. Captions on any video: `/film-captions`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 57 lines
- # film-studio-agents
- A video studio run by AI coding agents (Claude Code and any tool that reads `AGENTS.md`). Each film is code (HTML, React, Three.js) rendered to MP4, with a local voice and code-made sound.
- Ask for a film; the `film-studio` skill writes the story, voices it, builds each scene with the best-fitting video skill, mixes the sound, adds captions and checks the result.
- ## Demo
- The studio launch film, made by the studio itself (47 s, vertical, narrated):
- <img src="docs/launch.gif" alt="Studio launch film" width="270">
- [Full video with sound: `docs/launch.mp4`](docs/launch.mp4) (the GIF is silent; this is a 720p copy, the full-quality master stays local at `projects/2026-11-20-studio-launch/renders/final.mp4`).
- ## Quick start
- ```bash
- bin/new-project.sh my-film # makes projects/<date>-my-film/ from templates/project/
- # then, in your agent: /film-studio "a 60 s explainer about ..."
- ```
- Narrated film: `/film-studio`. Music-led film with no speech: `/film-studio-nospeech`. Captions on any video: `/film-captions`.
- ## How a film is made
- `story + script` > `storyboard + recipe per scene` (you approve) > `voice + timing` > `scenes` > `music + SFX` > `assemble` > `captions` > `review` > `deliver`.
- Every scene carries a `recipe` in `plan.json`: the blueprint, registry blocks, camera move, shot card, Lemo style or 3D record it uses. `scene_check.py` refuses a scene with a missing or invented recipe, a wrong size, or more than 40% frozen frames.
- ## Layout
- | Path | What it holds |
- |---|---|
- | `AGENTS.md` / `CLAUDE.md` | Rules, skill router, pipeline. `AGENTS.md` is a symlink to `CLAUDE.md`. |
- | `.agents/skills/` | Project skills (film-*, remotion-*). `.claude/skills/` and `.hermes/skills/` link here. |
- | `research/` | Dated notes: one card per skill, TTS, licences, money plan. |
- | `projects/<date>-<slug>/` | One folder per film: `plan.json`, script, storyboard, scene sources. |
- | `templates/project/` | Skeleton for new projects. |
- | `assets/` | Shared media, each file logged in `assets/LEDGER.md` with source and licence. |
- | `business/` | Paid work: leads and clients. |
- | `bin/` | `new-project.sh`, `vo.sh` (voice + word timings), `setup-skills.sh`. |
- ## Not in git
- Rebuildable or heavy files are ignored (see `.gitignore`): `.venv/`, `node_modules/`, all audio and video (`renders/`, `build/`, `audio/`, scene `clip.mp4`), and copies the skills vendor into each scene. Regenerate a film from its `plan.json`, `script.md` and scene sources.
- ## Setup
- - Machine used: 8 cores, 31 GB RAM, GTX 1650, ffmpeg 7, Chrome, Node, Python 3.11/3.12 via `uv`.
- - Python env: `.venv/` with kokoro-onnx, pocket-tts and CPU torch (see `research/tts.md`).
- - Install the video skills: `bin/setup-skills.sh all` (HyperFrames, Shotcraft, Motionmaxxing, 3DViz, Earshot, Lemo-Opuscar, Remotion). They install into `~/.claude/`, not this repo.
- - Every `npx hyperframes` command needs `export HYPERFRAMES_CACHE_DIR=$HOME/.local/share/hyperframes-cache`.
- - Self-test of the film scripts (about 35 s): `.agents/skills/film-studio/scripts/selftest.sh`.
- ## Voice and licences
- Only two voices are allowed: Kokoro-82M (Apache-2.0) and Pocket TTS (Kyutai, CC BY 4.0, credit Kyutai). Both run locally through `bin/vo.sh`. Skill and licence details: `research/licenses.md`. No third-party logo or character in paid work without rights.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.