by jame581
Agentic skills framework for Godot 4.x. Domain-specific skills for AI coding agents (Claude Code, Copilot, Gemini, Cursor)
# Add to your Claude Code skills
git clone https://github.com/jame581/GodotPrompterGuides for using ai agents skills like GodotPrompter.
Last scanned: 6/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-03T08:55:35.703Z",
"npmAuditRan": true,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
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.
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.
# 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 extensions install https://github.com/jame581/GodotPrompter
copilot 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-prompter
See .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:
For each task, the agent loads the relevant domain skill:
player-controller + input-handling + state-machineinventory-system + resource-pattern3d-essentials + assets-pipelineparticles-vfx + shader-basicsanimation-system + tween-animationsave-loadAsk for a code review. The agent loads godot-code-review and checks against Godot-specific checklists.
godot-project-setup skill and scaffolds a complete directory structure, autoloads, input map, and .gitignore following Godot best practices.player-controller and input-handling skills, providing complete CharacterBody2D code with physics-correct movement in both GDScript and C#.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.3d-essentials skill with StandardMaterial3D PBR workflow, DirectionalLight3D shadow configuration, environment setup, and volumetric fog.particles-vfx skill with GPUParticles2D/3D recipes, ParticleProcessMaterial configuration, color ramps, and one-shot burst patterns.godot-code-reviewer agent with the godot-code-review skill to check node architecture, signal patterns, performance, input handling, and resource management.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 |
| 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 se