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 none of a Godot project's agent instructions files has a ## GodotPrompter section, the agent offers once to add one, since that is what subagents read. CLAUDE.md, AGENTS.md, GEMINI.md, .github/copilot-instructions.md and the .claude/rules/ and .cursor/rules/ directories all count — whichever agent they belong to — and the offer names the file your repo already keeps, so an agent-agnostic project is never asked to start a CLAUDE.md it does not want. It never adds the section silently, and a refusal is remembered in ~/.godot-prompter/state/ so you are asked once, not at every session start. Changed your mind? Just ask the agent to add the section; nothing has to be un-set by hand.

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:

Agent Purpose

godot-game-architect Designs systems, plans scene trees, chooses patterns

godot-game-dev Implements features guided by skills

godot-code-reviewer Reviews code against Godot best practices

godot-shader-author Authors custom shaders, post-processing, Compositor effects

godot-performance-profiler Diagnoses performance issues from profiler data

godot-animator Designs animation graphs, blend trees, IKModifier3D, BoneConstraint3D, retargeting

godot-csharp-engineer C#-first development; parity mode for closing this repo's C# debt

godot-ui-designer Builds Control-tree UI — themes, responsive layouts, localization-aware

godot-tools-engineer Editor plugins, custom inspectors, gizmos, @tool scripts, plugin distribution

Supported Platforms

Platform Status Install

Claude Code Primary claude plugins marketplace add jame581/skillsmith

Grok Build Supported grok plugin install jame581/GodotPrompter --trust

Antigravity CLI (agy) Supported agy plugin install https://github.com/jame581/GodotPrompter

GitHub Copilot CLI Supported copilot plugin marketplace add jame581/skillsmith

Cursor Supported /add-plugin godot-prompter or clone with .cursor-plugin/

Codex Supported Clone + symlink (see .codex/INSTALL.md)