Settle the story and its handoffs before generating media.
Shuohao Skills
Drama Planning and Character References
Seven independent skills turn a novel into an outline, design bibles, screenplay, opening staging and storyboard packs, with a separate backend for character images.

Choose the host and stage
- Agents that read SKILL.md and run Node
- Author installer: Codex / Claude Code
- Character images: configured backend
- GitHub stars
- 5,731
- Version
- 2.1.0
- Checked
- Categories
- Design & VideoWriting & Research
Finish one small outline first
Start with a complete short story and a six-episode, two-minute brief. Review the skeleton and report before passing approved files downstream. Image and video services are unnecessary for this first step.
Pick a task and get started
The first command installs only novel-outline and pins the reviewed commit. Run the other tasks' add-on commands from the same repository root. For Claude Code, replace --codex with --claude.
Start with a short story you can use, approve the structural choices, then expand the episodes.
Link the outline skill into Codex
Clone into a new directory and pin this review's commit. The command links only novel-outline into user-level ~/.codex/skills; --claude targets ~/.claude/skills. This is not project-scoped. Existing real directories are skipped and same-name symlinks replaced; inspect the output. The installer does not install Node, a host or models.
Read the author’s setup guidegit clone https://github.com/eternityspring/shuohao-skills.git cd shuohao-skills git checkout --detach 5612d2a0bd5f19d978c3ee19d1e42840335e3b4b ./scripts/install.sh novel-outline --codexPrepare the text and load the Skill explicitly
Keep the checkout in a stable location: the installed link points into it. Check your Node.js version, then prepare inputs/story.txt and inputs/brief.md at the repository root. Specify 6 episodes, 2 minutes each, suspense, the 抽核 adaptation mode and required moments. Reopen or refresh the host's skill list and confirm it can read novel-outline/SKILL.md, scripts and references. Send “Plan the adaptation.” After the complete outline exists and is approved, use the commands below from the repository root to check it and rebuild the English-interface report; these commands do not write the outline for you.
Installer and scopenode skills/novel-outline/scripts/novel-outline.mjs validate demo/outline/outline.json node skills/novel-outline/scripts/novel-outline.mjs render demo/outline/outline.json --html --lang en > demo/outline/outline-report.htmlGive your AI this first task
These five tasks are editorial examples. Replace paths, episode counts and genre with your own project. Deliverables are acceptance targets; this site did not run adaptation, image generation or video production.
Use novel-outline. Read the complete Chinese short story at inputs/story.txt and inputs/brief.md. Plan a suspense adaptation of 6 episodes at 2 minutes each, using the schema value 抽核 for adaptMode, and write to demo/outline/. Preserve the moments explicitly required in the brief; separate inference from source evidence. First create the outline.json skeleton and run validate --stage beats. Show the removed subplots, merged characters and major payoff episodes, then stop for my approval. After approval, complete all 6 narrative synopses, opening hooks, closing suspense and narrative-prop references. Run full validate, resolve problems, and deliver outline.json, outline.md and outline-report.html with --lang en for the report UI. Report failed or skipped checks. If chunking truncates the source, state what was not covered instead of claiming a full-book reading.
Check what you receive
- The first handoff is the skeleton and three adaptation decisions. Only after approval comes the complete outline package, with its asset inventory calculated by the script.
- Check that all 6 episodes are present, IDs are consistent, and key decisions match the source. The 14 rule checks cannot assess whether the adaptation tells a good story.
- For an existing outline, first map it to the author's outline.json schema, then use checkup and the HTML report for diagnosis. List missing fields without silently rewriting the story.
More about this skill
Shuohao Skills organizes the preparation work for AI short dramas. The repository currently contains seven self-contained skills: six stages for outlines, characters, art, screenplays, opening staging and storyboards, plus standalone character-refs. Decisions become JSON with linked character, scene, prop and beat IDs, making them easier to inspect and revise. You can begin with a novel or continue from existing files that follow the relevant schemas.
The Agent reads the source and makes creative decisions; Node.js scripts seed structures, calculate inventories and timing, check references and render reports. The outline pauses for approval of cuts, character merges and major payoffs. Cast, art and screenplay can then evolve together. Opening staging locates people beside specific objects before the storyboard assigns the screenplay's beats to generation segments and cuts.
Those six stages deliver data and prompts. Images displayed in a character, art or storyboard report must have been supplied downstream; their presence does not mean that Skill generated them. character-refs does call a configured image backend, deriving views from an approved front full-body anchor. Video generation, speech and final editing require separate tools.
Sources and verification
Sources checked
Reviewed both root READMEs, all seven main SKILL files, task references and the author's intake example at a fixed commit, with static inspection of key commands and implementation. No installer, upstream script, model, report render or browser was run. Author examples and test claims are not tests performed by this site.