story-short-write Skill: Write Short Web Fiction in Claude
Walks Claude through writing a short web story from target emotion to final draft, for authors of Chinese short fiction.
- Installs
- 17.6K
- on skills.sh
- Stars
- 8.2K
- on GitHub
- Files
- 44
- besides SKILL.md
- Updated
- Nov 2026
- last repo commit
story-short-write works in four phases. First it asks what feeling the reader should be left with. Then it designs the story core, people, reversal and paywall point into 设定.md and 小节大纲.md. Then it writes the scenes into 正文.md, and last it polishes. The skill and its output are in Chinese.
It starts on /story-short-write, /写短篇, or a request such as "帮我写一篇短篇". Before it creates any story file it must read the reference files for the current phase, and it stops if one is missing. It runs bundled Node.js scripts to check the draft, and one of them rewrites punctuation in 正文.md in place. It is one of 14 skills in the Oh Story set.
Good for
- Authors writing short stories for Zhihu Yanyan, Fanqie short or Qimao short
- Writers who want a reversal or payoff story planned before any prose is written
- Claude Code or Codex users who read Chinese and can run Node.js
Install story-short-write
Claude Code
- 1
Copy this prompt.
Install the story-short-write skill in Claude Code. Run this command: npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-short-write 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
短篇网文写作。辅助短篇小说创作,从构思到成稿,聚焦情绪拉扯与节奏把控。触发方式:/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。
Sections in SKILL.md
- 写前必读(强制,先读后写)
- 执行规则
- 作者记忆管理
- 核心方法
- 写作流程
- Phase 1:确定目标情绪
- Phase 2:构思核心框架
- Phase 3:逐场景写作
- Phase 3 完成门槛(进入 Phase 4 前必须通过)
- Phase 4:精修打磨
- 流程衔接
- 参考资料
Key facts
- Author
- zenstory-ai
- License
- MIT (as listed by the crawl)
- Installs on skills.sh
- 17,573 (Nov 2, 2026)
- GitHub stars
- 8,223 (repo, Nov 2, 2026)
- Last commit
- 2026-11-01
What it includes
Starts the short-story workflow; also /写短篇 or "帮我写一篇短篇"
Asks what feeling the reader should have at the end. If you only give a genre or a gag, it suggests an emotion and waits for your yes.
Try: “/story-short-write 写个盐言故事,追妻火葬场,读完要让人意难平”
Write ·
/story-short-writeChooses among six emotions with a difficulty rating and suggested genre packs
The six are 意难平, 反转震撼, 爽感释放, 治愈温暖, 细思极恐 and 共鸣感动. If a 短篇扫榜结论.md from story-short-scan exists nearby, it reads that first.
Phase 1: pick the target emotionWrites 设定.md and 小节大纲.md after reading four craft guides and one genre pack
Covers story core, characters, reversal and paywall point. 10 genre packs are bundled; rare genres use a general formulas file.
Write ·
Phase 2: design the storyWrites 正文.md section by section and checks it against the outline
Must pass a checklist before polishing: word range, section count, and no blocking hits from the pattern and degeneration checkers.
Write ·
Phase 3: scene-by-scene draftRuns the checker scripts, fixes blocking hits and hands you a plain-language delivery note
Runs check-ai-patterns.js, check-outline-copy.js, normalize-punctuation.js, check-degeneration.js and check-delivery-contract.js on your files.
Runs code ·
Phase 4: polishRewrites 正文.md in place unless run with --check
Replaces ellipses, em dashes and double hyphens with Chinese punctuation and removes --- divider lines. It keeps quotes as they are by default.
Runs code ·
normalize-punctuation.jsStores and queries your writing habits with author_memory_commit.py
Used when you ask it to manage your writing habits; that mode does not write a story. Stored preferences are fed to the writer as soft guidance.
Runs code ·
Author memoryCan hand drafting and consistency checks to narrative-writer and consistency-checker
Used only if your agent has them installed; otherwise the main session does the work itself.
Write ·
Helper agents
From the official docs
Permissions
Low risk
The skill runs Node.js and Python scripts and writes story files into your project, including an in-place punctuation rewrite of your draft. Work in a folder you can review and keep backups of drafts.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It rewrites your draft punctuation in place
normalize-punctuation.js changes 正文.md unless run with --check, and the polish step uses it. Keep a copy of drafts you care about. github.com
It runs scripts and writes story files
It runs Node.js check scripts and a Python memory tool, and writes 设定.md, 小节大纲.md and 正文.md. Use a project folder you can review. github.com
Setup step adds hooks and agents to your project
The README says /story-setup deploys hooks, helper agents and references. Read what it adds first. github.com
Questions
What does story-short-write do?
It guides the assistant through writing a short web story, from the feeling you want the reader to have to a finished 正文.md. It plans the story first in 设定.md and 小节大纲.md, writes it section by section, then runs checks and a polish pass. It writes in Chinese.
How do I install story-short-write?
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 Node.js?
The checking steps run node scripts, so yes. The author-memory tool is a Python script. SKILL.md names no API key.
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.
Will it edit my story file without asking?
The punctuation tool rewrites 正文.md in place when run without --check, and the polish step runs it. Keep a copy of the draft if you want the original punctuation.
How does it differ from story-long-write?
This skill is for one short story with a single core payoff. SKILL.md points to /story-long-write when the setting is too big for a short piece, and to /story-short-analyze when you want to learn from a reference story first.
Can it remove the AI feel from my draft?
It runs a pattern checker during polish and fixes blocking hits. For a full three-layer pass SKILL.md points to the separate /story-deslop skill.
Is it safe to run?
It runs Node and Python scripts from the skill folder and writes story files into your project, including an in-place punctuation rewrite of 正文.md. Run it in a project folder you can review and keep backups of drafts you care about.
Information
updated Nov 2, 2026
- Repository
- zenstory-ai/oh-story-claudecode
- Folder
skills/story-short-write
Sources
Docs, issue trackers and discussions this page is built from.
Show all 6Hide
- story-short-write SKILL.md · github.com
- oh-story-claudecode README · github.com
- skills.sh listing · skills.sh
- zenstory-ai/oh-story-claudecode · github.com
- workflow-revision.md · github.com
- normalize-punctuation.js · github.com