How-to · Writing · By Haowjy (Creative Writing)

How to use Story Architecture in your AI agent

Install and use the Story Architecture skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

Story Architecture helps writers structure fiction at every level: full series, individual arcs, chapters, and scenes. It teaches you how to design story beats that build on each other, create rising tension, and deliver satisfying payoffs. Whether you outline first or discover as you write, this skill gives you the framework to evaluate whether your narrative structure is working.

Step 1 — Get the skill source URL

The Story Architecture skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture to my project.

Cursor

Install this agent skill: https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture

Codex

Add this skill to .codex/skills/: https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture

Gemini CLI

Add the skill at https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture

Windsurf

Add this skill: https://github.com/haowjy/creative-writing-skills/tree/main/skills/story-architecture

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Outlining a novel or series and need to map the big-picture structure
  • Your draft feels saggy or aimless and you need to diagnose pacing issues
  • Juggling multiple arcs and want to ensure each one escalates properly
  • Test whether a scene or chapter is earning its place in the story

What this skill does

  • Structures stories at multiple nested scales — saga, arc, chapter, and scene
  • Teaches causation over sequence so events drive each other instead of just following
  • Tracks setup and payoff across long-form fiction to ensure promises are kept
  • Balances tension and release so readers stay engaged without numbness
  • Identifies arc components like hooks, midpoint shifts, crises, and resolutions
Made byHaowjy (Creative Writing)
CategoryWriting