story-import

story-import is a skill for Claude Code, Codex from zenstory-ai/oh-story-dsh. It costs 98 tokens per session (3,427 once invoked), scanned A, a copy of story-import, MIT.

A tool for turning an existing unfinished or completed novel into a structured writing project. It analyses the book and prepares it for continued writing with supported writing workflows.

In plain words
What is it for?
Use it to import a novel, reconstruct its project folders and analysis materials, and continue writing it in a compatible workflow.
Why use it?
It removes the manual work of rebuilding a book's characters, plot, and other project structure before continuing it. It also chooses a long-form or short-form analysis path based on the book's length.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: reads .claude/ paths; mentions subagents; reads ~/.codex paths.

Good fit Use it to import a novel, reconstruct its project folders and analysis materials, and continue writing it in a compatible workflow.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/zenstory-ai/oh-story-dsh/story-import
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add zenstory-ai/oh-story-dsh --skill story-import
Clone the repo
git clone --depth 1 https://github.com/zenstory-ai/oh-story-dsh

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for story-import

README.md
[![agentmods](https://agentmods.dev/badge/skills/zenstory-ai/oh-story-dsh/story-import/github.svg)](https://agentmods.dev/skills/zenstory-ai/oh-story-dsh/story-import)
Your own site
<a href="https://agentmods.dev/skills/zenstory-ai/oh-story-dsh/story-import"><img src="https://agentmods.dev/badge/skills/zenstory-ai/oh-story-dsh/story-import/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for story-import

Your own site · 80×15
<a href="https://agentmods.dev/skills/zenstory-ai/oh-story-dsh/story-import"><img src="https://agentmods.dev/badge/skills/zenstory-ai/oh-story-dsh/story-import.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 98 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,427 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00098 $0.03427
Opus 5.5 $0.00039 $0.01371
Sonnet 5.5 $0.00020 $0.00685
Haiku 4.5 $0.00010 $0.00343

Measured today against content hash 630e500f07ce, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

story-import scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

The scan reads SKILL.md. This mod also ships 5 executable files (scripts/build_outline_brief.py, scripts/check-outline-contract.js, scripts/outline_view.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to story-import — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

packages/knowledge/oh-story/skills/story-import/SKILL.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

story-import:逆向导入已有小说

你是小说项目逆向工程师,把作者已有的书整理成可续写的写作工程,包含设定、大纲、正文及所需追踪。拆文库/{导入书名}/ 保留为分析数据源;向作者汇报工程整理结果和续写入口。

Agent 兼容性:只检查当前宿主:Claude .claude/agents/{agent}.md(subagent_type)、OpenCode .opencode/agents/{agent}.md(subagent 的 agent)、Codex .codex/agents/{agent}.toml(agent_type)、Antigravity .agents/agents/agent-name/agent.md(invoke_subagent + TypeName)。ZCode 查插件注册的同名角色,用 Agent 按实际 schema 派发,不要求 .zcode/agents。仅角色/工具不可用或返回未知 agent 时降级 solo/direct,不因其他端目录存在或宿主名固定串行。

Spawn 版本提示(不阻断 spawn):先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 37 不一致时(标记缺失、字段缺失/非整数、小于或大于 37)照常按当前宿主角色来源检查并 spawn,同时用一句白话提示作者「分析助手是旧版,运行 /story-setup(ZCode 先更新插件)后新开会话」,Notice: agents bundle 版本不匹配(项目 {N},本版 37) 原文写进汇报最后一行「技术备注:」;大于 37 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。只有当前宿主角色缺失或不暴露调用能力时才降级 solo/direct,Fallback: project custom agents unavailable -> solo 同样只进技术备注行。

名词与目录边界(全流程硬约束)

  • {导入书名}:用户自己已经写到一半或已经完本、现在要重建为工程的小说;它的分析源固定为 拆文库/{导入书名}/。
  • {对标书名}:用户另行选择的外部参考作品;它必须是独立拆解产物,来源固定为 拆文库/{对标书名}/,且不得指向本次导入源。
  • story-import 可以复用拆解管道分析 {导入书名},但不得把 {导入书名} 登记为主/副对标,不得把 拆文库/{导入书名}/ 或项目 设定/ 复制进 对标/。
  • 用户没有明确选择外部对标时,不创建对标子目录、不写 主对标书;后续由 story-long-write / story-short-write 的对标发现流程单独处理。

先复用长篇 /story-long-analyze 或短篇 /story-short-analyze 完成深度分析,再将结果迁移为项目结构。拆文方法、模板和质量检查由对应 skill 负责。

时刻表与交接

导入按下表分时刻执行,各时刻通过落盘文件交接。

时刻 作者确认什么 读什么 落盘
Phase 1 确认来源与范围 书名、题材、平台、篇幅、残稿怎么处理、外部对标、先不先装环境 本文件 Phase 1;判篇幅读 length-routing.md 导入记录
Phase 2 深度分析 不打扰作者 deep-analysis.md,再照它进入拆书流程 拆文库/{导入书名}/
Phase 3 结构迁移 原文没分卷时卷怎么分;要不要存本书文风 长篇 structure-mapping-long.md(绑了外部对标再读 benchmark-sync.md);短篇 structure-mapping-short.md 项目 设定/、正文/、大纲/(短篇为三个单文件)
逐批反推细纲(长篇) 不打扰作者 本批任务包(见 outline-reverse.md) 大纲/细纲_第XXX章.md
Phase 4 追踪初始化(长篇) 不打扰作者 import-tracking.md 追踪/
Phase 5 汇报与激活 请作者核对、拍板的事 import-report.md .active-book

Read the full file on GitHub · 124 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed 630e500f07ce
  2. 8d ago Changed · +1 lines 7433b1c78f53
  3. 11d ago Changed f27b22417755
  4. 12d ago Changed · -5 lines eaa52470d924
  5. 29d ago Changed · -516 lines a264414d64ef
  6. 1mo ago Changed · -4 lines b3b3f8db7e83
  7. 1mo ago Changed 2da7bbf6109e
  8. 1mo ago Changed a0267be37ed7
  9. 1mo ago First seen · 648 lines · 98 tokens per session scan A f801725460bc

Subscribe to this mod's changes

story-import is a skill published in the GitHub repository zenstory-ai/oh-story-dsh (629 stars, last pushed today), licensed MIT. It adds 98 tokens to every session and 3,427 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to story-import, differing in 0 lines, and is treated as a copy.