story-planning — Claude Code skill: what it does, how to install
Structures creative direction, outlines, and narrative architecture before prose drafting begins. Loads modular planning resources for pre-page story decisions.
npx skills add haowjy/creative-writing-skills --skill story-planning -a claude-codeWhat story-planning does
This skill guides pre-page narrative decisions. It helps evaluate options, pinpoint creative intent, and map chosen ideas into an outline structure before drafting text.
Everything relies on three distinct resource files: resources/creative-direction.md for option synthesis, resources/brainstorming.md for capturing ideas with source tags, and resources/story-architecture.md for arcs, chapters, scenes, and beat structures. The assistant loads only the specific resource needed for the current step.
Do not use this skill for production prose or critique. It breaks down if you ask it to generate story pages, because its prompt logic is built solely for architectural decisions before text is written.
What it helps with
- synthesize creative direction and compare narrative options
- capture exploratory brainstorm notes with source tagging
- map out story arcs, chapters, scenes, and beats before drafting
Example prompts for the agent
- Load resources/story-architecture.md and help me break down chapter one into beats.
- Help me decide between two plot options using resources/creative-direction.md.
- Capture brainstorm notes and tag our references with resources/brainstorming.md.
How to install story-planning
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill story-planning -a claude-code2Manually: put the files in place
~/.claude/skills/story-planning/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/story-planning/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill story-planning -a codex2Manually: put the files in place
.agents/skills/story-planning/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill story-planning -a cursor2Manually: put the files in place
.cursor/skills/story-planning/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills story-planning2Manually: put the files in place
.github/skills/story-planning/SKILL.md1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill story-planning -a gemini-cli2Platform CLI
gemini skills install https://github.com/haowjy/creative-writing-skills --path skills/story-planningManually: put the files in place
.devin/skills/story-planning/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill story-planning -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about story-planning
How to install story-planning in Claude Code?
Run npx skills add haowjy/creative-writing-skills --skill story-planning -a claude-code in your terminal. You can also save the file directly to ~/.claude/skills/story-planning/SKILL.md.
What does the story-planning skill do?
It switches the agent into a planning mode for pre-draft work. It structures creative choices, brainstorm notes, and narrative arcs across scenes and chapters.
Can story-planning write story prose or review drafts?
No, the skill explicitly excludes production prose and critique. It handles only pre-page planning and structural architecture before actual writing starts.
Source text
SKILL.md · Apache-2.0
--- name: story-planning type: mode-shift description: > Planning work before prose: creative direction, story-planning, outlining, and story architecture. Load when deciding what should happen or how a story should be structured. model-invocable: true --- # Story Planning Use this for pre-page decisions: what the story wants, what options exist, and how chosen direction becomes outline structure. Do not use it for production prose or critique. Load only the resource needed: - `resources/creative-direction.md` — author-facing direction and option synthesis. - `resources/brainstorming.md` — exploratory capture and source tagging. - `resources/story-architecture.md` — arc, chapter, scene, and beat structure.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills