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.

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.

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 https://github.com/jame581/GodotPrompter

GitHub Copilot CLI

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

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 3 specialized agents:

Supported Platforms

Available Skills

Core / Process (6 skills)

Architecture & Patterns (6 skills)

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

Gameplay Systems (12 skills)

UI/UX (3 skills)

Multiplayer (3 skills)

Rendering & Visual (2 skills)

Build & Deploy (4 skills)

Scripting (3 skills)

Math & Data (1 skill)

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

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.