ZenStory AI

ZenStory AI Projects

Agent skill pack

Oh Story

Write web fiction in Claude Code, Codex and other agents: chart scans, breakdowns, drafting, de-AI editing and covers.

7,170 GitHub stars13 skills

Source on GitHubEnglish README

Install Oh Story
npx skills add zenstory-ai/oh-story-claudecode -y -g

What it is

Oh Story is an MIT-licensed skill pack for writing web fiction in Claude Code, Codex and other supported agent hosts. Its 13 skills cover chart research, deconstruction, long-form serials, short stories, revision and covers. Long-form writing uses chapter blueprints, deterministic checks and file-based project state. /story-setup configures the host; specialist agents are orchestrated where supported, with direct execution available on other hosts.

What you need

  • LicenseMIT, open source.
  • HostAny one of these agents:Claude CodeCodex CLIGoogle AntigravityOpenCodeZCodeOpenClawReasonixKimi CodeDeepSeek Harness
  • Or in the browserFor novel writing only, you can skip the agent setup and use the ZenStory Workbench in the browser (app.zenstory.ai).

Start in 3 steps

  1. Installnpx skills add zenstory-ai/oh-story-claudecode -y -g
  2. Entry commandRun /story-setup in your agent host.
  3. Follow a guideFind your first task under “How it works” below and open its guide.

Writing craft

202 craft articles, each built on a method file in this project's skills. Start with the complete workflow, or open a task.

By creative task

How it works

  1. How do I continue a manuscript I have already written? Use story-import for a continuable project, then separate reconstructed history from the next chapter you choose to write. The harbor-radio continuation example preserves a promise, an already-made decision and unequal character knowledge without inventing a successful repair or complete reconciliation. Old prose stays intact; a future outline is not a completed event.
  2. How do I start writing in Claude Code? After installing the pack, run /story-setup in your writing-project folder and open a fresh session. Use /story to describe your task rather than memorizing every skill. For a new long-form project, /story-long-write 帮我开书 prepares settings, an outline and chapter blueprints, then stops before prose by default. Review that plan, then request /story-long-write 写第1章. This is the agent-host workflow, not a login to the separate ZenStory Workbench. “No prose” still creates planning files; tracking is initialized when the creator explicitly requests the first prose chapter. For a first reply before project creation, the writer’s skill guide compares two concrete investigation openings and carries the chosen direction into a separate planning request. For a detailed character profile that still does not generate action, character motivation moves from a relay plan into an original scene of resistance and shared credit, without treating an agreement as a completed delivery.
  3. How do I make the first three chapters invite continued reading? Read the first three chapters together: establish the protagonist’s situation, goal and story promise, then check what progress or payoff readers actually receive and what invites them onward. Adjust the sequence to the book’s genre and intended pace. The golden three chapters guide includes an opening checklist and an original before/after rewrite; chapter-ending hooks covers ways to carry expectation into the next chapter.
  4. Can one premise become a complete short story rather than a serial opening? Choose a central question and the action that answers it, then write the development that earns the ending. The original repair-shop plan and prose excerpts move from failed hinting to stated terms, an accepted deposit and departure. A promise to dispatch on Wednesday neither guarantees an arrival date nor means the repair is already done; a settled agreement does not heal every family hurt. Separate the six-section design, illustrative excerpts and the later complete manuscript file.
  5. 扫榜 · chart scanning Collect supported platform data when available, accept creator-supplied samples, or explicitly label historical knowledge fallback; unavailable sources can be skipped.
  6. How do I learn from a novel without copying its plot? Separate source observations, possible interpretations and a new-story exercise. The original passage-analysis example traces an unsigned poster proof to a conditional next step, then compares two garden scenes with the same facts and outcome: accepting a limit and sharing the explanation, or rejecting an unconfirmed staffing workaround. An original prose version then tests the uncertain-help option in dialogue and carries out the smaller order without copying the poster’s gestures. The guide also distinguishes the first-three-chapter checkpoint, a stated partial-reading scope and progress-based resume. Analysis-only work is not a continuable import, and a completed processing batch is not a full-novel verdict.
  7. How can I reduce character drift across many chapters? Separate the author’s private truth, each character’s own knowledge and what the reader has seen. Carry relevant current state, active clues and the next chapter’s commitments from the same project. The original letter-and-deadline example adds an optional clue-payoff design: a plausible suspicion remains a suspicion, later evidence has a prepared source, and a new address changes the next action without making an undelivered letter delivered.
  8. What if a chapter contradicts an established fact? Identify the conflicting passage and the intended fact, then request /story-long-write 修改第N章 with that evidence. If the revision changes continuity facts, the documented workflow requires a same-chapter revision transaction through tracking_commit.py; do not hand-edit the derived context or snapshots. Review the corrected prose and state before continuing. Structural checks do not replace the author’s judgment about characterization, voice or literary quality.
  9. Should I apply every conflicting review suggestion? No. Connect feedback to passage evidence and this book’s constraints, then choose the repair rather than accepting every proposed plot change. The original review-to-revision example turns an accepted agency diagnosis into a transfer-slip scene: the protagonist compares evidence and resists delay without breaking the seal or revealing the culprit. It separates agreement from completed registration and makes later-chapter attribution checks concrete.
  10. Why does a detailed outline still become flat prose? An outline names the required change; prose makes the decision and response happen. The original library-rescue example now pairs a staged opening with a continuation from the signed form through conditional cooperation and the first trip’s aftermath. It shows where to slow down, where a short transition is enough, and why stopping early requires an agreed chapter boundary—not an invented twist or a claim that a chat sample is a saved chapter.
  11. How can I revise formulaic prose without changing the story? Name the wording problem and preserve the scene’s facts, useful details and chosen cadence. A pattern hit needs contextual judgment, not an authorship verdict. The original prose-revision comparisons show a restrained edit, a connected-cadence alternative, purposeful repetition and the difference between losing a scene detail and changing an action. Pasted-fragment revision is distinct from detection only and in-place file editing.
  12. How can continuation keep my voice instead of a generic style? Give an authorized sample and name the useful dimensions, while keeping this book’s facts and viewpoint separate. The original author-voice example preserves a longer rhythm and mild humor without importing another story’s characters. Sample inference is not confirmed memory; a temporary choice, book-specific preference and global habit have different scopes. A written one-paragraph exception retains extended observation but drops the semicolon pattern and joke, showing why carrying a voice does not require identical paragraph shapes.
  13. How can characters sound different without relying on catchphrases? Give each speaker an immediate goal, a knowledge boundary and a relationship to the listener, then choose the wording. The original rehearsal dialogue example separates three conversational agendas while preserving the same outcome and an undisclosed private fact. Character dialogue can change with the listener without replacing the book’s narrative voice. A second version shows a direct correction of a misunderstanding without disclosing the private fact: subtext need not turn every answer into a riddle.
  14. Covers Prepare genre-aware cover guidance and use an available image-generation tool when configured.

What makes it different

  • Local verifiers check contracts and detectable patterns, rather than assigning literary quality scores.
  • Project settings, outlines, drafts, references and tracking remain inspectable files.
  • Host-aware setup can use specialist roles or a direct fallback; supported hosts do not imply identical orchestration.
  • The repository includes complete deconstruction, continuation and cover examples you can run through yourself.

Who it is for

  • Authors publishing on 起点 Qidian, 番茄 Fanqie, 晋江 JJWXC, 七猫 Qimao and 知乎盐言
  • Studios running several serials at once
  • Developers who want a mature, non-coding example of agent skills

Compare writing workflows

Terms it uses

扫榜 拆文 去AI味 黄金三章 爽点 钩子 套路

Sources

Based on the source as of 2026-10-15; links point at that version.

Part of ZenStory AI

ProjectFormatWhat it does
Oh Story Agent skill pack Write web fiction in Claude Code, Codex and other agents: chart scans, breakdowns, drafting, de-AI editing and covers.
Drama Skills Production skill suite Turn an idea or a novel into episode scripts, then visual specs, storyboards and generation prompts; produce and review when you need to.
Novel to Game Adaptation skill pack Adapt a novel into a playable game build grounded in the source, and check it running on the platform you choose.
Video Recap Skills Video workflow Turn footage into a Chinese-narration recap: understand the scenes, write, voice, edit and subtitle.
Oh Story DSH DSH plugin Use the writing, short-drama, game and recap packs inside DeepSeek Harness's GUI workbenches.
ZenStory Workbench Web workbench Write a novel with AI in the browser: outline, characters, chapters and versions in one project.