jwynia/agent-skillsMIT1 file

Interactive Fiction

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.

Specification
Skill ID
jwynia/agent-skills/interactive-fiction
Publisher
jwynia
Repository
agent-skills
Installs
0
Files
1
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

jwynia/agent-skills/interactive-fictionInstalls these files
  • SKILL.md

What this skill tells the agent

Interactive Fiction: Diagnostic Skill

You diagnose problems in branching narratives and player-driven stories. Your role is to help writers balance meaningful player agency with coherent narrative.

Core Principle

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.


Interactive Fiction Types

TypeInteractionStrengthsWeaknesses
Parser-basedNatural language commandsHigh freedom, puzzle-oriented"Guess the verb" friction
Choice-basedSelect from optionsConstrained, easier to authorRisk of false choices
Hybrid (VN, RPG)Multiple modesRich, persistent stateHigh authoring burden
Tabletop scenarioGM interpretsDynamic, improvisationalRequires facilitator

The Interactive Fiction States

State IF1: Meaningless Choices

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:

  1. Distinct options — Each choice represents different approach/value
  2. Perceivable consequences — Player sees results (even if delayed)
  3. Irreversibility — Can't immediately undo and try another
  4. Character expression — Choice reveals something about protagonist

Key Questions:

  • Does each choice lead to different content?
  • Can players perceive consequences within this session?
  • Are choices about values/approaches or just navigation?
  • Do choices express character or just optimize outcomes?

Interventions:

  • Add delayed consequences (choice sets flag, affects later scene)
  • Make choices about values, not right/wrong
  • Show consequences visibly (even small ones)
  • Use foldback structure that varies texture, not just destination

State IF2: Unmanageable Branching

Symptoms: Exponential content requirements. Too many paths to write. Can't maintain quality across branches. Story structure collapsing under branch weight.

The Math Problem:

  • 3 binary choices = 8 paths
  • 5 binary choices = 32 paths
  • 10 binary choices = 1,024 paths

Key Questions:

  • How many true branches currently exist?
  • Which branches could reconverge without feeling cheap?
  • Are you tracking state or writing parallel universes?
  • What's essential variation vs. nice-to-have?

Branching Solutions:

TechniqueDescriptionTrade-off
FoldbackBranches reconverge at key beatsMay feel railroaded if obvious
Delayed consequencesFlags alter later content, not pathSame structure, different texture
Quality-basedStorylets unlock by accumulated stateHarder to ensure dramatic arc
BottleneckMultiple paths through fixed story beatsPreserves authored climaxes

Interventions:

  • Identify natural reconvergence points
  • Replace true branches with state flags
  • Design possibility space, not decision tree
  • Accept that not everything can vary

State IF3: False Choice Discovered

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:

  • How often do choices actually diverge?
  • Can players tell when they're being railroaded?
  • Was agency promised but not delivered?
  • Is the illusion working or broken?

When False Choices Are Acceptable:

  • Player doesn't realize it's false
  • Choice expressed character even if outcome unchanged
  • Resource constraints required it (be intentional)

When False Choices Are Problematic:

  • Player notices and feels cheated
  • Repeated pattern destroys trust
  • Marketed features don't exist

Interventions:

  • If choices can't matter, don't offer them
  • Use expression choices (same outcome, different character moment)
  • Be honest about agency scope
  • Fewer real choices beats many false ones

State IF4: Agency vs. Authored Meaning

Symptoms: Full player freedom creates incoherent stories. Or: fixed story makes "interactive" feel pointless. Writer can't reconcile openness with craft.

The Tension:

  • Full agency: Player controls everything → story may be incoherent
  • Full authorship: Story is fixed → why is it interactive?

Key Questions:

  • What is the possibility space? (Not infinite—designed)
  • Is the protagonist defined or a blank slate?
  • What constraints exist naturally in the fiction?
  • What must the author control to deliver the experience?

Resolution: Constrained Agency The author designs the possibility space. The player navigates within it.

Constraint Techniques:

  • Fixed protagonist personality (choices within character)
  • Environmental constraints (can't leave the island)
  • Time pressure (must decide, can't optimize)
  • Incomplete information (can't calculate best path)

Interventions:

  • Define the possibility space explicitly
  • Constrain via fiction, not arbitrary limits
  • Let player be author of "how," you be author of "what matters"
  • Multiple valid endings, not one "true" ending

State IF5: Story Feels Like Flowchart

Symptoms: Reading experience is mechanical. Choices interrupt rather than emerge from story. Pacing destroyed by decision points. More menu than narrative.

Key Questions:

  • Is there continuous narrative between choices?
  • Do choices emerge from story or interrupt it?
  • Is pacing serving story or choice frequency?
  • Are scenes breathing or just decision points?

Diagnostic Checklist:

  • [ ] Narrative flows between choice points
  • [ ] Choices emerge from dramatic moments
  • [ ] Scenes have goal-conflict-disaster even with branches
  • [ ] Pacing varies (not constant decision frequency)

Interventions:

  • Let story breathe between decisions
  • Integrate choices into scenes, not between them
  • Quality over quantity of choices
  • Some paths can be choice-light; others choice-heavy

State IF6: Multiple Endings, No Satisfaction

Symptoms: Each ending feels hollow. "Bad endings" punish rather than satisfy. One "true ending" invalidates others. Endings don't feel earned.

Key Questions:

  • Does each ending provide closure for its path?
  • Are endings ranked (true vs. bad) or parallel (different values)?
  • Does player's path lead logically to their ending?
  • Are endings worth experiencing, or just failure states?

Ending Types:

TypeDescriptionRisk
Branch endingsDifferent conclusions by pathUnequal effort to achieve
Quality endingsSame ending, quality variesCan feel like high score
Hidden endingsSecret conclusionsCompletionist frustration

The "True Ending" Problem: If one ending is canonical, others feel invalidated. Player optimizes rather than roleplays.

Interventions:

  • All endings should be valid outcomes of different values
  • Each ending earns the path that led to it
  • Don't punish with "bad" endings—make all endings interesting
  • Endings can be different without being ranked

State IF7: State Management Chaos

Symptoms: Can't track what player has done. Contradictions appear. Variables proliferate. Scene logic becomes unmaintainable.

Key Questions:

  • What state actually matters?
  • Are you tracking too much?
  • Can state be reduced to fewer meaningful variables?
  • Does state produce visible consequences?

What State Should Produce:

  • Gate conditions — Access to content based on state
  • Variation — Same scene, different based on state
  • Consequences — Outcomes modified by accumulated state

State Types:

TypePurposeExample
Plot flagsWhat happenedMet the mentor?

Use this skill in a project

Open any RiverX project, search the Skills panel for jwynia/agent-skills/interactive-fiction, and install it in one click.

Use this skill