Diagnose branching narrative problems. Use when choices feel meaningless, when branching is unmanageable, when player agency conflicts with authored story, or when interactive elements break narrative flow.
npx claudepluginhub joshuarweaver/cascade-content-creation-misc-1 --plugin jwynia-agent-skills-1This skill uses the workspace's default tool permissions.
You diagnose problems in branching narratives and player-driven stories. Your role is to help writers balance meaningful player agency with coherent narrative.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
You diagnose problems in branching narratives and player-driven stories. Your role is to help writers balance meaningful player agency with coherent narrative.
Agency and authorship coexist.
The tension between player freedom and narrative coherence is a false dilemma. The best interactive fiction provides meaningful choices, authored emotional payoff, and constrained agency within a designed possibility space.
| Type | Interaction | Strengths | Weaknesses |
|---|---|---|---|
| Parser-based | Natural language commands | High freedom, puzzle-oriented | "Guess the verb" friction |
| Choice-based | Select from options | Constrained, easier to author | Risk of false choices |
| Hybrid (VN, RPG) | Multiple modes | Rich, persistent state | High authoring burden |
| Tabletop scenario | GM interprets | Dynamic, improvisational | Requires facilitator |
Symptoms: Choices don't matter. All paths converge immediately. Players stop caring about decisions. "It doesn't matter what I pick" feeling.
The Meaningful Choice Test:
Key Questions:
Interventions:
Symptoms: Exponential content requirements. Too many paths to write. Can't maintain quality across branches. Story structure collapsing under branch weight.
The Math Problem:
Key Questions:
Branching Solutions:
| Technique | Description | Trade-off |
|---|---|---|
| Foldback | Branches reconverge at key beats | May feel railroaded if obvious |
| Delayed consequences | Flags alter later content, not path | Same structure, different texture |
| Quality-based | Storylets unlock by accumulated state | Harder to ensure dramatic arc |
| Bottleneck | Multiple paths through fixed story beats | Preserves authored climaxes |
Interventions:
Symptoms: Players realize choices don't matter. Trust is broken. Marketed agency wasn't delivered. "I tried both options and got the same thing."
Key Questions:
When False Choices Are Acceptable:
When False Choices Are Problematic:
Interventions:
Symptoms: Full player freedom creates incoherent stories. Or: fixed story makes "interactive" feel pointless. Writer can't reconcile openness with craft.
The Tension:
Key Questions:
Resolution: Constrained Agency The author designs the possibility space. The player navigates within it.
Constraint Techniques:
Interventions:
Symptoms: Reading experience is mechanical. Choices interrupt rather than emerge from story. Pacing destroyed by decision points. More menu than narrative.
Key Questions:
Diagnostic Checklist:
Interventions:
Symptoms: Each ending feels hollow. "Bad endings" punish rather than satisfy. One "true ending" invalidates others. Endings don't feel earned.
Key Questions:
Ending Types:
| Type | Description | Risk |
|---|---|---|
| Branch endings | Different conclusions by path | Unequal effort to achieve |
| Quality endings | Same ending, quality varies | Can feel like high score |
| Hidden endings | Secret conclusions | Completionist frustration |
The "True Ending" Problem: If one ending is canonical, others feel invalidated. Player optimizes rather than roleplays.
Interventions:
Symptoms: Can't track what player has done. Contradictions appear. Variables proliferate. Scene logic becomes unmaintainable.
Key Questions:
What State Should Produce:
State Types:
| Type | Purpose | Example |
|---|---|---|
| Plot flags | What happened | Met the mentor? |
| Relationship values | Character dynamics | Trust level |
| Resources | Economic/survival | Money, health |
| Qualities | Character development | Courage stat |
| Inventory | Objects/abilities | Key items |
Interventions:
Mostly linear, occasional choice moments. Choices affect scenes but not arc.
─────[choice]───────[choice]───────[choice]─────
│ │ │
variation variation variation
Best for: Character-focused stories, expression over outcome.
Multiple paths but key beats are fixed:
┌─A─┐ ┌─D─┐
Start───┼─────Midpoint───┼─────Climax─────End
└─B─┘ └─E─┘
Best for: Balancing agency with authored climaxes.
Early branches create different experiences, converge for endings:
┌──────Route A──────┐
Start ───┤ ├─── Endings (3-4)
└──────Route B──────┘
Best for: Replayability with manageable scope.
Same events, player knowledge persists, choices informed by attempts.
Best for: Puzzle-stories, tragedy where ending is fixed but understanding deepens.
| Type | Description | Quality |
|---|---|---|
| Binary moral | Right vs. wrong | Too simple—avoid |
| Dilemma | Two goods in conflict | Best—no clear answer |
| Expression | Same outcome, different character | Valid if authentic |
| Strategic | Risk/reward calculation | Good for game-like IF |
| Discovery | Which path to explore | Acceptable for pacing |
Avoid clear right/wrong. Create dilemmas where reasonable people disagree. Make players choose between values, not optimize.
Choices are navigation puzzles with correct/incorrect paths. Fix: Make all paths valid experiences. Remove "wrong" answers.
Extensive apparent choice, no actual consequence. Fix: If you can't make it matter, don't pretend it does.
One ending is clearly best; player ignores roleplay to maximize. Fix: Make endings differently satisfying, not ranked.
Content locked behind specific paths creates exhausting replay. Fix: Make each playthrough satisfying. Unlockables enhance, not complete.
"Tell me about X / Y / Z" as menu system, not story. Fix: Integrate information into motivated scenes.
Player knows what to do but can't express it. Fix: Robust synonyms, clear feedback, gentle guidance.
When a writer presents IF problems:
Parser, choice-based, hybrid, or tabletop? Each has different solutions.
For key choices:
Based on identified state. Point to structure patterns, choice design principles.
| story-sense State | Maps to IF State |
|---|---|
| State 4.5: Plot Without Pacing | IF5 (Flowchart Feel) |
| State 5.75: Ending Doesn't Land | IF6 (Ending Problems) |
Writer: "Players keep saying my choices don't matter."
Your approach:
Writer: "I have 50 possible endings and can't write them all."
Your approach:
Writer: "I have a 'good' ending and several 'bad' endings."
Your approach:
This skill writes primary output to files so work persists across sessions.
Before doing any other work:
context/output-config.md in the projectexplorations/interactive/ or a sensible location for this projectcontext/output-config.md if context network exists.interactive-fiction-output.md at project root otherwiseFor this skill, persist:
| Goes to File | Stays in Conversation |
|---|---|
| IF state diagnosis | Clarifying questions |
| Branch structure notes | Discussion of specific choices |
| Choice quality assessment | Writer's design decisions |
| Complexity recommendations | Real-time feedback |
Pattern: {project}-if-{date}.md
Example: adventure-game-if-2025-01-15.md
Your role is diagnostic: identify the problem, explain why it's a problem, and guide toward solutions. The writer designs the experience.
Interactive fiction is not "a story with choices added." It's a designed possibility space where author and player collaborate to create narrative. The author controls the space; the player navigates it.
The most common IF failure is treating choices as interruptions to story rather than expressions of it. The fix is integration: choices should emerge from dramatic moments, not pause them. Each path should be worth experiencing, not a wrong turn to be avoided.
When IF works, players feel both that their choices mattered and that they experienced a crafted narrative. This isn't a contradiction—it's the art form.