story-long-analyze

story-long-analyze is a skill for Claude Code from zenstory-ai/oh-story-claudecode. It costs 150 tokens per session (3,255 once invoked), scanned A, original, MIT.

A long-form fiction analysis workflow for breaking down a novel’s opening chapters, characters, pacing, turning points, relationships, and overall structure.

In plain words
What is it for?
Use it to study the first three chapters, continue chapter-by-chapter analysis, map story settings and relationships, and create a consolidated report.
Why use it?
It turns a lengthy book into staged summaries and analysis, so the reader can review the first section before continuing with the full breakdown.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: built for openclaw.

Part of the oh-story plugin — 13 skills, 13 commands shipped together

Good fit Use it to study the first three chapters, continue chapter-by-chapter analysis, map story settings and relationships, and create a consolidated report.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/zenstory-ai/oh-story-claudecode/story-long-analyze
About the project

oh-story-claudecode is a skill package for planning, analyzing, and writing Chinese web fiction, covering both short and long novels. It is intended for writers using Claude Code, Codex, OpenClaw, and other supported AI-agent environments, with workflows for market research, story breakdowns, drafting, editing, and cover creation. The catalogue entries are the package's skills, commands, agents, and plugin.

zenstory-ai/oh-story-claudecode · 8,063 stars · on GitHub · zenstory.ai

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-claudecode --skill story-long-analyze
Clone the repo
git clone --depth 1 https://github.com/zenstory-ai/oh-story-claudecode

Made for: Claude Code.

Or install oh-story, the plugin that ships this one along with the rest of its 13 skills, 13 commands.

Its marketplace also offers this one on its own, as the plugin story-long-analyze — /plugin install story-long-analyze after adding the marketplace above.

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-long-analyze

README.md
[![agentmods](https://agentmods.dev/badge/skills/zenstory-ai/oh-story-claudecode/story-long-analyze/github.svg)](https://agentmods.dev/skills/zenstory-ai/oh-story-claudecode/story-long-analyze)
Your own site
<a href="https://agentmods.dev/skills/zenstory-ai/oh-story-claudecode/story-long-analyze"><img src="https://agentmods.dev/badge/skills/zenstory-ai/oh-story-claudecode/story-long-analyze/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-long-analyze

Your own site · 80×15
<a href="https://agentmods.dev/skills/zenstory-ai/oh-story-claudecode/story-long-analyze"><img src="https://agentmods.dev/badge/skills/zenstory-ai/oh-story-claudecode/story-long-analyze.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 150 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,255 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. Third-party audits
  • Socket pass 27 Oct 2026
  • Snyk pass 27 Oct 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found 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.00150 $0.03255
Opus 5.5 $0.00060 $0.01302
Sonnet 5.5 $0.00030 $0.00651
Haiku 4.5 $0.00015 $0.00326

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

Security

Grade A, and why

story-long-analyze 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 yesterday.

The scan reads SKILL.md. This mod also ships 5 executable files (scripts/build_chapter_index.py, scripts/inspect_existing_assets.py, scripts/inspiration_index.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

Copies of this mod

1 near-identical copy found in the catalogue:

skills/story-long-analyze/SKILL.md · 104 lines

How it starts

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

story-long-analyze:长篇网文拆文

你是网络小说结构分析师。

核心原则:机械索引建立后复用;正常提取时每个原文块只读一次,同次产生逐章事实和跨章观察;失败重试按计划回看,聚合阶段复用落盘结果。

Agent 兼容性:只检查当前宿主的 agent;ZCode 查插件注册的同名角色,用 Agent 按实际 schema 派发,不要求 .zcode/agents。仅角色/工具缺失或调用失败时降级 solo/direct,报告 Fallback: project custom agents unavailable -> solo,不扫描其他 CLI 的目录或按宿主名固定降级。

Spawn 版本提示(不阻断 spawn):先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 37 不一致时(标记缺失、字段缺失/非整数、小于或大于 37)照常按当前宿主角色来源检查并 spawn,同时报告 Notice: agents bundle 版本不匹配(项目 {N},本版 37) 并提示重新运行 /story-setup 后新开会话;大于 37 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。只有当前宿主角色缺失或不暴露调用能力时才降级 solo/direct。

分析边界

  1. 只根据可读原文和已有资料下结论;缺失写“未知”或“文本未明确”。
  2. 硬事实附章节、source_locator 或 5–15 字定位词;推断标证据等级。
  3. 区分客观发生顺序、文本披露顺序、读者所知和角色所知。
  4. 分开分析事件推进、读者情绪和篇幅安排,分数不能代替解释。
  5. 只迁移抽象机制,不复刻专有设定、角色组合、关键事件链、标志性场面或原句。
  6. 不为填字段虚构事实,不把结果倒推成人物早有计划。

对作者说话

对话回复、快速预览.md、拆文报告.md 和人物关系图按 references/author-facing.md 写,讲清书中情节、阅读感受和可借鉴写法。内部字段、命令与质量指标留在运行资料中;编号带名称。脚本返回 author_message 时转述说明与选项。

运行约定

  • {PYTHON}:依次试 python3、python、py -3,用第一个能运行的。{story-long-analyze skill 根} 是本文件所在目录,{拆文目录} 是 拆文库/{书名}/。
  • 首次拆一本书时,把作者给的 TXT 存为 {拆文目录}/原文/原文.txt;若编码不是 UTF-8(常见为 GBK),先转成 UTF-8,否则子代理按行号读取时会乱码。
  • 全文不足 2 万字或认不出章节标题时多半是短篇,建议作者改用 /story-short-analyze;作者坚持或由导入调用(篇幅已在导入时定好)时照常按长篇拆。

按时刻读

进入各阶段时只加载下表对应的说明,续跑或新会话通过落盘产物和 _progress.md 的阶段状态衔接。references/author-facing.md 每个时刻都按需用。

时刻 读 交接
Phase 1–2、Stage 0–1 开头三章 本文件 + stage1-golden-chapters.md;原文变了或章号对不上时加 index-rebuild.md 黄金三章与快速预览落盘,标 stage1
Stage 2 逐批提取 pipeline-ops.md;子代理不可用、自己写批次时加 stage2-extraction.md 全部摘要落盘,标 stage2
补缺 / 增强(检查器给出 repair_stages、enhance_existing,或写作端请作者来补拆) 本文件「Phase 2」两张表,再按缺的那个 Stage 读下面对应一行 只补缺的产物,各自标阶段
Stage 3 剧情与节奏 synthesis-inputs.md + stage3-plot-rhythm.md 节奏与情绪模块落盘,标 stage3
Stage 4 角色与设定 synthesis-inputs.md + stage4-characters-settings.md 角色与设定落盘,标 stage4
Stage 5 主报告 synthesis-inputs.md + stage5-report.md 报告落盘,标 stage5
Stage 6 文风 style-profile-generator.md 文风.md 落盘,标 stage6
全部拆完 final-checks.md 按 author-facing「全部拆完」汇报
灵感库(作者提出「灵感库 / 提炼灵感 / 跨书灵感聚合 / 更新灵感库」时) references/inspiration-library.md 只写 灵感库/,不改拆文产物

Read the full file on GitHub · 104 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. yesterday Changed 037f98431e26
  2. 4d ago Changed 159f90daf414
  3. 10d ago Changed · -37 lines 31e126aff0c7
  4. 11d ago Changed 6316c6aa377c
  5. 12d ago Changed a0d33ddf0531
  6. 1mo ago Changed · -22 lines 52b95dd5361f
  7. 1mo ago Changed e1dbcec9ed1b
  8. 1mo ago Changed · +2 lines 8078cc7a5584
  9. 1mo ago Changed · -169 lines · -23 tokens per session 9d32a0106bab
  10. 1mo ago First seen · 330 lines · 173 tokens per session scan A d023b6d0c26d

Subscribe to this mod's changes

story-long-analyze is a skill published in the GitHub repository zenstory-ai/oh-story-claudecode (8,063 stars, last pushed yesterday), licensed MIT. It adds 150 tokens to every session and 3,255 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories