story-structure-7-steps
Skill1 starsChanged 13 months agoApache-2.0View on GitHub
Analyze and develop story structure using John Truby's Seven Key Steps framework to create organically connected character-driven narratives with deep structural integrity
In this repository23 other files it gives its agents.
- app-runnerSkill
- delegateSkill
- env-managerSkill
- lexical-recall-guardSkill
- narrative-inventorySkill
- narrative-keywordsSkill
- narrative-mapsSkill
- obsidian-apiSkill
- obsidianSkill
- project-indexerSkill
- skill-api-conversionSkill
- skill-creatorSkill
- skill-distillSkill
- slipbox-integrationSkill
- story-structure-22-step-apiSkill
- story-structure-22-step-distilledSkill
- story-structure-22-stepSkill
- story-structure-crime-distilledSkill
- story-structure-crimeSkill
- story-structure-myth-distilledSkill
- story-structure-mythSkill
- symbol-webSkill
- webapp-testingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. About 0 are common, 15 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈15
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 36
When this skill is invoked, follow these steps to analyze or develop story structure.
- Distinctive: line 45
Ask which story to analyze or develop
- Distinctive: line 58
If the writer has only a basic idea or concept:
- Distinctive: line 59
Start by working on the self-revelation (Step 6)—determine the endpoint first
- Distinctive: line 64
If the writer has a draft or substantial material:
- Distinctive: line 65
Read/analyze the existing story material
- Distinctive: line 71
If the writer knows something isn't working:
- Distinctive: line 74
Use the seven steps to diagnose and solve the issue
- Distinctive: line 76
Ask the writer which approach best fits their situation.
- Distinctive: line 111
Warning check: Make sure desire and need are distinct.
- Distinctive: line 149
Intensity check: Make sure the battle is intense enough to force the hero's self-revelation.
- Distinctive: line 163
Key reminder: Don't have the hero explicitly say what they learned.
- Distinctive: line 180
Verify that the seven steps connect organically (not mechanically):
- Very specific: line 218
Ask where to save structure analyses (suggest structure/ or process/structure/)
- Distinctive: line 219
Create the chosen directory if it doesn't exist
- Very specific: line 221
Use the structure from assets/structure-template.md
- Distinctive: line 226
Create the analysis as a formatted markdown artifact or downloadable file
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Story Structure: Seven Key Steps
This skill helps writers analyze and develop story structure using John Truby's seven-step framework from The Anatomy of Story. These steps represent the organic DNA of story—the sequence any human being must work through to solve a life problem.
Purpose
Truby's seven steps are based on human action—the natural process of how people address problems in life. They help create stories with organic, internally generated structure, ensure heroes undergo meaningful character change, build dramatic conflict through competing desires, link all story elements to the premise line, avoid mechanical plot formulas, and achieve the greatest emotional impact on the audience.
When to Invoke This Skill
Invoke this skill when writers need to:
- Develop a new story idea and find its structural foundation
- Address stories that feel reactive or lack clear dramatic drive
- Develop characters who aren't changing or growing meaningfully
- Strengthen opponents/antagonists that feel generic or unclear
- Clarify what a story is really about
- Build scenes toward a unified endpoint
- Deepen psychological and moral dimensions
- Identify what's missing in story structure
Bundled Resources
References:
references/truby-framework.md- Detailed explanation of all seven steps (weakness/need, desire, opponent, plan, battle, self-revelation, new equilibrium), important principles, examples (The Godfather, Chinatown, Saving Private Ryan, The Verdict), and guidance for non-traditional narratives
Assets:
assets/structure-template.md- Comprehensive template for seven-step structure analysis
Task Instructions
When this skill is invoked, follow these steps to analyze or develop story structure.
Step 1: Detect Environment & Understand Context
Determine the environment:
- With access to project directory and file system tools (Read, Write, Edit, Glob, Grep): Claude Code environment
- With uploaded files or chat without direct project access: Claude Desktop/Web environment
Understand the story context:
- Ask which story to analyze or develop
- In Claude Code: If not specified, search for story files in the project (narrative drafts, outlines, character notes)
- In Claude Desktop: Ask to describe the story or share existing materials
- Understand whether this is:
- A new story idea needing structure
- An existing draft needing structural analysis
- A story in development with some elements defined
Step 2: Determine Analysis Approach
Based on what the writer has, choose the appropriate approach:
A. Forward Development (New Story) If the writer has only a basic idea or concept:
- Start by working on the self-revelation (Step 6)—determine the endpoint first
- Then work backward to figure out need (Step 1) and desire (Step 2)
- Build the rest of the structure from this foundation
B. Reverse Engineering (Existing Draft) If the writer has a draft or substantial material:
- Read/analyze the existing story material
- Identify which of the seven steps are present (explicitly or implicitly)
- Assess which steps are missing or underdeveloped
- Show how existing elements map to the seven-step structure
C. Problem Diagnosis (Stuck Story) If the writer knows something isn't working:
- Identify which step(s) are weak or missing
- Focus on the specific structural problem
- Use the seven steps to diagnose and solve the issue
Ask the writer which approach best fits their situation.
Reference: See references/truby-framework.md for principle "Start at the End" - determine self-revelation first, then work backward.
Step 3: Build the Seven-Step Structure
Work through each step systematically. Consult references/truby-framework.md for detailed explanation of each step.
Step 1: Weakness and Need
Questions to explore:
- What great weakness is holding the hero back at the beginning?
- What is missing within them that is so profound it's ruining their life?
- What must they overcome/change to have a better life?
Develop both forms:
- Psychological weakness and need: What flaw hurts the hero themselves? What must they overcome internally?
- Moral weakness and need: How is the hero hurting others at the beginning? What must they learn about how to act properly toward other people?
Key reminder: The hero should NOT be aware of this need at the beginning.
Reference: See references/truby-framework.md for techniques to create moral need.
Step 2: Desire
Questions to explore:
- What does the hero want in this story (not in life generally)?
- What specific goal are they pursuing?
- What actions will this goal require them to take?
Distinction check:
- Is this goal external and visible (desire) or internal and hidden (need)?
- Does pursuing this goal create forward momentum in the story?
- Will accomplishing this goal also fulfill the hero's need?
Warning check: Make sure desire and need are distinct. Desire is on the surface (what audience thinks story is about). Need is hidden beneath (what story is really about).
Step 3: Opponent
Questions to explore:
- Who wants to prevent the hero from achieving their desire?
- What goal does the opponent want? (Must be the SAME goal as hero)
- How does the opponent attack the hero's greatest weakness?
- What makes this opponent particularly good at defeating this particular hero?
Deepest conflict question: What is the most important thing the hero and opponent are fighting about? (Often: which version of reality will everyone believe)
Complexity check:
- Does the opponent have moral complexity (not pure evil)?
- Does the opponent have their own psychological need?
- Why does the opponent believe they're right?
Reference: See references/truby-framework.md for the critical principle about same goal.
Step 4: Plan
Questions to explore:
- What strategy will the hero use to overcome the opponent and reach the goal?
- Is the plan specific and focused on defeating this particular opponent?
- Is the plan complex enough to involve multiple steps/actions?
- What happens when the plan doesn't work? How must it adapt?
Structure check: The plan should shape the middle of the story. If it's too simple, the story will be too short.
Step 5: Battle
Questions to explore:
- What is the final confrontation between hero and opponent?
- Where/when does this climactic conflict occur?
- Is it a battle of violence or a battle of words (or both)?
- How does this battle put the hero to the ultimate test?
- Who wins the goal?
Intensity check: Make sure the battle is intense enough to force the hero's self-revelation.
Step 6: Self-Revelation
Questions to explore:
- What does the hero learn about who they really are?
- How do they see themselves honestly for the first time?
- What do they understand about their flaw?
- What do they realize about how they've hurt others?
Both forms:
- Psychological self-revelation: Hero sees themselves in a new light
- Moral self-revelation: Hero realizes they've been wrong, hurt others, must change; they prove change by taking new moral action
Key reminder: Don't have the hero explicitly say what they learned. Suggest insight through their actions.
Quality check: Much of the story's quality is based on the quality of this self-revelation.
Reference: See references/truby-framework.md for connection between self-revelation and need.
Step 7: New Equilibrium
Questions to explore:
- What has fundamentally changed now?
- Has the hero moved to a higher or lower level?
- What is the lasting impact of the hero's journey?
Assessment: Positive self-revelation (hero moves to higher level) or negative self-revelation (hero falls or is destroyed)?
Step 4: Assess Organic Connections
Verify that the seven steps connect organically (not mechanically):
Connection tests:
- Need ’ Desire: How well connected?
- Desire ’ Opponent: Competing for same goal?
- Opponent ’ Plan: Plan designed for this opponent?
- Battle ’ Self-Revelation: Battle intense enough to force revelation?
- Need ’ Self-Revelation: Endpoint addresses beginning?
Identify weak connections and suggest how to strengthen them.
Step 5: Provide Structural Analysis and Recommendations
Based on the analysis:
For new stories:
- Which steps are well-defined?
- Which steps need development?
- What should be worked on first?
- Are there any missing connections?
For existing drafts:
- Which steps are present and working well?
- Which steps are missing or underdeveloped?
- How can weak steps be strengthened?
- What revisions would improve structural integrity?
For stuck stories:
- Which step is the source of the problem?
- How can that step be fixed?
- What ripple effects will fixing it have on other steps?
Reference: See references/truby-framework.md for key principles like "Don't skip that first step. Ever."
Step 6: Create Seven-Step Structure Documentation
If in Claude Code (project directory access):
- Get current date using
date +%Y-%m-%dcommand - Ask where to save structure analyses (suggest
structure/orprocess/structure/) - Create the chosen directory if it doesn't exist
- Save with descriptive filename using actual date:
YYYY-MM-DD-[story-name]-7-steps.md - Use the structure from
assets/structure-template.md - Include both the step-by-step breakdown and recommendations
- Confirm the save location
If in Claude Desktop/Web (no project directory):
- Create the analysis as a formatted markdown artifact or downloadable file
- Present it in the chat for review
- Suggest saving with filename using current date:
YYYY-MM-DD-[story-name]-7-steps.md - Use the structure from
assets/structure-template.md - Offer to explore any specific step in more depth if requested
Important Reminders
- Start at the end: Determine self-revelation first, then work backward
- Organic, not mechanical: Seven steps exist IN the story, not imposed from outside
- Character change is central: Need = beginning of change, Self-revelation = endpoint
- Both psychological AND moral: Better stories include both forms of need
- Don't skip weakness/need: "Don't skip that first step. Ever."
- Desire ` Need: Two unique steps with different functions
- Same goal: Opponent must want the SAME goal as hero
- Show, don't tell: Self-revelation through action, not statement
Reference: See references/truby-framework.md for detailed principles and key quotes.
What This Skill Does NOT Do
- Replace the writer's creative vision or storytelling instincts
- Guarantee a "good" story (execution still matters)
- Work for all story types (particularly suited for character-driven drama)
- Provide scene-by-scene plotting (it establishes structural foundation)
- Eliminate the need for other story elements (theme, world-building, etc.)
Integration with Other Skills
This skill works alongside:
- symbol-web - Symbols deepen character arcs and thematic resonance
- narrative-inventory - Catalogues what exists; seven steps shows if structure is present
- narrative-keywords - Identifies conceptual threads; seven steps ensures they build toward self-revelation
- narrative-maps - Shows spatial structure; seven steps shows dramatic structure
- Character development tools
- Scene planning tools
Based on John Truby's "The Seven Key Steps of Story Structure" from The Anatomy of Story: 22 Steps to Becoming a Master Storyteller
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

