This skill models a conversation as a graph: nodes hold lines, choices branch, conditions gate options, and one variable store remembers what the player did. Its first decision is build or adopt, Ink or Yarn Spinner when writers need real flow control and a small data-driven runner when lines, choices and flags are enough.
It covers the runner contract, line IDs for localization, where to apply costs, and validation with the Ink and Yarn command-line compilers or a graph validator.
What You Get
- A decision guide for Ink, Yarn Spinner or a custom runner, with the case each one suits
- A JSON dialogue graph example with line IDs, gated choices and variable changes on the transition
- Ink and Yarn Spinner examples for the same guard-and-bribe conversation
- A validation routine covering compile errors, dead ends, missing targets, undeclared variables and unreachable nodes
Common Use Cases
- Adding an NPC conversation with choices that depend on gold or earlier answers
- Fixing a dialogue that stalls because a node has no next step or end
- Preparing dialogue for translation by using line IDs from the start
- Choosing a dialogue tool for a Unity or Godot project
What Makes It Unique
It is built around the mistakes that waste a writer’s time: costs placed on a node that can be revisited, Ink once-only choices that empty a hub menu, undeclared Yarn variables that only warn, Yarn 3 syntax in a Yarn 2 project, and expression evaluation that would run arbitrary code from data files. It states a rule never to invent a new scripting language.
Under The Hood
The skill is instructions and two reference files, one on Ink and Yarn syntax and one holding a custom runner with a validator. It has no scripts of its own. It tells the agent to look at the project for existing dialogue files and integrations, and to run the Ink compiler inklecate or the Yarn console ysc on the files to check them, which reads the story files and can write compiled output. It does not fetch web pages or call APIs. It warns against running eval on dialogue expressions.