story-setup Skill: Deploy the oh-story Writing Setup Into Your Project

Sets up your writing folder for the oh-story novel skills by copying in hooks, helper agents and rules for the coding agent you use.

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

Run /story-setup (or $story-setup in Codex) in the folder that holds your book. It detects the agent you are in, asks when it cannot tell, and deploys the files for it. Then start a new session so the helper agents load.

This changes your project. For Claude Code it writes CLAUDE.md, .claude/hooks, .claude/rules, .claude/agents and merges hooks into .claude/settings.local.json, then runs a Python helper to do the merge. Your own settings and books are kept. Use check to only diagnose.

Good for

Chinese web novel authors who draft with a coding agent
Writers working on Qidian, Fanqie, Jinjiang, Qimao or Zhihu Yanxuan
Anyone who finished installing oh-story and sees no helper agents or hooks

Install story-setup

Claude Code

Copy this prompt.

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

npx skills add zenstory-ai/oh-story-claudecode -y -g

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.

This installs the whole oh-story set of 14 skills, as the README says. Then open your writing folder, run /story-setup, and start a new session so the helper agents load. Drop -g to install into the current folder only.

From the project README. Source.

What's in the skill

When it loads

网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。

Sections in SKILL.md

选择模式
Phase 1：判断宿主与项目
Phase 2：部署基础设施
Step 1：按宿主部署
Step 2：创建部署标记
Phase 3：验证安装
模板占位符
项目指令合并（CLAUDE.md / AGENTS.md）
参考资料
流程衔接

Key facts

Author: zenstory-ai
License: MIT (README badge)
Installs on skills.sh: 16,760 (Nov 2, 2026)
GitHub stars: 8,223 (Nov 2, 2026), whole repo
Files: 182 files including SKILL.md
Last commit: Nov 1, 2026 (repo)
Skill version: 1.3.6 in the frontmatter
Hosts supported: Claude Code, OpenCode, Codex, Google Antigravity, ZCode, OpenClaw, Reasonix, plus a generic file mode
Language: SKILL.md is in Chinese

What it includes

Detects the host, confirms the project root and deploys
Checks for an earlier .story-deployed marker, finds the agent you use, and copies the managed files. Existing user config is kept.
Runs code · /story-setup
Diagnoses the setup without deploying
Reads references/diagnostics.md and reports problems such as missing helper agents.
Files · /story-setup check
Writes CLAUDE.md, hooks, rules, agents and settings
Copies 8 hook script templates and a Node hook core to .claude/hooks, rules to .claude/rules, 7 agent files to .claude/agents, and merges hook registrations into .claude/settings.local.json.
Runs code · Claude Code deploy
Runs merge-claude-settings.py
Replaces known oh-story hook registrations, keeps your own hooks and top-level fields, and re-runs to check the result is the same.
Runs code · Settings merge
Runs copy-path-safety.py before each copy
Skips the copy when source and target are the same, and stops if the target sits inside the source.
Runs code · Copy safety check
Writes .story-deployed
Records agents_version, target_cli and setup version so the next run can tell what is deployed.
Write · Sentinel file

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 installs hooks that run scripts in your project
Hooks fire on session start, before prose writes, after Write or Edit of prose files and on commit validation, per deploy-claude-code.md. Read .claude/settings.local.json after the first run and remove what you do not want. github.com
It edits CLAUDE.md and settings files
The edits are merge-based and keep your own text, but back up CLAUDE.md and .claude/settings.local.json first. github.com
It runs bundled Python helpers
Needs a Python interpreter; it stops if none is found rather than merging by hand. github.com
It deletes leftover nested folders and replaces managed folders
Before deploying, SKILL.md says to delete nested agent-references folders it finds under .claude, .codex or .zcode skills/story-setup and under skills/story-setup, and to list the deleted paths in the report. The hooks, rules and the 7 oh-story agent files are replaced on every run. github.com

Technical details

Turning on read-only	Run /story-setup check to diagnose without deploying.

Questions

What does story-setup do?

It deploys the oh-story infrastructure into the folder where you write: hooks, seven helper agents, rules and project instructions for your coding agent. Without it, the writing skills run without the guards and helper agents.

How do I install it?

Use the install box above, which installs the whole 14-skill set. Then run /story-setup in your writing folder, not in the skill's own folder, and open a new session.

Which files does it change in Claude Code?

Per deploy-claude-code.md it writes CLAUDE.md (a managed block), .claude/hooks, .claude/rules, .claude/agents, .claude/settings.local.json, .story-deployed and an empty .claude/.agents-pending-restart marker. It copies reference files into .claude/skills/story-setup/references/agent-references. It keeps your own hooks and top-level settings.

Why do I need a new session afterwards?

Helper agents are only registered when a session starts. The skill tells you to start a new one.

Can I update an existing setup?

Yes. Update the skill package first, then re-run /story-setup. It does not downgrade: if the project has a newer agents version than the skill, it stops.

Is it safe?

It writes hook scripts that run shell commands in your project and merges registrations into .claude/settings.local.json. SKILL.md says it keeps your own hooks and settings and that rerunning gives the same result. It replaces the managed .claude/hooks folder, the 7 oh-story agent files and the oh-story rule files, and deletes leftover nested story-setup reference folders it finds before deploying. Our advice: commit or copy the project first so you can diff what changed.

Does it work in Codex?

Yes. The skill has a Codex path, and in Codex you call it as $story-setup.

Information

updated Nov 2, 2026

Repository: zenstory-ai/oh-story-claudecode
Folder: skills/story-setup

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

Sources

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

Show all 3

oh-story-claudecode README · github.com
story-setup SKILL.md · github.com
story-setup deploy-claude-code.md · github.com