oh-story-claudecode: The Ultimate AI Skill Pack for Web Novel Writing

At the heart of 'oh-story-claudecode' lies a core philosophy: 'Formula = Deterministic Emotional Satisfaction'. This principle guides the development and application of the skill pack, focusing on understanding and replicating the elements that consistently engage and satisfy readers. Professional authors, according to this philosophy, follow a three-step methodology: 1. **Market Scanning (扫榜):** Analyzing popular trends on bestseller lists to identify compelling themes, character archetypes, and effective entry points for stories. 2. **Text Deconstruction (拆文):** Breaking down the structure, pacing, and narrative elements of successful works to build a personal library of reusable story modules. 3. **Commercial Writing (商业化写作):** Applying core techniques such as hooks, satisfying plot resolutions (爽感), and building anticipation (期待感) to create commercially viable narratives. The skill pack is built around four key pillars: reverse-engineering popular works, modularizing plot elements, managing context and state across different story layers, and fostering human-AI collaboration.

Installing 'oh-story-claudecode' is straightforward and can be done through two primary methods: **Method 1: Direct Integration with AI Platforms** For platforms like Claude Code, OpenCode, ZCode, OpenClaw, Codex, or Reasonix, and any Web AI/Agent platform that supports importing GitHub repositories or skills, you can simply instruct the platform to install the skill: `Install this skill https://github.com/worldwonderer/oh-story-claudecode` To upgrade, simply repeat the same command. **Method 2: Command Line Installation** You can install the skill using npm: `npx skills add worldwonderer/oh-story-claudecode -y -g` The `-g` flag installs it globally, making it available in all directories. Omitting `-g` installs it only in the current directory. To update, re-execute the same command. **Troubleshooting Installation:** On Windows, you might occasionally encounter `ENOENT` errors during directory creation, even if the installation reports 'Done!'. This usually indicates that some skills were not fully installed. If the reference directory for `story-setup` is incomplete, running `/story-setup` will prompt you about an incomplete reference package. Other forms of incompleteness might not trigger a specific message. Re-running the installation command, regardless of whether errors were reported, can often fix these issues. **Post-Upgrade Setup:** After upgrading, if you have already run `/story-setup` in a project, it's recommended to re-run it in the project root to synchronize hooks, agents, and references. Refer to `CHANGELOG.md` and the Releases page for details on version changes.

'oh-story-claudecode' offers a rich set of skills, each designed for a specific aspect of the writing process. These skills can be triggered by commands or natural language prompts: * **`story-setup`**: Deploys the environment for various AI platforms (Claude, OpenCode, Codex, ZCode, OpenClaw, Reasonix) and generic use, safely merging existing configurations. * **`story`**: Acts as a toolbox router, distributing fuzzy intents and providing access to the local 'story dashboard' for deconstruction and project management. * **`story-long-write`**: Facilitates long-form writing, including outline creation, character development, and text generation. * **`story-long-analyze`**: Analyzes long-form novels, focusing on key plot points, satisfying moments, and pacing. * **`story-long-scan`**: Scans bestseller lists for long-form novels on platforms like Qidian and Tomato. * **`story-short-write`**: Aids in writing short stories, emphasizing emotional design, plot twists, and polished output. * **`story-short-analyze`**: Deconstructs short stories, examining the core idea, structure, emotional arc, and writing techniques. * **`story-short-scan`**: Analyzes short story trends on platforms like Zhihu Yan Yan and Tomato. * **`story-deslop`**: Removes AI-generated writing traces, ensuring natural language flow. * **`story-import`**: Imports existing novels into a standard project structure for further AI processing. * **`story-review`**: Conducts multi-perspective reviews of stories, using up to 4 agents and evaluating against platform scoring standards. * **`story-cover`**: Generates cover art by analyzing book titles and themes, utilizing GPT-Image-2. * **`browser-cdp`**: Controls browsers via CDP protocol to reuse login states for data scraping. Natural language triggers are also supported, such as 'Help me start a book' mapping to `story-long-write`, or 'This piece is too AI' mapping to `story-deslop`.

'oh-story-claudecode' integrates eight automated hooks deployed by `/story-setup` for Claude Code, significantly enhancing workflow automation and consistency. * **`session-start.sh`**: Executes at the beginning of each session, displaying branch information, progress snapshots, and the status of text deconstruction. * **`session-end.sh`**: Logs session details to `tracking/session-log.txt` upon session termination. * **`detect-story-gaps.sh`**: Runs at session start to identify setting inconsistencies, outline deficiencies, and broken plot threads. * **`pre-compact.sh`**: Saves a progress snapshot, including the path and line count summary, before context compression. * **`post-compact.sh`**: Notifies the user to load the progress snapshot to restore context after compression. * **`validate-story-commit.sh`**: Checks for hardcoded attributes and mandatory fields during Git commits, issuing warnings but not blocking the commit. * **`guard-outline-before-prose.sh`**: Prevents the initial creation of main text if a corresponding outline or sub-outline is missing, enforcing outline creation first (blocking action). * **`check-prose-after-write.sh`**: Performs a lightweight scan after text is written, checking for truncation, engineering terms, problematic phrasing, and word count deficits (informational, non-blocking). These hooks ensure that the writing process is guided by established best practices and that potential issues are flagged or prevented proactively, leading to a more robust and consistent writing experience.

'oh-story-claudecode' is designed to cater to the needs of web novel writers across major platforms, offering specialized support for both long and short-form fiction. **Supported Platforms:** * **Long-Form:** Qidian (起点中文网), Tomato (番茄小说), Jinjiang Literature City (晋江文学城), Qimao (七猫小说), Ciwei Mao (刺猬猫). * **Short-Form:** Zhihu Yan Yan Stories (知乎盐言故事), Tomato Short Stories (番茄短篇), Qimao Short Stories (七猫短篇). **Real-World Examples:** The project provides several demonstration examples in the `demo/` directory to showcase the capabilities of the skill pack: * **Short Story Deconstruction:** 'Once Hidden Love' (曾将爱意私藏) * **Long Story Deconstruction:** 'Panlong' (盘龙) * **Long Story Continuation Project:** 'You Asked Me to Manage Your Account, You Created a High-Burning Mixed Cut Bombing the Whole Network' (让你管账号，你高燃混剪炸全网) * **Cover Generation Example:** 'Sword Dao Supreme' (剑道独尊) - illustrating the cover art generation process. These examples serve as practical guides and proof of concept, demonstrating how 'oh-story-claudecode' can be applied to real writing projects. The developers express hope that this tool will be beneficial for writers, particularly during transitional periods like job searching, and welcome contributions from the community to further enhance the skill pack and its knowledge base.