Skip to content

Short Story Analyzer

Breaks down a published short story into its hook, structure, twists and techniques for reuse

Stars
8,255
Licence
MIT
Files
15 files

What it does

Once installed, the agent reads a short story you provide (in Chinese web-fiction style) and writes a structured analysis: the core story idea, plot beats, emotional curve, twist design, narrative techniques, characters and an opening/ending review. It saves these as markdown reports and a metadata file in a folder, so a companion skill can later use them as reference for writing a new short story.

Great for

  • Writers who want to study why a popular short story works
  • Writing teachers or students doing structural analysis of short fiction
  • Authors analysing their own published or owned works before a new draft

Skip it if

  • Copying or republishing someone else's text: the skill is framed as read-only critical analysis of works the user legitimately holds, but it still stores a full copy of the source text in a project folder
  • Long novels: the skill itself suggests a different long-form analyser above about 30,000 characters

Try asking

  • “/短篇拆文 and then provide the story text or file path”
  • “拆这篇短文:标题《...》,来源番茄短篇”
  • “精细拆解这篇8000字短篇的反转和写作手法”
  • “Analyse the emotional curve and hooks of this story I own”
Step-by-step guide: how to use Short Story AnalyzerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    story-short-analyze.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip story-short-analyze.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip story-short-analyze.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Provide the full story text in a file rather than pasting, so the original copy is saved intact in the 原文 folder
  • Answer the resume prompt carefully if a previous analysis exists, since choosing overwrite archives the old results
  • Expect the agent to ask whether to treat stories between 20,000 and 30,000 characters as short or long

What's inside

  • references/analysis-characters.md
  • references/analysis-method.md
  • references/analysis-report-style.md
  • references/analysis-short-genres.md
  • references/analysis-short-hooks.md
  • references/analysis-short-mechanics.md
  • references/analysis-short-patterns.md
  • references/analysis-short-suspense.md
  • references/analysis-submission.md
  • references/optional-modules.md
  • references/output-contract.md
  • references/quality-checklist.md
  • references/source-story-quality.md
  • references/stage2-3-structure-emotion.md
  • SKILL.md

Redistributed unmodified from zenstory-ai/oh-story-claudecode under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.