Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

godot-mcp-skills

Claude Code skills for Godot 4 game development via the godot-mcp-pro server.

What This Does

Provides 5 high-level workflow skills that chain godot-mcp-pro's 155+ low-level tools into composite automation workflows with visual verification. Each skill is a hybrid (structured steps + adaptive branching) that routes to different MCP tool chains based on context.

Skills

Skill Triggers What It Does
godot-scene-builder build scene, add nodes, create level Compose scenes via MCP with screenshot verification
godot-debugger debug, not working, crash, glitch Diagnose bugs via 5 symptom branches (crash/visual/logic/perf/silent)
godot-shader-lab shader, visual effect, material Iterative shader dev with edit-screenshot-analyze loops + 12 recipes
godot-collision-audit collision audit, bullets pass through Audit physics layers, build interaction matrices, auto-fix
godot-scene-doctor scene health, audit scene, check scene 6-check diagnostic suite with scoring and auto-fix

Prerequisites

  • Godot 4.x editor open with your project
  • godot-mcp-pro server connected to Claude Code
  • Claude Code CLI, desktop app, or IDE extension

Installation

claude plugins install /path/to/godot-mcp-skills

Or add to your Claude Code settings to install from a git repo.

Project-Specific Extensions

These skills are generic Godot workflows. For project-specific behavior (custom collision layers, entity systems, build scripts), add project-local skills in your .claude/skills/ directory. Project-local skills override and extend plugin skills.

Example: if your project uses layers 1=Player, 2=Enemy, 3=Projectile, add that to your project's CLAUDE.md and the collision-audit skill will use those conventions automatically.

Skill Details

godot-scene-builder

Build scenes interactively: create/open scene, add nodes via MCP, configure properties, verify with screenshots, save. Includes recipes for 3D rooms, character scenes, UI panels, and particle effects.

godot-debugger

Classifies symptoms into 5 branches and routes to the right diagnostic tools. Includes expanded decision trees for edge cases (race conditions, autoload errors, intermittent visual glitches) and a Godot 4.6 common bugs reference.

godot-shader-lab

Visual feedback loop for shader development. Comes with 12 ready-to-use shader recipes: hit flash, dissolve, outline, hologram, force field, water, damage vignette, pixelate, scanlines, chromatic aberration, rim glow, and toon shading.

godot-collision-audit

Three modes: full audit (scan all physics bodies, build interaction matrix), focused diagnosis ("bullets pass through enemies"), and new entity setup (assign layers for new types). Includes bitmask math reference and common game configurations.

godot-scene-doctor

Runs 6 diagnostic checks: complexity analysis, signal integrity, dependency health, unused resources, performance hints, and anti-pattern detection. Generates a scored health report with prioritized findings.

License

MIT

About

Claude Code skills for Godot 4 game development via godot-mcp-pro server

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors