novel-write

Runs a recoverable novel-studio pipeline that writes, reviews, rewrites, and exports novel chapters from a single prompt.

116|21|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/Xiaoyangy/novel-studio --skill novel-write-xiaoyangy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: novel-write
Source: https://github.com/Xiaoyangy/novel-studio/tree/main/skills/novel-write
Command: npx skills add https://github.com/Xiaoyangy/novel-studio --skill novel-write-xiaoyangy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a one-sentence creative brief into finished novel chapters normally requires manually coordinating drafting, review, rewriting, and export across long sessions that lose context. This Skill hands the requirement to the novel-studio pipeline so chapters are produced unattended, with checkpoints that survive interruptions and context compaction. ## Core Features & Use Cases - End-to-end pipeline execution: Pass a prompt via --prompt, --prompt-file, or stdin and the pipeline runs write, review, rewrite, and deliver stages without a TTY, suitable for CI or remote agents. - Recoverable long-running generation: Execution state is persisted to .skill-context/novel-write.md and outputs land in output/novel/, so interrupted runs resume from checkpoints instead of restarting. - Structured creative assets: Produces chapters in output/novel/chapters/*.md plus world data, resource ledgers, writing assets, and RAG retrieval traces for auditability. - Use Case: A web-novel author provides "write a cyberpunk opening arc with an augmented hacker protagonist" and receives reviewed, rewritten chapters with a consistent world state, without babysitting the session. ## Quick Start Ask the AI to run the novel-studio pipeline with your creative requirement, for example: write a long-form opening about a cyberpunk hacker protagonist and export the reviewed chapters.

Frequently Asked Questions about novel-write

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a novel from a single prompt with novel-studio?

Run novel-studio with the --pipeline flag and pass your requirement via --prompt for inline text or --prompt-file for longer briefs, using a dash to read from stdin. The pipeline executes write, review, rewrite, and deliver stages automatically.

Can I run novel generation headlessly in CI or a remote agent?

Yes, the pipeline mode has no TTY requirement and runs unattended in CI or remote agents. However, first-time configuration must be completed once in an interactive terminal before headless runs work.

What output files does the novel writing pipeline produce?

Chapters are written to output/novel/chapters as Markdown files. Additional artifacts include writing assets, a book world JSON, a resource ledger, RAG retrieval traces, and a headless.log run log in the project directory.

Why does novel-studio fail with a first-run configuration error?

Headless mode cannot perform the initial setup wizard. Run novel-studio once in an interactive terminal to complete stdin-based configuration, or manually create the config file at ~/.novel-studio/config.json.

What happens if a long novel generation run is interrupted?

The pipeline uses checkpoints, leases, and idempotent recovery, so interrupted runs resume instead of restarting. Execution state is also recorded in .skill-context/novel-write.md to restore stage, paths, and next steps after context compaction.