story-video-director
zlbigger/story-video-director
story-video-director is an agent skill project by zlbigger on GitHub: Turns any story into image assets, storyboard, Chinese audiovisual prompts and a list of API calls. It covers characters, storyboard and prompts, and its README says it works with Codex. 34 stars, last updated 2026-10-07, MIT license.
Editor's notes
Built for Codex: from a story, article or one-line idea it first writes scene cards and a continuous screenplay and decides the total runtime, then splits it into clips of 15 s or less and uses Codex ImageGen to create four-view character sheets (front, side, back, face close-up) and location images. Each clip gets a Chinese audiovisual prompt that cites assets as name@filename.png, along with project-manifest.json and api-jobs.json, which validate_project.py checks. When you explicitly ask and have a key configured, it can submit paid MiniMax-H3 jobs through Metaso and merge the clips with FFmpeg. Third-party material in reference-materials is not covered by the MIT license.
- Type
- Storyboards · visual assets · video prompts
- Stages
- Characters · Storyboard · Prompts
- Agents
- Codex
- Format
- Agent skill
- Language
- Chinese
- GitHub stars
- ★ 34
- Last updated
- 2026-10-07
- License
- MIT
- SKILL.md files
- 1
- Checked by hand
- 2026-10-13
In the author's words
A Codex skill that automatically turns any story into a full set of image assets, a storyboard, Chinese audiovisual prompts and an API job list
Translated from the Chinese original.
Skills in this repo (1)
Names and descriptions come from each SKILL.md frontmatter; Chinese descriptions are shown in our English translation.
- story-video-director
Turn any story, article, script, synopsis, anecdote, advertisement concept, poem, or one-line video idea into a director-led AI video production package and, when explicitly requested, render and assemble the video through a configured image-to-video API. Use when Codex should determine runtime, sp…
Install
npx skills add zlbigger/story-video-director
# pick agents (claude-code / codex / cursor / opencode / gemini-cli / openclaw)
npx skills add zlbigger/story-video-director -a claude-code -a codexDefault commands use the skills CLI and were not verified one by one; follow the repo README. Read SKILL.md before installing. Install guide →
Similar projects
4 subagents collaborate to turn a story idea into video storyboard and asset prompts, and can call the Dreamina CLI to generate images and submit video tasks
MiniMax H3 manju director: web novel to storyboard, core vs. extra asset tiers, long takes for dialogue and fast cuts for fights, action-continuity locks, last-frame relay, a whole episode's prompts in one pass
Chinese epic scenes: expands a one-line premise into a xianxia/mythology short-film story, builds a continuity ledger, and outputs paired image and video prompts per shot
Prompts for the Higgsfield platform: MCSLA formula, Seedance 2.5 multi-reference directing, performance direction, Soul ID character consistency, shot lists and failure diagnosis
- visual-skills★ 522
AI film director: dramaturgy rules such as Murch's editing principles, blocking and montage, plus exact Seedance prompt syntax