novel-diag

Diagnose novel-studio project outputs across process, quality, planning, and context dimensions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running AI novel-writing pipelines can silently stall, drift from the outline, or lose character continuity, and the evidence is buried in local output artifacts. This Skill statically analyzes a project's output directory and surfaces actionable findings instead of forcing you to inspect pipeline state files by hand. ## Core Features & Use Cases - Four-Dimension Diagnosis: Checks process (rewrite loops, unconsumed steering directives, chapter gaps), quality (review scores, contract fulfillment, rewrite rates), planning (stalled foreshadowing, outdated compass, exhausted outline), and context (disappearing characters, timeline gaps, stale relationship data). - Pipeline Evidence Verification: Read-only inspection of meta/pipeline.json flags completed stages missing evidence, unverified evidence states, or missing artifacts and checkpoints. - Sanitized Issue Export: Writes meta/diag-export.md with story content removed, leaving only a behavioral skeleton suitable for pasting into a GitHub issue. - Use Case: Your serial novel project feels stuck after chapter 40. Run the diagnostic to discover an unconsumed steering directive and a foreshadowing thread that has not advanced in ten chapters, then attach the sanitized report to a bug report. ## Quick Start Run the novel-studio diagnostic on my current project and tell me why the pipeline is stuck.

Frequently Asked Questions about novel-diag

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

FAQPage Schema
How do I diagnose why my novel-studio project is stuck?

Run novel-studio --diag from the project directory containing output/novel. The diagnostic prints local findings across process, quality, planning, and context dimensions, identifying issues like rewrite loops, unconsumed steering directives, or stalled foreshadowing.

What does the novel-studio diagnostic report check?

It checks four dimensions: process anomalies such as chapter gaps and pipeline evidence drift, quality metrics like review scores and rewrite rates, planning health like outline exhaustion and missing summaries, and context issues like disappearing characters or timeline gaps.

Can I share the diagnostic output in a GitHub issue?

The terminal report may contain plot and foreshadowing details, so do not paste it directly. Use the generated meta/diag-export.md instead, which is sanitized to remove story content and keeps only the behavioral skeleton.

Does the diagnostic modify or rerun my pipeline?

No. The diagnostic is read-only. It inspects meta/pipeline.json and reports missing evidence, unverified evidence states, or missing artifacts and checkpoints, but never clears stage markers or reruns the pipeline.

What are the prerequisites for running the novel diagnostic?

You must have completed the initial novel-studio configuration and run the command inside a project directory that contains an output/novel folder with pipeline state files.