Stats
Actions
Available In
Tags
Plugin
narrative-ink
Syntax reference, a formatter, and testing conventions for the Ink interactive-fiction language (inkle/ink). Skills auto-activate when editing .ink files.
What's Inside
Skills3
ink-style
/ink-style
Applies an opinionated set of Ink code formatting conventions to .ink files or ```ink code blocks in markdown. A Prettier-style formatter — whitespace/structure only, no semantic changes. Use when the user asks to format, clean up, or standardize Ink code style, or when editing Ink samples in docs.
ink-syntax
/ink-syntax
Provides syntax reference and authoring guidance for the Ink scripting language (inkle/ink). Use when writing, editing, or reviewing .ink files, when asked about Ink syntax, knots, stitches, choices, diverts, variables, lists, or any Ink language feature.
ink-testing
/ink-testing
Conventions for testing an Ink interactive fiction game with inkjs and vitest — how to write testable Ink code, when and how to write unit and integration tests, and what test helpers to set up. Use when writing or modifying tests, adding test coverage, or when a gameplay interaction warrants a new test.
README
narrative-ink-skills
Agent skills for Ink, inkle's narrative scripting language for interactive fiction.
This repository is a Claude Code plugin marketplace containing a single plugin,
narrative-ink, which bundles three skills:
| Skill | What it does |
|---|---|
ink-syntax | A condensed syntax reference for the Ink language — knots, stitches, choices, diverts, variables, lists, threads, tunnels, and common gotchas. Consult it when writing or reviewing .ink files. |
ink-style | A Prettier-style formatter for .ink files and ```ink code blocks in markdown. Whitespace and structure only — no semantic changes. |
ink-testing | Conventions for testing an Ink story compiled with inkjs and run under a JS test runner such as vitest — how to structure Ink for testability and when to write unit vs. integration tests. |
The skills follow the open Agent Skills standard, so they also work in Cursor, Codex, Gemini CLI, and other agentskills.io-compatible agents.
Install in Claude Code
/plugin marketplace add spaceninja/narrative-ink-skills
/plugin install narrative-ink@narrative-ink-skills
Once installed, the skills are namespaced under the plugin and invoked as
/narrative-ink:ink-syntax, /narrative-ink:ink-style, and
/narrative-ink:ink-testing. Claude also activates them automatically when a
task involves .ink files.
To update later, run /plugin marketplace update followed by /plugin update.
Install in other agents
The skills themselves are plain Agent Skills — only the
plugin.json / marketplace.json wrapper is Claude Code-specific. For any other
agentskills.io-compatible agent, copy the skill folders from
plugins/narrative-ink/skills/ into your agent's skills directory:
plugins/narrative-ink/skills/ink-syntax/
plugins/narrative-ink/skills/ink-style/
plugins/narrative-ink/skills/ink-testing/
The ink-style skill includes a Python 3 formatter (format-ink.py); it has no
third-party dependencies, but its --verify-blocks mode needs inkjs-compiler
on your PATH.
Attribution
The ink-style skill's test fixture crime-scene-formatted.ink is a formatted copy of
the "Long example: crime scene" from inkle's open-source
Writing with ink
tutorial.
License
MIT © 2026 Scott Vandehey
Stats
Version1.0.0
Released
LanguagePython
Stars0
MaintenanceGood
LicenseMIT
Last Commit
Added
Available In
Tags
Categories
