interactive-fiction SKILL.md skillA

interactive-fiction from danjdewhurst/story-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add danjdewhurst/story-skills/interactive-fiction@git:20261014.4b8019d

Pins git:20261014.4b8019d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
danjdewhurst/story-skills
Path
skills/interactive-fiction/SKILL.md
Versions recorded
6
Latest version
git:20261014.4b8019d, committed Oct 14, 2026
First version recorded
Oct 7, 2026
Size
13,181 bytes
Repository stars
382
License
MIT

This skill should be used when the user asks to "write a branching story", "interactive fiction", "choose your own adventure", "plan the branches", "choice graph", "add a choice", "gamebook", "Twine", "Ink", "draft a branch", "where the branches rejoin", "add an ending", "unreachable chapter", "path continuity", "state-differs-by-path", or wants to plan, draft, or revise a story project whose chapters carry `choices`. NOT for turning a finished linear book into an interactive edition in Ink or…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Interactive Fiction

## Overview

Plan, draft, and revise a branching book: a story project whose chapters
are passages joined by `choices` in their frontmatter. The chapters and
their choices are the source of truth. `story continuity` follows the paths
of choices, and `story build --format twee` or `--format ink` turns the
project into a playable Twine or ink story.

This skill owns books written to branch from the start. Turning an existing
linear book into an interactive edition (a branch map drawn from its scenes,
then a copied project) belongs to the `adaptation` skill; once that edition
project exists, draft and revise its chapters here.

## Prerequisites

A story project with `story.md` in the root. For a new book, start it with
the `story-init` skill first. Read `story.md` (`language`, `pov`, `tense`,
`form`, `status`, `ifid`) and `chapters/_index.md`, then the `choices` of
every chapter: together they are the graph. A small example is
[`examples/the-gull-rock-light`](../../examples/the-gull-rock-light/), a
branch-and-bottleneck story with two endings.

## When to Use

- Planning a choice graph: structure, branch points, rejoins, endings
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add danjdewhurst/story-skills/interactive-fiction@sha256:0b9d62495c0501ef

The line at the top of this page pins the label git:20261014.4b8019d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_gnhoims2fxf5gojg.svg)](https://markdownregistry.com/a/art_gnhoims2fxf5gojg)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Oct 7, 2026 and Oct 14, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261014.4b8019d latest2026-10-14 4b8019d 13,181 BA view · diff
git:20261007.983a95d2026-10-07 983a95d 13,040 BA view · diff
git:20261007.a8b3f012026-10-07 a8b3f01 12,729 BA view · diff
git:20261007.484ba492026-10-07 484ba49 12,695 BA view · diff
git:20261007.82fb53e2026-10-07 82fb53e 12,679 BA view · diff
git:20261007.86329422026-10-07 8632942 12,604 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13181 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

danjdewhurst/story-skills · 382 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gnhoims2fxf5gojg
GET https://markdownregistry.com/api/v1/resolve?ref=danjdewhurst/story-skills/interactive-fiction
GET https://markdownregistry.com/api/v1/blob/0b9d62495c0501eff8b66c447033fba5d7210fe2c933e0e6e28f7c833d33c7d4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from danjdewhurst/story-skills

AGENTS.md AGENTS.md file
danjdewhurst/story-skills · AGENTS.md
git:20261101.ee29402 · audit B · 382 stars
CLAUDE.md CLAUDE.md file
danjdewhurst/story-skills · CLAUDE.md
git:20260901.e521c75 · audit B · 382 stars
adaptation SKILL.md skill
danjdewhurst/story-skills · skills/adaptation/SKILL.md · This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway"…
git:20261014.4b8019d · audit A · 382 stars
chapter-writing SKILL.md skill
danjdewhurst/story-skills · skills/chapter-writing/SKILL.md · This skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter"…
git:20261014.4b8019d · audit A · 382 stars
character-management SKILL.md skill
danjdewhurst/story-skills · skills/character-management/SKILL.md · This skill should be used when the user asks to "create a character", "update a character", "add a character", "build a…
git:20261102.6098078 · audit A · 382 stars
discovery-drafting SKILL.md skill
danjdewhurst/story-skills · skills/discovery-drafting/SKILL.md · This skill should be used when the user asks about "pantsing", "discovery write", "write without an outline"…
git:20261014.4b8019d · audit A · 382 stars
editorial-review SKILL.md skill
danjdewhurst/story-skills · skills/editorial-review/SKILL.md · This skill should be used when the user asks for a "sensitivity reader", "authenticity reader", "cultural review", "is…
git:20261102.e86f75d · audit A · 382 stars
feedback-triage SKILL.md skill
danjdewhurst/story-skills · skills/feedback-triage/SKILL.md · This skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback…
git:20261014.2fdb6da · audit A · 382 stars
genre-craft SKILL.md skill
danjdewhurst/story-skills · skills/genre-craft/SKILL.md · This skill should be used when the user asks about "mystery", "fair play", "clue", "red herring", "romance beats"…
git:20261014.4b8019d · audit A · 382 stars
line-editing SKILL.md skill
danjdewhurst/story-skills · skills/line-editing/SKILL.md · This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the…
git:20261014.4b8019d · audit A · 382 stars
plot-structure SKILL.md skill
danjdewhurst/story-skills · skills/plot-structure/SKILL.md · This skill should be used when the user asks to "create a plot arc", "story structure", "add a plot point", "story…
git:20261102.6098078 · audit A · 382 stars
premise-workshop SKILL.md skill
danjdewhurst/story-skills · skills/premise-workshop/SKILL.md · This skill should be used when the user asks to "brainstorm a story idea", "I have an idea for a story", "what if"…
git:20261014.4b8019d · audit A · 382 stars

Every file in danjdewhurst/story-skills

Browse by kind, by grade A, or by owner.