GodotPrompter

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

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.

32 skills covering project setup, architecture, gameplay systems, animation, shaders, audio, UI, multiplayer, optimization, and C# patterns. All targeting Godot 4.3+ with both GDScript and C# examples.

Quick Start

Claude Code (recommended)

# Add the marketplace
claude plugins marketplace add jame581/godot-prompter-marketplace

# Install the plugin
claude plugins install godot-prompter

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 jame581/godot-prompter-marketplace

GitHub Copilot CLI

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

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 + state-machine
• Adding inventory? → inventory-system + resource-pattern
• 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.

Agents

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

Supported Platforms

Platform	Status	Install
Claude Code	Primary	claude plugins marketplace add jame581/godot-prompter-marketplace
Gemini CLI	Supported	gemini extensions install jame581/godot-prompter-marketplace
GitHub Copilot CLI	Supported	copilot plugin marketplace add jame581/godot-prompter-marketplace
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)

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

Gameplay Systems (8 skills)

Skill	Description
player-controller	CharacterBody2D/3D movement — top-down, platformer, first-person
animation-system	AnimationPlayer, AnimationTree, blend trees, state machines, sprite animation
audio-system	Audio buses, music management, SFX pooling, spatial audio, dynamic mixing
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
camera-system	Smooth follow, screen shake, camera zones, transitions

UI/UX (3 skills)

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

Multiplayer (3 skills)

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

Rendering & Visual (1 skill)

Skill	Description
shader-basics	Godot shader language, visual shaders, common recipes, post-processing

Build & Deploy (3 skills)

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

C# Specific (2 skills)

Skill	Description
csharp-godot	C# conventions, GodotSharp API, project setup, GDScript interop
csharp-signals	[Signal] delegates, EmitSignal, async awaiting, event architecture

Validation

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.

Contributing

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

License

MIT