webnovel-doctor

Diagnoses webnovel project directories, JSON, SQLite, RAG config, and Dashboard build artifacts read-only.

6.9k|1.2k|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/lingfengQAQ/webnovel-writer --skill webnovel-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webnovel-doctor
Source: https://github.com/lingfengQAQ/webnovel-writer/tree/main/webnovel-writer/skills/webnovel-doctor
Command: npx skills add https://github.com/lingfengQAQ/webnovel-writer --skill webnovel-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running webnovel projects accumulate many files, databases, and configs across phases; when something breaks it is hard to know which directory, JSON file, SQLite table, RAG setting, Python dependency, or Dashboard build artifact is missing. This Skill performs a read-only health check so you can see exactly what is incomplete without risking any changes to your book project.

Core Features & Use Cases

  • Phase-aware diagnosis: Reads the project's current phase via project-status, then checks only what that stage should have, so a freshly initialized project is not judged by the standards of a 200-chapter one.
  • Full-stack integrity check: Verifies directories, files, JSON state, SQLite databases, RAG configuration, Python dependencies, and Dashboard build output in one pass.
  • Actionable reporting: Reports the current phase and target chapter, blockers, missing or abnormal file paths, and the impact plus suggested fix for each issue.
  • Use Case: After moving your novel project to a new machine, run a deep check with --deep to confirm the SQLite state, RAG index config, and Dashboard build artifacts all survived the migration before writing the next chapter.

Quick Start

Ask the assistant to run a read-only health check on the current webnovel project and report any missing files, configuration, or dependencies.

Frequently Asked Questions about webnovel-doctor

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

FAQPage Schema
How do I check if my webnovel project setup is complete?

Run the doctor command, which performs a phase-aware read-only check of directories, files, JSON, SQLite, RAG config, Python dependencies, and Dashboard build artifacts. It reports each missing or abnormal item with its impact and a suggested fix.

What does a read-only project diagnostic tool check?

It verifies that the directories, state files, databases, retrieval configuration, and build artifacts expected for the project's current phase all exist and are intact. Read-only means it never writes project files, installs dependencies, or auto-repairs anything.

Can I run a deeper diagnostic on a specific chapter?

Yes. Pass --chapter with a chapter number to target the check at that chapter, and add --deep for a more thorough inspection beyond the standard health check.

Does the diagnostic modify or repair my project files?

No. The check is strictly read-only: it does not write project files, install dependencies, start the Dashboard, or apply fixes. It only reports issues along with recommended repair actions for you to perform separately.

Why does the diagnostic report different missing items than expected?

The check is phase-aware: it first reads the project's current phase via project-status, then only validates what that stage should have. A project that just finished initialization is not checked against the expectations of one with many written chapters.