story-setup prepares a writing project for the rest of the Oh Story skills. It works out which agent host you are using, confirms the project folder, copies the right hooks, sub-agents, rules and reference files for that host, merges its own block into your CLAUDE.md or AGENTS.md, and writes a deployment marker.
It supports Claude Code, OpenCode, Codex, Google Antigravity, ZCode, OpenClaw and Reasonix, plus a generic file mode for web AI and custom agents. Existing user configuration is kept, and the deployment can be repeated safely. A check mode only diagnoses.
What You Get
- Hooks, sub-agents and rules installed for your agent host
- A managed block in CLAUDE.md or AGENTS.md that tells the agent how to use the writing skills
- A deployment marker file with version, target host and reference location
- A check mode that diagnoses a broken or outdated setup and reports it
- An author-friendly report of what works now and what to do next, such as opening a new session
Common Use Cases
- Preparing a new folder before writing the first chapter of a book
- Updating a project after the skill package has been upgraded
- Adding a second agent host to a project already set up for another
What Makes It Unique
It is the infrastructure step of the package: one command covers seven agent hosts, merges its configuration into existing files by managed blocks, and keeps your own settings and manuscripts untouched. It stops before writing anything when its bundled packages are incomplete or when the project is newer than the skill.
Under The Hood
The skill reads its own bundled reference folders and your project, then copies files into the project root and the host’s configuration folders. It installs hooks that run in later agent sessions: they show project status, guard outlines before prose, check chapters after they are written and validate commits. The Claude Code session-start hook also calls the GitHub releases API with curl at most once a day to look for a new version, and an environment variable turns that off. Setup merges settings files for Claude Code, Codex and Antigravity with bundled Python and Node scripts, writes a deployment marker, and runs a path-safety script before recursive copies. It asks questions through the agent when the host or target is unclear. It writes many files and changes agent configuration.