Narrative Ink

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