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.
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.
44 skills covering project setup, architecture, gameplay systems, input handling, physics, 2D/3D systems, animation, shaders, audio, UI, multiplayer, localization, procedural generation, XR/VR, optimization, and C# patterns. All targeting Godot 4.3+ with both GDScript and C# examples.
# Add the marketplace
claude plugins marketplace add jame581/skillsmith
# Install the plugin
claude plugins install godot-prompter@skillsmithOr install from a local clone:
git clone https://github.com/jame581/GodotPrompter.git
claude plugins marketplace add ./GodotPrompter
claude plugins install godot-prompter@godot-prompterThen 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.
gemini extensions install https://github.com/jame581/GodotPromptercopilot plugin marketplace add jame581/skillsmith
copilot plugin install godot-prompter@skillsmith/add-plugin godot-prompter
Or clone and place in your project — Cursor reads .cursor-plugin/plugin.json.
git clone https://github.com/jame581/GodotPrompter.git ~/.codex/godot-prompter
mkdir -p ~/.agents/skills
ln -s ~/.codex/godot-prompter/skills ~/.agents/skills/godot-prompterSee .codex/INSTALL.md for Windows instructions.
Add to opencode.json:
{
"plugin": ["godot-prompter@git+https://github.com/jame581/GodotPrompter.git"]
}See .opencode/INSTALL.md for details.
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
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
Ask for a code review. The agent loads godot-code-review and checks against Godot-specific checklists.
- "Set up a new Godot project" — Loads the
godot-project-setupskill 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-controllerandinput-handlingskills, 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-architectagent to plan the system withai-navigation,state-machine, andanimation-systemskills, then thegodot-game-devagent to implement it. - "Set up a 3D scene with lighting, materials, and fog" — Loads
3d-essentialsskill with StandardMaterial3D PBR workflow, DirectionalLight3D shadow configuration, environment setup, and volumetric fog. - "Add particle effects for explosions and fire" — Loads
particles-vfxskill with GPUParticles2D/3D recipes, ParticleProcessMaterial configuration, color ramps, and one-shot burst patterns. - "Review my code for Godot best practices" — Uses the
godot-code-revieweragent with thegodot-code-reviewskill to check node architecture, signal patterns, performance, input handling, and resource management.
GodotPrompter includes 3 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 |
| Platform | Status | Install |
|---|---|---|
| Claude Code | Primary | claude plugins marketplace add jame581/skillsmith |
| Gemini CLI | Supported | gemini extensions 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) |
| OpenCode | Supported | Add to opencode.json (see .opencode/INSTALL.md) |
Legacy marketplace: The
godot-prompter-marketplacerepo remains online so existing installs keep receiving updates, but new users should install fromskillsmith.
| Skill | Description |
|---|---|
using-godot-prompter |
Bootstrap — skill catalog, workflow guide, platform setup |
godot-project-setup |
Scaffold directory structure, autoloads, .gitignore, input maps |
godot-brainstorming |
Scene tree planning, node selection, architectural decisions |
godot-code-review |
Review checklist — best practices, anti-patterns, Godot pitfalls |
godot-debugging |
Remote debugger, print techniques, signal tracing, error patterns |
godot-testing |
TDD with GUT and gdUnit4 — test structure, mocking, CI |
| Skill | Description |
|---|---|
scene-organization |
Scene tree composition, when to split scenes, node hierarchy |
state-machine |
Enum-based, node-based, resource-based FSM with trade-offs |
event-bus |
Global EventBus autoload with typed signals, decoupled communication |
component-system |
Hitbox/Hurtbox/Health components, composition over inheritance |
resource-pattern |
Custom Resources for items, stats, config, editor integration |
dependency-injection |
Autoloads, service locators, @export injection, scene injection |
| Skill | Description |
|---|---|
physics-system |
RigidBody, Area, raycasting, collision shapes, Jolt, ragdolls, interpolation |
2d-essentials |
TileMaps, parallax, 2D lights/shadows, particles, custom drawing, canvas layers |
3d-essentials |
Materials, lighting, shadows, environment, GI, fog, LOD, occlusion, decals |
xr-development |
OpenXR, XROrigin3D, hand tracking, controllers, passthrough, Meta Quest |
| Skill | Description |
|---|---|
player-controller |
CharacterBody2D/3D movement — top-down, platformer, first-person |
input-handling |
InputEvent system, Input Map actions, controllers/gamepads, mouse/touch, action rebinding |
animation-system |
AnimationPlayer, AnimationTree, blend trees, state machines, sprite animation |
tween-animation |
Tween class, easing, chaining, parallel sequences, common motion recipes |
audio-system |
Audio buses, music management, SFX pooling, spatial audio, interactive music |
inventory-system |
Resource-based items, slot management, stacking, UI binding |
dialogue-system |
Branching dialogue trees, conditions, UI presentation |
save-load |
ConfigFile, JSON, Resource serialization, version migration |
ai-navigation |
NavigationAgent2D/3D, steering behaviors, patrol patterns, async baking |
camera-system |
Smooth follow, screen shake, camera zones, transitions |
localization |
TranslationServer, CSV/PO files, locale switching, RTL support, pluralization |
procedural-generation |
Noise, BSP dungeons, cellular automata, WFC, seeded randomness |
| Skill | Description |
|---|---|
godot-ui |
Control nodes, themes, anchors, containers, layout patterns |
responsive-ui |
Multi-resolution scaling, aspect ratios, DPI, mobile adaptation |
hud-system |
Health bars, score displays, minimap, damage numbers, notifications |
| Skill | Description |
|---|---|
multiplayer-basics |
MultiplayerAPI, ENet/WebSocket, RPCs, authority model |
multiplayer-sync |
MultiplayerSynchronizer, interpolation, prediction, lag compensation |
dedicated-server |
Headless export, server architecture, lobby management |
| Skill | Description |
|---|---|
shader-basics |
Godot shader language, visual shaders, common recipes, post-processing |
particles-vfx |
GPUParticles2D/3D, process materials, subemitters, trails, attractors, collision |
| Skill | Description |
|---|---|
export-pipeline |
Platform exports, CI/CD with GitHub Actions, itch.io/Steam deploy |
godot-optimization |
Profiler, draw calls, physics tuning, object pooling, bottlenecks |
addon-development |
EditorPlugin, @tool scripts, custom inspectors, dock panels |
assets-pipeline |
Image compression, 3D scene import, audio formats, resource management |
| Skill | Description |
|---|---|
gdscript-patterns |
Static typing, await/coroutines, lambdas, match, exports, common idioms |
csharp-godot |
C# conventions, GodotSharp API, project setup, GDScript interop |
csharp-signals |
[Signal] delegates, EmitSignal, async awaiting, event architecture |
| Skill | Description |
|---|---|
math-essentials |
Vectors, transforms, interpolation, curves, paths, RNG, game math recipes |
Skills were validated against a real Godot 4.3+ trial project (top-down 2D action RPG):
- 13/15 skills PASS — guidance worked as documented
- 2/15 skills PARTIAL — minor gotchas documented and fixed
- 0/15 skills FAIL
See tests/trial-project/VALIDATION.md for detailed results.
See CONTRIBUTING.md for how to add new skills, conventions, and testing requirements.
- 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.