Novel & Story Project Importer Agent Skill

Reverse-engineers existing fiction into standardized project structures for seamless AI-assisted writing and continuation.

Context cost
17.3k tokensestimated from the bundle, loaded when it triggers
Bundle
7 files · 69.3 kBtext throughout, nothing executable
Licence
MITthe author’s own terms
Last change
—v1.0.0
Servers it uses
Noneruns standalone

What it does

逆向导入已有小说。将已写好的小说(半成品或完本)反向解析为标准项目目录结构,兼容 story-long-write / story-short-write 后续写作流程;内部复用 story-long-analyze / story-short-analyze 的拆解管道,按篇幅自动分流。触发方式:/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。

What this skill changes about the agent has not been set out here as a list. Its SKILL.md, shown below, says it in the author’s own words.

contentwriting

The skill itself

A skill is instructions the model reads, so you can see what you are getting: below is the start of its SKILL.md. The front matter loads with every session, the body loads when the skill triggers, and the whole file comes with the install.

SKILL.md12.3 kB · preview
--- name: story-import version: 1.0.0 metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}} ---
7# story-import:逆向导入已有小说
8
9你是小说项目逆向工程师。**交付物是写作工程**:把作者已有的书重建为可续写的工程(项目结构 + 拆文库分析资产),让作者能直接接着写。拆文库/{导入书名}/ 是重建工程的数据源,保留不丢弃,但不是交付物本身;对作者以「建工程」为可见目标,别把「拆文」当成终点或对外标签。
10
11> Agent 兼容性:只检查当前运行时的 canonical 目录:Claude .claude/agents/{agent}.md、OpenCode .opencode/agents/{agent}.md、Codex .codex/agents/{agent}.toml、Antigravity .agents/agents/agent-name/agent.md(agent-name 为目标 agent 名),不得因其他端文件存在而误判。Codex 使用同名 agent_type;Antigravity 使用 invoke_subagent + TypeName。对应运行时未暴露 custom-agent registry / invoke_subagent 或返回未知 agent 时,必须降级 solo/direct。检测到 .zcode/ 时同样直接 solo/direct,因为 ZCode 3.3.4 不执行项目 custom agents;报告 Fallback: project custom agents unavailable -> solo。Claude 用 subagent_type;OpenCode 用 subagent 工具的 agent 参数。
12>
13> Spawn 版本提示(不阻断 spawn):先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 34 不一致时(标记缺失、字段缺失/非整数、小于或大于 34)**照常按文件存在性检查并 spawn**,同时报告 Notice: agents bundle 版本不匹配(项目 {N},本版 34) 并提示重新运行 /story-setup 后新开会话;大于 34 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct,报告 Fallback: ... -> solo。
14
15## 名词与目录边界(全流程硬约束)
16
17- {导入书名}:用户自己已经写到一半或已经完本、现在要重建为工程的小说;它的分析源固定为 拆文库/{导入书名}/。
18- {对标书名}:用户另行选择的外部参考作品;它必须是独立拆解产物,来源固定为 拆文库/{对标书名}/,且不得指向本次导入源。
19- story-import 可以复用拆解管道分析 {导入书名},但**不得把 {导入书名} 登记为主/副对标,不得把 拆文库/{导入书名}/ 或项目 设定/ 复制进 对标/**。
20- 用户没有明确选择外部对标时,不创建对标子目录、不写 主对标书;后续由 story-long-write / story-short-write 的对标发现流程单独处理。
21
22先分析后迁移:深度分析复用现成管道(长篇 /story-long-analyze,短篇 /story-short-analyze),方法、模板与质量检查由 analyze skill 自带,本 skill 不另维护;再把分析结果迁移为项目结构。
23
24## 时刻表与交接
25
26导入是一串时刻,每个时刻只读自己的文件;后一时刻只靠落盘文件接上前一时刻,不靠对话记忆。
This is a preview of SKILL.md. Download or install the skill to get the whole thing.
In the file
SKILL.md567 words
Files7
LicenceMIT
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈80
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
17,245
on trigger
The instruction body and 6 supporting files, read only when the skill fires.
8.7%
of a 200k window
Ten skills this size would take about 87% of the window before you open a file.
050k100k150k200k context window

17.3k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Heavy. Teams tend to install this one per project rather than globally, and load it only when the job comes up.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

The procedure it runs

The procedure has not been set out here step by step. It is in the body of its SKILL.md: the start of it is shown above, and the whole file comes with the install.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

Its SKILL.md does not declare which tools it asks the agent for, so what it touches is whatever the instructions themselves ask for — read them before you install it.

What it asks for
Writes filesnot declared
Network accessnot declared

This SKILL.md carries no allowed-tools line, so neither is declared. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

7 files, 69.3 kB on disk. A bundle is text throughout: the instructions the model reads, plus the templates it fills in.

  • SKILL.md12.3 kB
  • references/character-state-reverse.md4.3 kB
  • references/format-and-structure.md10.6 kB
  • references/length-routing.md6.4 kB
  • references/state-tracking.md2.3 kB
  • references/structure-mapping-long.md22.5 kB
  • references/structure-mapping-short.md10.9 kB
What is not in it

No dependencies and nothing executable: a skill is text the agent reads, so the bundle is 7 files you can review in full before installing. The MIT licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

# Novel & Story Project Importer · 17.3k tokens when loaded · macOS, Linux mkdir -p .claude/skills && t=$(mktemp -d) && curl -fsSL -o "$t/bundle.tar.gz" https://mcprush.com/api/skills/novel-story-project-importer/bundle.tar.gz && tar -xzf "$t/bundle.tar.gz" -C "$t" && [ -d "$t/novel-story-project-importer" ] && { [ ! -e .claude/skills/novel-story-project-importer ] || { mv .claude/skills/novel-story-project-importer "$t/.previous" && echo "Previous copy moved to $t/.previous"; }; } && mv "$t/novel-story-project-importer" .claude/skills/ && echo "Installed .claude/skills/novel-story-project-importer"
On Windows, or any OS with Node 20+
npx mcprush@latest skill add worldwonderer/novel-story-project-importer

Windows PowerShell says 'running scripts is disabled on this system'? Run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once, or type npx.cmd instead of npx (codex.cmd, gemini.cmd, grok.cmd likewise). PowerShell 7 needs neither. Writes to .claude/skills/novel-story-project-importer/ in the current project. For every project instead, run mkdir -p ~/.claude/skills && t=$(mktemp -d) && curl -fsSL -o "$t/bundle.tar.gz" https://mcprush.com/api/skills/novel-story-project-importer/bundle.tar.gz && tar -xzf "$t/bundle.tar.gz" -C "$t" && [ -d "$t/novel-story-project-importer" ] && { [ ! -e ~/.claude/skills/novel-story-project-importer ] || { mv ~/.claude/skills/novel-story-project-importer "$t/.previous" && echo "Previous copy moved to $t/.previous"; }; } && mv "$t/novel-story-project-importer" ~/.claude/skills/ && echo "Installed ~/.claude/skills/novel-story-project-importer" (macOS, Linux) — or add --global to the npx line. The curl line replaces .claude/skills/novel-story-project-importer/ only after the download succeeds, so files left there by another skill of the same name, or by an older release, do not mix in. A copy already there is moved aside, not deleted, and the line prints where. It appears as story-import in Gemini CLI, Codex, Copilot and Grok (its own name); Claude Code lists it by the folder name, novel-story-project-importer.

Which clients pick it up on their own

A skill is a folder of text. Most of these read a skills folder and pick it up without being told; the rest take the same folder another way — an upload in the app, a parameter on an API call — and then choose it by its description just the same.

Claude Code.claude/skills/
Claude DesktopCustomize › Skills
ChatGPTSkills › Create › Upload
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok Build.grok/skills/
Microsoft CopilotSkills › Upload a skill
PerplexityComputer › Skills › Upload a skill
DeepSeek Harness.dsh/skills/
Zed.agents/skills/
Devin Desktop.devin/skills/
Windsurf (legacy).windsurf/skills/
OpenAI Agents SDKInstructions or sandbox Skills
HTTP / APIa request parameter
This release
Version1.0.0
Publishedno release date on file
PriceFree
Referenceworldwonderer/novel-story-project-importer

Versions

v1.0.0 is what is on the shelf; no release here carries a date. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v1.0.0
  • No earlier releases have been published to the marketplace.
Pinning

The install command always fetches the release that is current the day you run it — v1.0.0 today — and cannot ask for an earlier one. The copy on your disk does not change until you run it again.

Reviews

—no reviews yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Sign in to review it

A review is tied to an account so it can be answered, edited and taken down by the person who wrote it.

Sign in
Who can post

Anybody with an account, one review each. It carries the version that was current when you wrote it, and the publisher may reply once.

Publisher
Servers0
Claim this skill