GodotPrompter

Agentic skills framework for Godot 4.x game development. Gives AI coding agents domain-specific expertise for GDScript and C# projects.

Inspired by and built on top of the Superpowers plugin for Claude Code — which provides the underlying skill loading, brainstorming, and workflow infrastructure that GodotPrompter extends with Godot-specific domain knowledge.

What is this?

GodotPrompter is a plugin that provides skills — structured domain knowledge that AI agents load on demand. When you ask your agent to "add a state machine" or "set up multiplayer", it loads the relevant GodotPrompter skill and follows Godot-specific best practices instead of relying on generic knowledge.

55 skills covering project setup, architecture, gameplay systems, input handling, physics, 2D/3D systems, animation, shaders, audio, UI, multiplayer, localization, procedural generation, XR/VR, native extensions, multithreading, mobile shipping, optimization, GDScript / C# patterns, a teaching mode, and third-party addons (LimboAI, Beehave, Popochiu, Dialogue Manager, Phantom Camera). All targeting Godot 4.3+ with both GDScript and C# examples — newer features from Godot 4.5, 4.6, and 4.7 (variadic functions, abstract classes, stencil buffers, AreaLight3D, VirtualJoystick, OpenXR Spatial Entities, and more) are included as annotated additive sections.

v1.7.0 introduces a 16 KB token budget for SKILL.md files (validator-enforced) and the new gdscript-advanced skill for production-grade GDScript depth (performance idioms, metaprogramming, @tool lifecycle, profiler-driven idioms).

v1.9.0 adds native power and mobile shipping — the new gdextension (godot-cpp / Rust native extensions), multithreading (WorkerThreadPool, threads, threaded loading), and mobile-development (Android/iOS export, lifecycle, plugins, IAP) skills.

Quick Start

Claude Code (recommended)

# Add the marketplace
claude plugins marketplace add jame581/skillsmith

# Install the plugin
claude plugins install godot-prompter@skillsmith

Or install from a local clone:

git clone https://github.com/jame581/GodotPrompter.git
claude plugins marketplace add ./GodotPrompter
claude plugins install godot-prompter@godot-prompter

Then start a new session and ask:

"I'm starting a new Godot 4.3 project. How should I organize it?"

The agent loads the godot-project-setup skill and provides a complete directory structure, autoload setup, and .gitignore — not generic advice.

Grok Build

grok plugin install jame581/GodotPrompter --trust
grok plugin enable godot-prompter

Pin to a release:

grok plugin install jame581/GodotPrompter@v1.11.0 --trust
grok plugin enable godot-prompter

Antigravity CLI (agy)

agy plugin install https://github.com/jame581/GodotPrompter

GitHub Copilot CLI

copilot plugin marketplace add jame581/skillsmith
copilot plugin install godot-prompter@skillsmith

Cursor

/add-plugin godot-prompter

Or clone and place in your project — Cursor reads .cursor-plugin/plugin.json.

Codex

git clone https://github.com/jame581/GodotPrompter.git ~/.codex/godot-prompter
mkdir -p ~/.agents/skills
ln -s ~/.codex/godot-prompter/skills ~/.agents/skills/godot-prompter

See .codex/INSTALL.md for Windows instructions.

OpenCode

Add to opencode.json:

{
  "plugin": ["godot-prompter@git+https://github.com/jame581/GodotPrompter.git"]
}

See .opencode/INSTALL.md for details.

How It Works

Automatic activation

GodotPrompter registers a SessionStart hook that injects its skill-routing card when it detects a Godot project. It looks for project.godot up to four directories above your working directory and up to three below it, so the common monorepo layout — docs and tooling at the repo root, the engine project in source/, game/, or godot/ — is detected when you open a session at the root. Vendored addons/ and dot-directories are skipped, so a plugin's bundled demo project is never mistaken for yours. In any other repository the hook does nothing at all.

The hook reads only your project's project.godot and its own state file under your home directory, makes no network requests, and writes nothing. If bash is unavailable on Windows it exits silently and the plugin behaves exactly as it did before v1.13.0.

Verified end-to-end on Claude Code and GitHub Copilot CLI. Cursor's registration ships but is not yet confirmed. Codex and Antigravity have no hook mechanism and continue to load the bootstrap through AGENTS.md / GEMINI.md.

The hook covers your session. Subagents do not receive it — SessionStart does not fire on subagent dispatch. When a Godot project's CLAUDE.md has no ## GodotPrompter section, the agent offers once to add one, since that is what subagents read. It never adds it silently.

Mentor mode

Say "teach me as we go" in a Godot project and GodotPrompter switches to teaching delivery: the Godot concept and why that node, the editor setup, annotated GDScript and C#, what to verify when you run it, and one suggested next step. It wraps the domain skills rather than replacing them, so the guidance stays version-checked.

Your preference is remembered per project in ~/.godot-prompter/state/ — nothing is written into your game repository. Say "just give me the code" to turn it off.

1. Design Phase

Ask the agent to brainstorm a feature. It loads godot-brainstorming and walks you through:

• Clarifying questions about your game/system
• Architectural approaches with trade-offs
• Scene tree design, signal maps, and data flow
• An implementation plan with ordered tasks

2. Implementation Phase

For each task, the agent loads the relevant domain skill:

• Building a player? → player-controller + input-handling + state-machine
• Adding inventory? → inventory-system + resource-pattern
• Setting up 3D scene? → 3d-essentials + assets-pipeline
• Adding particles? → particles-vfx + shader-basics
• Need animations? → animation-system + tween-animation
• Need save/load? → save-load

3. Review Phase

Ask for a code review. The agent loads godot-code-review and checks against Godot-specific checklists.

Example Use Cases

• "Set up a new Godot project" — Loads the godot-project-setup skill and scaffolds a complete directory structure, autoloads, input map, and .gitignore following Godot best practices.
• "Add a platformer player controller with coyote time and jump buffering" — Loads player-controller and input-handling skills, providing complete CharacterBody2D code with physics-correct movement in both GDScript and C#.
• "Design an enemy AI system with patrol, chase, and attack" — Uses the godot-game-architect agent to plan the system with ai-navigation, state-machine, and animation-system skills, then the godot-game-dev agent to implement it.
• "Set up a 3D scene with lighting, materials, and fog" — Loads 3d-essentials skill with StandardMaterial3D PBR workflow, DirectionalLight3D shadow configuration, environment setup, and volumetric fog.
• "Add particle effects for explosions and fire" — Loads particles-vfx skill with GPUParticles2D/3D recipes, ParticleProcessMaterial configuration, color ramps, and one-shot burst patterns.
• "Review my code for Godot best practices" — Uses the godot-code-reviewer agent with the godot-code-review skill to check node architecture, signal patterns, performance, input handling, and resource management.

Agents

GodotPrompter includes 9 specialized agents:

Supported Platforms

Legacy marketplace: The godot-prompter-marketplace repo remains online so existing installs keep receiving updates, but new users should install from skillsmith.

Available Skills

Core / Process (7 skills)

Architecture & Patterns (6 skills)

Physics, 2D/3D & XR (4 skills)

Gameplay Systems (13 skills)

UI/UX (3 skills)

Multiplayer (3 skills)

Rendering & Visual (2 skills)

Build & Deploy (5 skills)

Scripting (4 skills)

Native & Performance (2 skills)

Math & Data (1 skill)

Third-Party Addons (5 skills)

These skills cover community addons with pinned versions — LimboAI v1.8.0, Beehave v2.9.2, Popochiu v2.1.1, Dialogue Manager v3.10.4, and Phantom Camera v0.11.0.2. They require the corresponding addon to be installed in your project.

Validation

Quality is enforced by an automated validator that runs on every release tag. Human-readable run:

node scripts/validate-skills.mjs           # exit 1 on errors, 0 otherwise
node scripts/validate-skills.mjs --json    # machine-readable for CI

The validator (scripts/validate-skills.mjs) checks every skills/*/SKILL.md and agents/*.md against these rules:

Hook behaviour is covered separately by npm run test:hooks (22 cases), which also runs on release tags.

Token cost reporting:

node scripts/count-tokens.mjs --tokenizer --markdown

Produces a per-skill / per-agent table (bytes, KB, estimated tokens, Claude / GPT tokenizer counts, status) that lives between <!-- BEGIN-TOKEN-TABLE --> markers in docs/token-budget.md.

CI gate: .github/workflows/release.yml runs both node scripts/validate-skills.mjs and a tag-vs-manifest version-consistency check on every v*.*.* push. The release is blocked if the validator returns errors or any of package.json / .claude-plugin/plugin.json / .claude-plugin/marketplace.json / .cursor-plugin/plugin.json / plugin.json drifts from the tag.

Current baseline (v1.12.0): 0 errors, 16 warnings (all csharp-parity-accepted for intentionally GDScript-only skills; 0 token-budget). Every SKILL.md is under the 16 KB budget — since v1.12.0 that is a validator error, not a warning, so an over-budget skill fails the release.

A manual agent-integration test plan covering full workflows (skill discovery, cross-reference navigation, end-to-end feature implementation) lives in tests/agent-integration/TEST_PLAN.md for spot-checks against new agent versions or platforms.

Contributing

See CONTRIBUTING.md for how to add new skills, conventions, and testing requirements.

Acknowledgements

The SessionStart hook's polyglot Windows wrapper, JSON escaper, and platform output branching are adapted from Superpowers by Jesse Vincent (MIT).

License

MIT

Author

• Jan Mesarč - Creator - janmesarc.online/

Do you like this project and want to support me? Great! I really appreciate it and it makes me very happy if you Buy Me A Coffee.