spark-video
JohnKeating1997/spark-video
spark-video is an agent skill project by JohnKeating1997 on GitHub: One-line premise → script, storyboard, character/scene/prop consistency, rendering and per-shot AI QC through to a final mp4, with a confirmation gate at each stage. It covers characters, script, review, storyboard, prompts and production, with prompts for Wan (Tongyi Wanxiang) and Seedance / Jimeng, and its README says it works with Claude Code, Cursor and Codex. 34 stars, last updated 2026-09-01, no license declared.
Relies on paid video APIs such as Alibaba Cloud Bailian; defaults to short-drama mode but also has ad and science-explainer examples
- Type
- All-in-one: script → storyboard → video
- Stages
- Characters · Script · Review · Storyboard · Prompts · Production
- Video models
- Wan (Tongyi Wanxiang) · Seedance / Jimeng
- Agents
- Claude Code · Cursor · Codex
- Format
- Agent skill
- Language
- English
- GitHub stars
- ★ 34
- Last updated
- 2026-09-01
- License
- None declared
- SKILL.md files
- 7
- Checked by hand
- 2026-10-13
In the author's words
AI video production skill — premise → screenplay → storyboard → render → review → final mp4, with consistent characters / sets / props. Cross-platform (Claude Code, Qwen Code, …).
Skills in this repo (7)
Names and descriptions come from each SKILL.md frontmatter.
- spark-video
Install, set up, diagnose, and run the full spark-video AI video production pipeline from premise to screenplay, storyboard, render, review, and final mp4. Use when the user mentions spark-video, wants to make an AI video, episode, short, ad, or recap, or asks to install, repair, or run the spark-v…
- spark-video-cast
Scaffold and generate reference assets for characters (cast), locations (movie-set / set dressing), and key props — the three pillars of visual consistency in spark-video. Wraps bl image generate / edit for cast reference sheet creation. Use when adding new characters/locations/props or when costum…
- spark-video-clip-review
Per-clip quality reviewer + render retry state machine. After each rendered shot, score it on 6 axes via `bl omni` (qwen3.5-omni-plus), then decide ACCEPT / REJECT-and-rewrite / REJECT-and-escalate. Handles up to N retry rounds with auto prompt rewriting; escalates to spark-video-director when retr…
- spark-video-director
Translate a screenplay (one scene at a time) into a provider-agnostic storyboard fragment for the spark-video pipeline. Wraps Shanyin Super Director Master when available — the upstream Shanyin SKILL is the single source of truth for craft when present.
- spark-video-producer
Producer stage for the spark-video pipeline. Orchestrates screenwriter, director, cast, VFX review, clip review, render chain DAGs, and final stitching with the 4+2 user confirmation gates. Use internally when running the end-to-end spark-video production workflow.
- spark-video-screenwriter
Turn a user's premise into a structured screenplay (one scene at a time) for the spark-video pipeline. Wraps Shanyin Super Screenwriting Master when available — that upstream Shanyin SKILL is the single source of truth for craft when present.
- spark-video-vfx-review
Pre-render quality gate. Read a finished storyboard.json and produce a structured review report flagging visual inconsistencies, prompt defects, and continuity errors that would waste render budget. You find problems; the director fixes them. Opt-in — bypassed unless the producer explicitly invokes…
Install
npx skills add JohnKeating1997/spark-video
# install a single skill
npx skills add JohnKeating1997/spark-video --skill spark-video
# pick agents (claude-code / codex / cursor / opencode / gemini-cli / openclaw)
npx skills add JohnKeating1997/spark-video -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
Skill pack organized like film departments: writing, directing, characters, art, cinematography, storyboard, shot list, prompts, sound and editing, dispatched and QC'd by a supervisor skill
- ai-manga-drama★ 17
AI manju workshop: eight-step flow from one-line idea to final video with task-card scripts, character reference library, style anchors, storyboard, image/video prompts, voiceover, subtitles and final compositing check
Hardcore Director: film and AI video controller that routes by stage to screenwriting/short drama, characters and scenes, storyboard, Seedance 2.5/Wan 3.0/H3 prompts, sound and editing modules
Full pipeline for short drama / manju: novel breakdown, development, script, character assets, storyboard, image/video prompts, review
Dramake: text to AI short drama, chaining script, storyboard, voiceover, editing and QC, for Douyin/Hongguo in landscape or vertical, with built-in evals