story-import (Reverse-Import an Existing Novel)
Turns a novel you've already written (partial or complete) into a fully structured, resumable Claude Code writing project.
Content & WritingIntermediate★ 6,166⑂ 916AI score 8/10Last updated: Aug 27, 2026
What it does
- Accepts a single file, a directory of chapters, or pasted text; auto-detects long-form vs. short-form and routes accordingly.
- Drives the full
story-long-analyze/story-short-analyzebreakdown pipeline to produce an analysis library (拆文库/{book}/) with characters, plotlines, pacing, emotion modules, world-building and prose style. - Migrates that analysis into a writable project: settings, outlines, normalized chapter files (
第001章_...), and a tracking layer. - Initializes continuity tracking through
scripts/tracking_commit.py init(character snapshots, foreshadowing, author-truth vs. reader-known timelines, next-chapter promises), then verifies withcheck. - Marks any field it can't evidence from the source as
[待补充]instead of inventing plot.
Who it's for
- Web-novel authors (Qidian / Fanqie / Jinjiang style) with an in-progress manuscript who want AI to continue it.
- Writers whose settings, foreshadowing and character states have drifted out of sync across dozens or hundreds of chapters.
- Existing users of the oh-story-claudecode suite who have already run
/story-setup.
Examples
- "Import my novel at ./mybook.txt" → detected as long-form, full Stage 0-6 breakdown, project scaffold created, then
/story-long-write 日更continues from chapter N+1. - An 8k-character short story → short-form branch produces only
正文.md,设定.mdand小节大纲.md, explicitly avoiding long-form-only folders. - A legacy v0.7.2 project missing
追踪/_tracking-state.json→ runs the tracking-only migration path instead of re-analyzing the whole book.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/zenstory-ai/oh-story-claudecode/HEAD/skills/story-import/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/story-import folder from the GitHub repo zenstory-ai/oh-story-claudecode into my ~/.claude/skills/story-import/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/zenstory-ai/oh-story-claudecode.git && mkdir -p ~/.claude/skills && cp -r oh-story-claudecode/skills/* ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and go to the folder where you keep tools.
- Clone the repo:
git clone https://github.com/zenstory-ai/oh-story-claudecode.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy every skill over (this one depends on its sibling story-* skills):
cp -r oh-story-claudecode/skills/* ~/.claude/skills/ - Verify Python 3 is available (
python3 --version) — the tracking scripts require it. - Restart Claude Code, open your novel's project folder, and run
/story-setupfirst to deploy hooks and agents. - Start a fresh session, run
/story-import, and give it the path to your manuscript. - When the import report appears, continue with
/story-long-write 日更(long-form) or/story-short-write(short-form).
View source on GitHub ↗License: MIT