story-short-analyze Skill: Short Web Story Teardown

Makes Claude take apart a short web story and report why it hooks readers, so you can write your own from the same structure.

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

story-short-analyze reads a short story you give it and writes three files into 拆文库/<title>/: a report (拆文报告.md), a list of plot nodes (情节节点.md) and a list of writing techniques (写作手法.md). A small _meta.json tracks progress. It covers the story core, structure, emotional line, hooks and paywall points, the reversal, characters, openings and endings, and why the story resonates. Output is in Chinese.

It starts on /story-short-analyze, /短篇拆文 or a request like "拆这篇短文". It checks the word count first: up to 20,000 characters it goes ahead, between 20,000 and 30,000 it asks, and above 30,000 it suggests /story-long-analyze. It bundles no scripts. The next step in the same set is /story-short-write, which reads these three files.

Good for

Authors of short stories for Fanqie, Zhihu Yanyan or Gushihui who want to study a hit
Writers who want a story's reversal and hook structure laid out step by step
Claude Code or Codex users who read Chinese

Install story-short-analyze

Claude Code

Copy this prompt.

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

npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-short-analyze

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.

From its listing on skills.sh. Source.

What's in the skill

When it loads

短篇网文拆文。拆解爆款短篇小说（番茄短篇 / 故事会 / 知乎盐言 / 追妻 / 世情 / 重生 / 虐渣等通俗题材）的故事核、结构、情感线、反转设计、写作手法、共鸣层次。单一全量拆解管道：跑完 Stage 2-6 产出完整拆文报告，落盘到拆文库/{书名}/，下游 story-short-write 同时读拆文报告 + 情节节点 + 写作手法 + 原文 + _meta.json 写下一篇。触发方式：/story-short-analyze、/短篇拆文、「拆短篇」「拆这篇短文」「短篇拆文」「精细拆解短篇」「8000 字短篇拆解」「番茄短篇拆文」「故事会拆解」「盐言故事拆解」「分析这篇短篇」——均进入同一管道。

Sections in SKILL.md

拆解边界声明
Phase 1：确认拆解对象 + 字数路由 + 续跑检查
Step 1：拿到原文
Step 2：字数检查（长短篇路由）
Step 3：题材识别
Step 4：续跑检查
输出目录
原文备份（管道前置步骤）
Stage 2-6：拆文流程
5 阶段管道
按时刻读
验收（Stage 6 内容写完后、将 6 加入 stages_completed 前）
流程衔接

Key facts

Author: zenstory-ai
Repo: zenstory-ai/oh-story-claudecode
License: MIT (as listed by the crawl)
Installs on skills.sh: 17,432 (Nov 2, 2026)
GitHub stars: 8,223 (repo, Nov 2, 2026)
Last commit: 2026-11-01
Files: 16 files including SKILL.md: 15 reference guides and no scripts
Works in: Claude Code, Codex CLI, Antigravity, OpenCode, ZCode, OpenClaw, Reasonix
Language: SKILL.md and output are in Chinese
Output: 拆文库/<title>/ with 拆文报告.md, 情节节点.md, 写作手法.md, _meta.json and a copy of the source

What it includes

Starts the teardown; also /短篇拆文 or "拆这篇短文"
Asks which story you mean (title plus platform) and for the text file path, or lets you paste the text.
Try: “/story-short-analyze 拆这篇短文，原文在 ~/stories/曾将爱意私藏.txt”
Write · /story-short-analyze
Up to 20,000 characters goes ahead; 20,000 to 30,000 asks; above 30,000 suggests long-form
Over 30,000 characters it recommends /story-long-analyze and only continues if you reply 按短篇继续.
Length routing
Matches the story to one of 13 genre types, or a general template
Uses analysis-short-genres.md. The genre is a yardstick for what the story promises readers, not a pass or fail mark.
Read · Genre detection
Looks for an earlier _meta.json and asks to continue, archive and redo, or cancel
Redo moves the old results into an _archive_<timestamp>/ folder inside the book folder before starting again.
Write · Resume check
Copies your story into 拆文库/<title>/原文/ before analysing
If you pasted the text, it saves it as 原文.md. It checks the backup is not empty.
Write · Source backup
Story core, summary, sections and a list of plot nodes with positions
Nodes are cut where something changes in the story.
Write · Stage 2: structure and plot nodes
Emotion curve, hooks, paywall breakpoints and a 6-dimension payoff analysis
Also covers what makes the reader keep waiting.
Write · Stage 3: emotion line and hooks
Reversal mechanism with clue positions and at least 5 writing-technique dimensions
The technique dimensions include point of view, dialogue, time and information.
Write · Stage 4: reversal and techniques
Characters by role, first 50 and 100 characters, and how the ending closes
Each character gets a function label and an assessment.
Write · Stage 5: characters, opening, ending
Five-dimension score, resonance layers, reusable structure, then acceptance checks
Runs three checks before marking it done: report wording, the structure counts in _meta.json, and blocking items in a checklist.
Write · Stage 6: scoring and checks

From the official docs

Questions

What does story-short-analyze do?

It breaks a short web story into a report, a plot-node list and a writing-technique list. It explains the story core, hooks, reversal design, characters and why readers respond. Output is Chinese and lands in 拆文库/<title>/.

How do I install story-short-analyze?

Use the install box above for this skill alone. The README installs the whole Oh Story set with npx skills add zenstory-ai/oh-story-claudecode -y -g, then asks you to run /story-setup in your writing project and start a new session.

Does it need scripts, Python or an API key?

It bundles no scripts. SKILL.md names no API key. The skill is a set of instructions and 15 reference guides, and the assistant does the analysis itself.

Does it work in Claude Code, Codex and the Claude app?

The README names Claude Code, Codex CLI, Google Antigravity, OpenCode, ZCode, OpenClaw and Reasonix. It does not document the Claude app.

What if my story is long?

Over 30,000 characters it suggests /story-long-analyze and continues as a short-story teardown only if you reply 按短篇继续. Between 20,000 and 30,000 it asks you which to use.

Will it refuse dark themes?

SKILL.md tells it not to refuse a whole story or passage for themes such as domestic violence, cheating or revenge. It treats them as ordinary fiction material. It may skip a passage it truly cannot handle.

Can I use the output to write a new story?

Yes. Run /story-short-write next. It reads the report, the plot nodes, the techniques, the source text and _meta.json. The final report tells you not to copy the source's characters, signature lines, objects or event order.

Is it safe to run?

It bundles no scripts. It copies your story into a folder in your project and writes analysis files there. When you choose to redo, it moves old results to an archive folder instead of deleting them.

Information

updated Nov 2, 2026

Repository: zenstory-ai/oh-story-claudecode
Folder: skills/story-short-analyze

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

Sources

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

Show all 5

story-short-analyze SKILL.md · github.com
oh-story-claudecode README · github.com
skills.sh listing · skills.sh
zenstory-ai/oh-story-claudecode · github.com
output-contract.md · github.com