write-screenplay-skill
egguy886/write-screenplay-skill
write-screenplay-skill is an agent skill project by egguy886 on GitHub: Turns novels or settings into commercial scripts, with two modes: domestic short drama and micro-drama for overseas audiences. It covers adaptation and script. 6 stars, last updated 2026-09-06, MIT license.
Editor's notes
Overseas mode uses English character names and English dialogue while keeping sluglines and action lines in Chinese, with Chinese subtext after every line; domestic mode is all Chinese. Adaptation runs in four steps, first stripping the novel's unfilmable inner monologue and omniscient narration, then turning emotions into actions an actor can play. Output must pass 6 gates; the action-decoupling gate allows at most 2 compound actions per action line, aimed at limb melting in video generation. scripts/install.py symlinks the skill into the directories of Claude Code, Codex, Antigravity and others; the docs are in Chinese and no API key is needed.
- Type
- Screenwriting: scripts · adaptation · review
- Stages
- Adaptation · Script
- Format
- Agent skill
- Language
- Chinese
- GitHub stars
- ★ 6
- Last updated
- 2026-09-06
- License
- MIT
- SKILL.md files
- 1
- Checked by hand
- 2026-10-13
In the author's words
Write-screenplay skill: translates a novel or related setting into a professional commercial script (dual mode: domestic short drama / overseas micro-drama). Works across major agent platforms, with action decoupling for AI video models.
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.
- write-screenplay
Write-screenplay skill: translates a novel or related setting into a professional-grade script in one click (micro-drama, film/TV, manju). Supports two modes, "domestic Chinese script" and "overseas short drama script (English character names + Chinese action + English dialogue)". Deeply adapted to mainstream platforms (AI agent platforms: Claude Code, Codex, Antigravity, Grok, Doubao; distribution platforms: Douyin, Kuaishou, ReelShort, DramaBox, ShortMax, TikTok). Built-in "AI-video-friendly action decoupling" addresses the core problem of stacked complex actions making later video generation melt and deform. Trigger words: "/写剧本" (slash command), "write a screenplay", "novel to script", "adapt into a script", "overseas script", "short drama script", "screenwriting", "screenplay", "novel-to-script".
Install
npx skills add egguy886/write-screenplay-skill
# pick agents (claude-code / codex / cursor / opencode / gemini-cli / openclaw)
npx skills add egguy886/write-screenplay-skill -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
- short-drama-factory★ 387
Industrial short-drama writing for Douyin/Hongguo: a one-line idea or a web novel → a 60–100 episode script with paywall points, plus hook, cliffhanger and twist formulas and machine-check rules
Emma short-drama skill set: structure teardown, adaptation, topic iteration, expectation design, per-episode hooks, episode outline expansion, dialogue diagnosis, script cuts
Short drama / manju screenwriting: Save the Cat methodology plus analysis of 31 hit short dramas
- gushi-skill★ 5
Short-drama screenwriting method distilled from Robert McKee's Story
Hit short-drama screenwriting for Hongguo/Douyin: the short-drama-factory engine plus the methodology of "Short Drama Writing Lesson 1" issues 01–10