qiyan233/novelops-skill

Current Version: 1.1.0

A Agent Application Long Novel Workflow Skill. It combines long novels, serializations, web novels, and fan writing Run into a long-term maintainable process—the focus is not on “writing one chapter at a time,” but on ensuring that by chapter 50, the settings are stable and the state is traceable.

The underlying layer is a pure Python 3 CLI plus plain text status files, without binding specific hosts: OpenClaw, Claude Code, Agents within the IDE and terminals can drive it; see its use in different agent applications for details.

Inspiration reference InkOS: . This project is inspired by the skill skeleton, Not an official port of the original project.

Chinese | English

---

What problems does it solve?

The real difficulty in long-form writing isn’t “not being able to write the next chapter,” but remembering who learned what in chapter 3 by the time you reach chapter 50. This warehouse breaks down the matter into executable processes:

• truth files Maintain worldview, current situations, and character cognitive boundaries
• write-next Organize “What to write in the next chapter, what to avoid” into a structured work package
• draft Drafted by LLM (Hermes priority, default local Ollama)
• revise / auto-revise Auditing and revision closed loop
• extract-state / state-update Write the newly occurred fact back to the state
• snapshot / diff Revert and compare at any time

It is not just responsible for “writing,” but organizing multiple chapters of writing.

Who is it for?

Suitable for:

• If you want to write a novel long-term, multi-chapter, and retrospective, you need to maintain chapter summaries, character status, foreshadowing, and current situations
• Want to build a novel writing skill similar to InkOS
• I hope that beyond writing, there will be audits, revisions, status updates, snapshots, and other steps

Not very suitable: I just want to create a short article on the spot. This repository will be noticeably heavy.

Get Started Quickly

Requires Python 3, no third-party dependencies.

Windows / No Bash Environment Please use python scripts/novelops_cli.py ...; scripts/*.sh is a legacy entry point and requires bash. All features have equivalent Python commands.

For more detailed steps, see Installation & Environment and Quick Hands-On Practice.

Core Main Storyline

draft Can be written by a human or agent, or directly handed over to the LLM; revise Threaded internally knowledge-check / audit / revision-plan / spot-fixes。 For command details, see the CLI entry.

Current Capabilities

Already covered:

• Next Chapter Preparation (write-next, including chapter contracts and scene beats)