> For the complete documentation index, see [llms.txt](https://fehdead.gitbook.io/npc-kit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fehdead.gitbook.io/npc-kit/llm-skill.md).

# NPC Kit LLM Skill

**An installable skill that teaches an LLM coding assistant to write NPC Kit NPCs from the documented calls, instead of guessing.**

***

### What it does

A skill is reference material plus instructions that an LLM coding assistant (Claude Code, Codex, Cursor, Gemini CLI) reads before it writes code. With this one installed, ask for an NPC in your own words ("a Seeq in the Muthru Bazaar who sells a tip for 100 gil") and the assistant writes it with `npc.add`, the kit's dialogs, cameras and scenes, and the VM calls NPCs use, each with its own page: arguments, timing, what it does on a kit NPC, an example.

It asks you for what it can't know: where the NPC stands, camera shots, sound ids. Find those with [NPC Kit Editor](https://fehdead.gitbook.io/npc-kit/editor.md) in the game.

***

### Download and install

One zip with the skill and an installer. Unzip it and run `install.bat`: it asks which assistant to install for and copies the skill into place. The included `README.md` explains installing it into one project only.

{% file src="/files/ItMJkxiLf3gLFVgMYK83" %}
npc-kit v1.0.0: NPC Kit skill
{% endfile %}

{% hint style="info" %}
**The skill covers the calls it documents, not every VM call.** For a call it has no page for, it tells you so instead of guessing. More calls are added over time.
{% endhint %}

{% hint style="danger" %}
**An LLM still makes mistakes.** Review and test in the game every NPC it writes before you ship it.
{% endhint %}
