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.

48 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, and GDScript / C# patterns. All targeting Godot 4.3+ with both GDScript and C# examples — newer features from Godot 4.5 and 4.6 (variadic functions, abstract classes, stencil buffers, SoftBody3D forces, FoldableContainer, 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.

Gemini CLI

gemini extensions 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

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 | | 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-marketplace repo remains online so existing installs keep receiving updates, but new users should install from skillsmith.

Available Skills

Core / Process (6 skills)

| 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 |

Architecture & Patterns (6 skills)

| 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 |

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

| 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 |

Gameplay Systems (12 skills)

| 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 se