jwynia avatar

Interactive Fiction

This is a diagnostic tool for writers stuck in the classic interactive fiction traps: meaningless choices that all funnel to the same outcome, exponential branching that becomes impossible to write, or that awful moment when players realize their agency was an illusion. It walks you through seven failure states with concrete tests like whether choices are about values versus just navigation, and gives you actual branching techniques like foldback structures and delayed consequences. The core insight is solid: the tension between player freedom and narrative coherence is a false dilemma, you just need to design the possibility space intentionally. Most useful when you're three months into a project and the branch count is making you want to quit.

skills.sh installs
587
GitHub stars
182
last updated
Aug 21, 2026

Install

$ npx -y skills add jwynia/agent-skills --skill interactive-fiction --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/jwynia/agent-skills
Categories
AI & Agent Building, Debugging
First seen
Jun 3, 2026

More from jwynia/agent-skills

All 118
1getsentry avatarsentry-react-sdkgetsentry/sentry-agent-skillsFull Sentry SDK setup for React. Use when asked to "add Sentry to React", "install @sentry/react", or configure error monitoring, tracing, session replay, profi586skills.sh installs
2plugin87 avatardesign-tokensplugin87/ux-ui-agent-skillsGenerate, extend, or audit design tokens in DTCG format with the 3-tier architecture (primitive → semantic → component). Use when the user wants a color palette585skills.sh installs
3shiplightai avatartriageshiplightai/agent-skillstriage584skills.sh installs
4aj-geddes avatartechnical-roadmap-planningaj-geddes/useful-ai-promptsCreate comprehensive technical roadmaps aligned with business goals. Plan technology investments, architecture evolution, and infrastructure improvements over q582skills.sh installs
5aj-geddes avataraccessibility-testingaj-geddes/useful-ai-promptsTest web applications for WCAG compliance and ensure usability for users with disabilities. Use for accessibility test, a11y, axe, ARIA, keyboard navigation, sc580skills.sh installs
6aj-geddes avatarpush-notification-setupaj-geddes/useful-ai-promptsImplement push notifications for iOS and Android. Covers Firebase Cloud Messaging, Apple Push Notification service, handling notifications, and backend integrat580skills.sh installs