2.9 KiB
Bundled agent skills
The addon ships two agent skills alongside the toolkit — small, self-contained instruction packs that make an AI coding agent better at driving this MCP surface. They live in addons/godot_mcp_toolkit/CompanionSkills/, one folder per skill. They are optional: the toolkit works without them, but installing them improves how an agent uses it.
Installing a skill — copy the skill's whole folder (including its references/ subfolder) from addons/godot_mcp_toolkit/CompanionSkills/<skill>/ into your client's skills directory, e.g. .claude/skills/. Copy the entire folder, not just the top-level file — the references/ material is part of the skill.
Two skills ship:
godot-mcp-toolkit — the toolkit workflow skill
What it is. The workflow skill teaches an agent how to use this toolkit well: which tool to reach for, how to batch tool calls, how to recover from errors, and how to keep token usage down when driving an MCP-connected editor. It is general-purpose guidance for any build — install it and the agent makes better tool choices from the first request.
How to install. Copy addons/godot_mcp_toolkit/CompanionSkills/godot-mcp-toolkit/ — the whole folder, including references/ — into your client's skills directory (e.g. .claude/skills/).
Why. It measurably reduces the agent's tool calls, tokens, and wall-clock on a typical build. In a controlled two-wave run — the same game built with and without the skill, at the same toolkit and server version — the skill arm used fewer tool calls, fewer output tokens, less wall-clock, and less money, while completing the same build. The measured figures, the exact scope (game, model, run count, versions), and the honest caveats are published here: https://github.com/NPGameDev/godot-mcp-server/blob/main/docs/companion-skill-efficiency.md.
mcp-extension-creator — the extension-authoring skill
What it is. This toolkit lets a project register its own MCP tools in GDScript — project-specific helpers the agent calls like built-ins. The extension-authoring skill eases the workflow of creating those new tools: it walks an agent through authoring a distributable MCP extension end-to-end, and it carries an opt-in guided-authoring mode that turns extension creation into an interactive design conversation. Install it when you want the agent to build or extend the toolkit's tool surface for your project.
How to install. Copy addons/godot_mcp_toolkit/CompanionSkills/mcp-extension-creator/ — the whole folder, including references/ — into your client's skills directory (e.g. .claude/skills/).
Learn more. The extension configuration surface it guides you through — how tools are registered, timeouts, cancellation, hot-reload, and C# support — is documented in extending.md, which is the source of truth for writing an extension by hand.