Dialogue Systems Skill for Claude Code: What It Does and How to Install It

Makes Claude build branching game dialogue as a graph of nodes, choices, conditions and variables, in any engine.

Installs: 8.5K; on skills.sh
Stars: 6.4K; on GitHub
Files: 2; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill walks Claude through six steps: pick an authoring approach, define the node contract, keep variables separate from flow, localize with line IDs, drive the runner from the game loop, and test every branch. It includes 4 patterns: an engine-neutral JSON graph, a GDScript runner step, an Ink script and a Yarn Spinner script.

It loads when you mention dialogue systems, branching dialogue, conversation trees, choices, Ink, Yarn Spinner or NPC dialogue. It is engine-neutral. For text boxes and choice buttons it points to the godot-ui-control skill instead. The folder holds SKILL.md and 2 reference files, with no scripts.

Good for

Game developers adding NPC conversations or choice menus
Narrative designers choosing between Ink, Yarn Spinner and a custom format
Developers who need a small data-driven dialogue runner instead of a new scripting language

Install dialogue-systems

Claude Code

Copy this prompt.

Install the dialogue-systems skill in Claude Code. Run this command:

claude plugin marketplace add gamedev-skills/awesome-gamedev-agent-skills
claude plugin install disciplines@awesome-gamedev-agent-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The disciplines plugin installs 15 cross-engine skills and the gamedev plugin installs the router plus 77 skills (counts from the repo marketplace file and tree). The README says to install the router too if you want it to pick skills for you. The skills CLI command here installs only dialogue-systems; the README command without --skill installs the whole repo.

From the project README. Source.

What's in the skill

When it loads

Build branching dialogue and narrative — a node/choice graph with conditions, variables, and localization hooks — and choose between authoring tools Ink and Yarn Spinner or a custom data-driven runner. Engine-neutral. Use when the user mentions dialogue system, branching dialogue, conversation tree, choices, Ink (.ink), Yarn Spinner (.yarn), or NPC dialogue.

Sections in SKILL.md

When to use
Core workflow
Patterns
1. Engine-neutral dialogue graph (data, not code)
2. Runner step (a state machine over the graph)
3. Ink — branching with knots, choices, and variables (inkle)
4. Yarn Spinner — nodes, options, and commands (Yarn Spinner 3.x)
Pitfalls
References
Related skills

Key facts

Author: gamedev-skills (repo owner; awesome-gamedev-agent-skills)
Repo: gamedev-skills/awesome-gamedev-agent-skills
License: Apache-2.0 (LICENSE and README badge agree)
Installs on skills.sh: 8,514 (Nov 2, 2026)
GitHub stars: 6,567 for the whole repo (Nov 2, 2026)
Last repo commit: Oct 28, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 3 files: SKILL.md, references/ink-and-yarn.md and references/runner.md; no scripts
Part of: The disciplines plugin (15 skills) and the gamedev plugin (the router plus 77 skills)

What it includes

Compares Ink, Yarn Spinner and a custom JSON or resource graph.
SKILL.md says not to build a language, build a graph.
Try: “Should I use Ink or Yarn Spinner for my game?”
1. Choose the authoring approach
A node yields a line, choices, a command, or an end or jump.
2. Define the node contract
Keeps a variable store that choices read and write.
3. Separate variables from flow
Uses line IDs and a string table instead of raw strings.
4. Localize from the start
Treats the runner as a state machine that waits for input.
5. Drive it from the game loop
Tests each path, condition and variable write, and checks every branch ends.
Read · 6. Verify by walking branches
A JSON graph with line IDs, conditions (if) and state changes (set).
Pattern 1 of 4 in SKILL.md.
Write · Pattern: engine-neutral graph
A goto and choose state machine over the graph, written for Godot 4.7.
Write · Pattern: runner step in GDScript
Example scripts with a gold check and a bribe option in both tools.
The Yarn example is marked Yarn Spinner 3.x.
Write · Pattern: Ink and Yarn Spinner
Full custom runner: graph schema, expressions, variable store, localization.
Read · Reference: runner.md
Side-by-side syntax cheat sheet and integration notes.
Read · Reference: ink-and-yarn.md

From the official docs

Questions

What does the dialogue-systems skill do?

It makes Claude model conversations as a graph of nodes with choices, conditions and variables. It helps you choose between Ink, Yarn Spinner and a custom runner, and shows how to wire the result into a game loop.

How do I install it?

Use the install box at the top of this page. The README and docs/INSTALLATION.md document Claude Code plugins and a skills CLI command that installs the whole repo (it needs Node.js 22.20 or later). The box also has a command for this skill alone.

Which engines does it work with?

The description says it is engine-neutral. Its runner example is GDScript for Godot 4.7, and the Ink and Yarn Spinner examples are not tied to an engine.

Does it work in the Claude app?

The install box has a Claude app upload route for this folder. The README does not describe that route; it is our generated steps for a folder of plain Markdown, which is all this skill holds (SKILL.md and 2 reference files, no scripts).

Does it need an API key?

SKILL.md names no API key and the folder bundles no scripts.

Is it safe?

The folder holds markdown only. Claude uses it to write dialogue data and runner code in your project, so review that code like any other change.

Do I need the router or the other game skills?

No. SKILL.md lists save-systems, godot-resources, unity-scriptableobjects, godot-ui-control, visual-novel and rpg as related skills for other jobs, but nothing in it requires them. The README says its router picks skills for you if you install the whole set.

Ink vs Yarn Spinner?

SKILL.md says Ink is prose-first and writer-friendly with weave and gather flow, good for dialogue-heavy or choose-your-own-adventure stories. Yarn Spinner is node-based with explicit commands and suits game-driven dialogue with many engine hooks.

Information

updated Nov 2, 2026

Repository: gamedev-skills/awesome-gamedev-agent-skills
Folder: skills/disciplines/dialogue-systems

gamedev-skills/awesome-gamedev-agent-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

awesome-gamedev-agent-skills README · github.com
INSTALLATION.md · github.com
awesome-gamedev-agent-skills marketplace.json · github.com
dialogue-systems SKILL.md · github.com
runner.md · github.com
ink-and-yarn.md · github.com