story-long-write skill for Claude: plan and write long web novels

Guides your agent through planning and writing a long web novel, from settings and outlines to chapters and a story-tracking file. For Chinese web novelists.

Installs: 17.8K; on skills.sh
Stars: 8.2K; on GitHub
Files: 60+; besides SKILL.md
Updated: Nov 2026; last repo commit

story-long-write makes your agent act as a web-novel writing coach. It can only discuss structure, write an outline, make chapter outlines, write a named chapter, continue a daily serial, or revise old chapters. Everything is saved as project files, with a tracking file that keeps characters, foreshadowing and timeline consistent.

It loads on /story-long-write or phrases like starting a book, writing an outline, writing chapter N or continuing. The SKILL.md is in Chinese. Called with no request it only lists options and does not start writing. It runs Python and Node scripts for word counts, checks and tracking, so you need Python and Node.js 18 or newer.

Good for

Web novelists planning a long serial from first idea to chapters
Authors who write daily and need continuity across chapters
Writers who want to discuss structure first and draft later

Install story-long-write

Claude Code

Copy this prompt.

Install the story-long-write skill in Claude Code. Run this command:

npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-long-write

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲，明确要求正文后再写章节。触发方式：/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

Sections in SKILL.md

写前必读（强制，先读后写）
作者记忆管理
核心方法
写作流程
裸调用与停靠点（防失控）
面向作者的汇报
路径与术语约定
Phase 1–3：开书与规划
Phase 4：正文写作辅助
流程衔接
参考资料索引

Key facts

Author: zenstory-ai
License: MIT
Installs on skills.sh: 17,842 (Nov 2, 2026)
GitHub stars: 8,223 for the whole repo (Nov 2, 2026)
Last commit: Nov 1, 2026
Files: 90 files including SKILL.md (76 reference files and 13 scripts)
Language: SKILL.md and reports are in Chinese
Part of: oh-story-claudecode, 14 skills for Chinese web fiction
Needs: Python (python3, python or py -3) and Node.js 18+ for the check scripts
Chapter limit: Up to 3 chapters per round; default 1 chapter, daily mode 2 to 3
Skill version: 1.0.0 (frontmatter)

What it includes

Diagnose the project and list options
With no clear request it checks the project and offers choices. It does not start writing chapters on its own.
Read · Bare call
Talk through the story only
Delivers a structure plan without creating files.
Try: “/story-long-write just discuss the structure of my story”
Discuss structure
Setting, volume outline, chapter outlines
Works through direction, setting, volume outline and the first 10 chapter outlines, stopping at each confirmation point. It stops at the outlines and does not write chapters.
Write · Outline planning
Phase 4 to 5 for chapter N only
Reads required reference files first, prepares the prompt with build_writer_prompt.py, writes, checks, and commits the tracking update. Stops after the chapter.
Try: “/story-long-write write chapter 1”
Runs code · Write a named chapter
Continue the serial 2 to 3 chapters at a time
Needs an existing manuscript and tracking files. A single round writes at most 3 chapters.
Runs code · Daily writing
Edit, rework or rewrite chapter N
Follows workflow-revision.md for changes to a chapter that already exists.
Write · Revise a chapter
Word count, chapter check and commit
Measures length, runs the AI-pattern, degeneration and outline-copy checks, then commits the chapter. It deletes that chapter's scratch folder after a successful commit.
Delete · storyctl.py
Update the tracking state
The only writer of 追踪/_tracking-state.json. Context, character snapshots, foreshadowing and timeline files are derived from it, and it removes stale character files.
Delete · tracking_commit.py
Remember your writing habits when asked
author_memory_commit.py stores and queries long-term preferences. Planning mode does not record memory unless you ask.
Runs code · Author memory

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

It creates and edits many project files
It writes settings, outlines, chapters and tracking files in your book folder, and keeps tracking files in sync. Keep the book in git or back it up first. github.com
Scripts delete files in your project
After a successful chapter commit, storyctl.py deletes that chapter's scratch folder (.story/work/第NNN章/), and tracking_commit.py deletes character-state files in 追踪/角色状态/ that it no longer expects. Do not keep your own notes in those folders. github.com
Companion story-setup deploys hooks and agents
story-long-write itself bundles no hooks or agents. The README's /story-setup is a separate skill that deploys hooks, agents and a managed block in CLAUDE.md or AGENTS.md into your project, and the README says hooks can block writing prose when outlines or tracking are missing. Without it SKILL.md falls back to writing in the main session. Read its deployment report before approving. github.com
It stores your writing habits when asked
The author-memory script keeps preferences in two places: a .story/作者记忆/ folder in the workspace (global, genre and workflow entries) and one in the book folder (book-only entries). Planning mode records nothing unless you ask. Review or delete those folders if you do not want them kept. github.com
Needs Python and Node scripts to run
Chapter checks need Python and Node.js 18 or newer, and the agent runs them on your files. Approve commands you do not recognise. github.com

Technical details

Turning on read-only	Ask to discuss structure only. The SKILL.md says that mode creates no project files.
Sign-in and keys	No credentials are described in SKILL.md. The README says only story-cover (a different skill) calls an image service.

Questions

What does story-long-write do?

It guides your agent through planning and writing a long Chinese web novel: structure talks, settings, volume and chapter outlines, chapters, daily continuation and revisions. Progress and continuity are saved in project files.

How do I install it in Claude Code, the Claude app or Codex?

Use the install box above. The README documents npx skills add for the whole oh-story set, lists Claude Code and Codex CLI as supported, and does not document a Claude app upload. The README says to run /story-setup in the writing project after installing the whole set (Codex uses $story-setup), then start a new session.

Does it write chapters when I first open it?

No. Called with no request it only diagnoses the project and lists options. It writes chapter text only when you ask for chapters, and a round is capped at 3.

Does it need an API key?

The SKILL.md lists none. It runs on your agent's model and uses local Python and Node scripts. In the README only story-cover, a different skill, calls an image service.

Is it safe to install?

It creates and edits many project files and runs Python and Node scripts that count words, check text and update tracking. After a successful commit one script deletes that chapter's scratch folder, and another deletes stale character-state files. Use git or a backup copy of the book folder. The optional /story-setup skill adds hooks and agents to the project, so read its report before approving.

Which other oh-story skills does it use?

It points to story-deslop for removing AI flavor, and to story-long-analyze, story-long-scan and story-short-write for analysis, market scans and short stories. None is required. It uses a narrative-writer agent only if /story-setup has deployed one, and writes the chapter itself otherwise.

Does it work for English novels?

The skill and its rules are written for Chinese web fiction platforms. The README does not say it supports English, so test it before starting a book.

Information

updated Nov 2, 2026

Repository: zenstory-ai/oh-story-claudecode
Folder: skills/story-long-write

zenstory-ai/oh-story-claudecode skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

story-long-write SKILL.md · github.com
oh-story-claudecode README · github.com
story-long-write workflow-chapter.md · github.com
story-setup SKILL.md · github.com
tracking_commit.py · github.com
storyctl.py · github.com