zenstory-ai/drama-skills

What it is

Drama Skills is an open‑source collection of agent‑compatible “skills” that let a writer (or a small studio) turn a story idea or a full‑length novel into a finished short‑drama video, all with AI. The pipeline is broken into eleven well‑defined steps – from novel analysis, script writing, asset extraction, image‑prompt generation, storyboard creation, video‑prompt writing, production, editing, and final review – each exposed as a separate command (e.g., $short‑drama‑write, $short‑drama‑image‑prompts). The commands run inside a programming‑agent environment such as Claude Code or Codex, using the same LLM that powers the agent for the creative work.

How it works

1. Installation – Skills are distributed via ClawHub (or manual symlinks). A single npx skills add zenstory-ai/drama-skills -g makes all eleven skills globally available. Python 3.9+ and ffmpeg are the only runtime dependencies.
2. Project layout – Each episode is represented by a set of Markdown files (剧本.md, 视觉设定.md, 分镜.md, 图片提示词.md, 视频提示词.md, plus an optional 剪辑单.md). These files are the single source of truth; the system never uses a separate database.
3. Skill flow –
   • short‑drama‑novel‑analyze samples a source novel and decides if it’s worth adapting.
   • short‑drama‑develop slices a long work into episode‑level maps.
   • short‑drama‑write creates the episode script.
   • short‑drama‑assets extracts characters, locations, props, and continuity locks.
   • short‑drama‑image‑prompts writes prompt strings for image‑generation models.
   • short‑drama‑storyboard produces a shot list with camera moves and “frozen key‑frames”.
   • short‑drama‑video‑prompts converts each shot into a video‑generation prompt (including timing, dialogue, and reference images).
   • short‑drama‑produce shows a preview of all media tasks; after explicit user confirmation it calls external adapters (e.g., MiniMax H3, Seedance) to generate images, video, TTS, or music.
   • short‑drama‑edit assembles the generated assets into a final video using ffmpeg, writing a detailed edit‑decision log.
   • short‑drama‑review runs a final consistency and rights check.
4. Validation – A helper script (creator_markdown_check.py) cross‑checks the five Markdown files for missing references or mismatched durations, reporting human‑readable errors rather than aborting.
5. Dashboard – A lightweight local UI (/short‑drama dashboard) visualises the episode’s timeline, shot colors, and progress.

Who it’s for

• Screenwriters and comic‑drama studios that want to prototype or fully produce short, vertical‑format videos (e.g., TikTok/YouTube Shorts).
• Creative teams already using AI agents (Claude Code, Codex, or any environment that supports the Agent‑Skill spec).
• Anyone needing a reproducible, file‑based workflow where every creative decision is captured in plain Markdown.

What you get out of the box

• Eleven ready‑to‑use skills covering the entire short‑drama pipeline.
• Example projects (e.g., the EP001 of 让你管账号) showing the full set of Markdown files and the resulting video.
• Automated consistency checks and a clear “confirm‑before‑spend” gate for any costly media generation.
• Export tools to bundle all episode assets and documentation for delivery.

Getting started in a nutshell

# Install the skill set (global)
npx skills add zenstory-ai/drama-skills -g
# Initialise a new vertical‑format short‑drama project
$short-drama init "都市打脸" --ratio 9:16
# Write the first episode script
$short-drama-write "第 1 集：外卖员在高档餐厅被经理羞辱…"
# Extract assets, generate image prompts, storyboard, and video prompts
$short-drama-assets …
$short-drama-image-prompts …
$short-drama-storyboard …
$short-drama-video-prompts …
# Preview and confirm generation
$short-drama-produce
# Edit the produced clips into a final video
$short-drama-edit
# Run the final review
$short-drama-review

All steps produce or update the corresponding Markdown files, which you can edit manually before confirming the next stage.

---

Bottom line: Drama Skills is a concrete, agent‑driven toolkit that turns story ideas into finished short‑drama videos, with every creative artifact stored as human‑readable Markdown and with safety checks that keep you in control of AI‑generated media costs.