novel-main

Orchestrates a 7-step state machine for Chinese web novel chapter generation.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/cwjdong-design/novel --skill novel-main-cwjdong-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: novel-main
Source: https://github.com/cwjdong-design/novel/tree/main/novel-main
Command: npx skills add https://github.com/cwjdong-design/novel --skill novel-main-cwjdong-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing serialized web novels with AI often produces inconsistent plots, hallucinated place names, broken system panels, and pacing decay across chapters. This Skill coordinates the full chapter production pipeline so each chapter is generated, reviewed, polished, tracked, and backed up under strict quality gates. ## Core Features & Use Cases - 7-8 Step State Machine: Runs PREP, PLOT, DRAFT, REVIEW, POLISH, TRACK, MILESTONE (every 5th chapter), and BACKUP with interrupt recovery via progress JSON files. - Skeleton-Mode Drafting: Generates a pre-validated chapter skeleton, then delegates prose writing to a sub-agent that cannot alter numbers, place names, or system panels. - Multi-Layer Quality Gates: Enforces cross-chapter pacing gates, banned-word scans, consistency checks, milestone reviews every 5 chapters, and a REVIEW-POLISH retry loop capped at 3 cycles. - Use Case: A web novel author says "write chapter 12" and the system loads the book's configuration, checks pacing of recent chapters, drafts via skeleton mode, scans for banned words and real place names, polishes, updates foreshadowing trackers, and backs up the chapter automatically. ## Quick Start Tell the assistant "write chapter X of my novel" after setting up a book directory with a chapter plan and book configuration file.

Frequently Asked Questions about novel-main

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

FAQPage Schema
How do I generate a web novel chapter with this workflow?

Say "write chapter X" or "continue next chapter" after selecting an active book. The skill runs a 7-step state machine: prep, plot, draft, review, polish, track, and backup, producing a finished chapter with a completion report.

How does skeleton-mode drafting reduce AI hallucination in novels?

The main agent writes a chapter skeleton containing all numbers, place names, and system panels, then pre-scans it for banned content. A delegated sub-agent only writes prose around the skeleton and is forbidden from changing any structural data.

What happens if chapter generation is interrupted mid-process?

Progress is saved to a JSON state file after every step. On the next invocation, the skill detects the unfinished state and asks whether to resume from the breakpoint, so no completed steps are repeated.

Why is my new chapter blocked by a milestone review?

Every 5th chapter triggers a milestone review checking coherence, foreshadowing, character arcs, and timeline consistency. If a blocking issue is found, the state machine halts and you must fix the flagged chapters before starting new ones.

Can I manage multiple novels at the same time?

Yes. Each book has its own directory with independent settings, outlines, and progress files. Say "switch to book X and write chapter Y" to change the active book recorded in the state file.

What are the word count and dialogue requirements per chapter?

Chapters target 2000-2800 characters with a 2350-character goal and at least 38% dialogue. Chapters failing these thresholds are sent back for expansion rather than padded with environment description.