Godot MCP

🚀 Godot MCP Skill System Usage Guide

The Godot MCP Skill System is a comprehensive AI-assisted game development toolkit that includes 11 professional skills, covering the entire development process from project creation to product release. Users can describe tasks in natural language, allowing the AI to automatically invoke the corresponding MCP tools to complete complex development tasks.

Skill Loading Methods

1. Automatic Loading (Recommended)

Claude will automatically discover skills in the following locations:

• Project Skills: .claude/skills/<Skill Name>/ (for the current project)
• Personal Skills: ~/.claude/skills/<Skill Name>/ (for global use)

2. Manual Skill Invocation

# Invoke specific skills (use the correct skill names)
/skill godot-project-creator
/skill godot-gameplay-developer
/skill godot-ui-designer
/skill godot-animation-studio
/skill godot-performance-optimizer
/skill godot-test-debugger
/skill godot-product-polisher
/skill godot-compatibility-checker
/skill context7-auto-research
/skill mcp-orchestration
/skill chinese-dev-guide

✨ Core Development Skills (7)

📋 godot-project-creator

• Path: godot-project-creator/SKILL.md
• Function: Intelligent project creation and scene management
• Trigger: New project creation, project architecture design, template generation
• Feature: Automatically generate a complete project architecture that adheres to the best practices of Godot 4.x
• Usage Example: "Create a 2D platform jumping game project"

🎮 godot-gameplay-developer

• Path: godot-gameplay-developer/SKILL.md
• Function: Core gameplay logic development
• Trigger: Character control, physics system, AI behavior, game rules
• Feature: Support the intelligent implementation of complex game mechanisms
• Usage Example: "Implement a character with double jump and dash abilities"

🎨 godot-ui-designer

• Path: godot-ui-designer/SKILL.md
• Function: UI interface system development
• Trigger: HUD design, menu system, responsive layout
• Feature: An intelligent UI system that automatically adapts to different resolutions
• Usage Example: "Create a game HUD like Honor of Kings"

🎬 godot-animation-studio

• Path: godot-animation-studio/SKILL.md
• Function: Resource and animation creation
• Trigger: Sprite import, animation configuration, particle effects, sound integration
• Feature: A one-stop resource production and animation system
• Usage Example: "Create idle, walking, and attacking animations for a knight character"

⚡ godot-performance-optimizer

• Path: godot-performance-optimizer/SKILL.md
• Function: Performance optimization and adaptation
• Trigger: Performance issues, resolution adaptation, memory optimization
• Feature: Intelligent performance analysis and automatic optimization
• Usage Example: "Optimize the game to run at 60FPS on various screens"

🔧 godot-test-debugger

• Path: godot-test-debugger/SKILL.md
• Function: Testing and debugging workflow
• Trigger: Automated testing, error diagnosis, debugging tools
• Feature: A comprehensive testing and debugging solution
• Usage Example: "Create a complete unit test for the character system"

✨ godot-product-polisher

• Path: godot-product-polisher/SKILL.md
• Function: Product beautification and refinement
• Trigger: Visual effect enhancement, sound optimization, user experience improvement
• Feature: A comprehensive upgrade from "functional" to "exquisite"
• Usage Example: "Enhance the game's visual impact and user experience"

🛠️ Basic Support Skills (4)

🤖 context7-auto-research

• Path: context7-auto-research/SKILL.md
• Function: Automatically use Context7 for document research
• Trigger: Keywords such as "how to implement", "configuration", "documentation"
• Feature: Implement automated rules for user requests: "Always use context7 when I need code generation, setup or configuration steps, or library/API documentation"

🎮 godot-compatibility-checker

• Path: godot-compatibility-checker/SKILL.md
• Function: Detect and fix compatibility issues between Godot 3.x and 4.x
• Trigger: Version upgrade, API errors, compatibility issues
• Feature: Fixing solutions based on actual project experience

🔧 mcp-orchestration

• Path: mcp-orchestration/SKILL.md
• Function: Orchestrate multiple MCP tools to complete complex tasks
• Trigger: Multi-step development processes, toolchain collaboration
• Feature: Support four modes: serial, parallel, conditional, and loop

🌏 chinese-dev-guide

• Path: chinese-dev-guide/SKILL.md
• Function: Chinese environment configuration and development guidance
• Trigger: Chinese communication, localization requirements
• Feature: A complete Chinese development environment

Skill Status

✅ Loaded Skills: 11

• 🏗️ Core Development Skills (7): godot-project-creator, godot-gameplay-developer, godot-ui-designer, godot-animation-studio, godot-performance-optimizer, godot-test-debugger, godot-product-polisher
• 🛠️ Basic Support Skills (4): godot-compatibility-checker, context7-auto-research, mcp-orchestration, chinese-dev-guide

🚀 Example of a Complete Development Process

Scenario: Create a Complete 2D Platform Jumping Game from Scratch

User: "I want to make a 2D platform jumping game like Super Mario"

Step 1: Project Creation [godot-project-creator]
→ Automatically create the project structure
→ Configure basic nodes and scenes
→ Set up input mappings
→ Create basic script templates

Step 2: Core Gameplay Development [godot-gameplay-developer]
→ Implement character movement and jumping physics
→ Create platform collision detection
→ Design collectible and enemy systems
→ Implement level flow logic

Step 3: UI Interface Design [godot-ui-designer]
→ Create the game HUD (health, score, time)
→ Design the main menu and pause menu
→ Implement the settings interface
→ Ensure responsive layout

Step 4: Animation and Special Effects [godot-animation-studio]
→ Import character sprite atlases
→ Create idle, running, jumping, and attacking animations
→ Design collectible special effects
→ Configure jumping sound effects

Step 5: Performance Optimization [godot-performance-optimizer]
→ Optimize rendering performance
→ Adapt to different resolutions
→ Manage memory usage
→ Test performance on different devices

Step 6: Testing and Debugging [godot-test-debugger]
→ Create automated tests
→ Diagnose and fix bugs
→ Conduct performance testing and analysis
→ Generate test reports

Step 7: Product Refinement [godot-product-polisher]
→ Enhance visual effects
→ Optimize sound experience
→ Improve user feedback
→ Prepare release materials

Final Result: A complete, optimized, and exquisite 2D platform jumping game

💻 Usage Examples

Automatic Trigger Examples

User: "I want to create an RPG game with a character system, item system, and combat system"
→ Automatically trigger the godot-project-creator skill
→ Generate a complete project architecture and modular structure

User: "Implement a character with double jump and dash abilities"
→ Automatically trigger the godot-gameplay-developer skill
→ Create a complete character control logic and state machine

User: "The game runs slowly on low-end devices and needs to be optimized to 60FPS"
→ Automatically trigger the godot-performance-optimizer skill
→ Analyze performance bottlenecks and automatically optimize

User: "How to implement colorful explosion particle effects in Godot 4.x"
→ Automatically trigger the context7-auto-research skill
→ Query the latest documentation and return an implementation plan

User: "Encountered a Godot compatibility error: Invalid assignment of property 'emission_amount'"
→ Automatically trigger the godot-compatibility-checker skill
→ Detect and fix compatibility issues

Manual Invocation Examples

/skill godot-ui-designer
→ Create a professional game UI interface system
→ Ensure responsive layout and user experience

/skill godot-test-debugger
→ Create a complete testing and debugging workflow
→ Conduct automated testing and error diagnosis

/skill godot-product-polisher
→ Comprehensively improve game quality and user experience
→ Prepare materials and optimizations for release

💡 Advanced Usage Tips

1. Combined Skill Usage

"I want to create a fighting game with exquisite visual effects and smooth operation experience"
→ Activate simultaneously: project-creator + gameplay-developer + ui-designer + animation-studio + product-polisher

2. Phased Development

Phase 1: Use godot-project-creator to create the basic framework
Phase 2: Use godot-gameplay-developer to implement the core gameplay
Phase 3: Use godot-animation-studio to add animations and special effects
Phase 4: Use godot-performance-optimizer to optimize performance
Phase 5: Use godot-product-polisher to beautify and refine

3. Targeted Problem Solving

"The game often crashes during runtime, and the memory usage is too high"
→ Activate godot-test-debugger for problem diagnosis
→ Activate godot-performance-optimizer for memory optimization

MCP Tool Integration

All skills clearly specify the MCP tools used:

• Context7 MCP: Document retrieval and query
• Godot MCP: Godot engine integration (node operations, script management, scene control, etc.)
• Chrome DevTools MCP: Web development debugging
• Sequential Thinking MCP: Logical analysis and reasoning
• Bash MCP: System command execution
• Read/Write/Edit MCP: File operations
• Grep/Glob MCP: Code search and scanning

📊 Effect Evaluation

Improved Development Efficiency

• Code Generation Speed: Increased by 10 - 50 times
• Error Rate Reduction: Reduced by 70% of common errors
• Learning Cost: Easy for beginners to get started
• Quality Assurance: Adhere to best practices

Enhanced Project Quality

• Architecture Design: Modular and scalable
• Performance Optimization: Automatic performance tuning
• User Experience: Professional interaction design
• Release Readiness: Meet store standards

🔧 Customization and Extension

Skill Parameter Adjustment

Each skill supports parameter customization, for example:

• Optimization Level: basic/standard/high/premium
• Target Platform: PC/mobile/console
• Performance Target: 30fps/60fps/120fps
• Quality Requirement: functional/polished/AAA

⚠️ Important Notes

Usage Restrictions

1. Skill Directory: Skills must be placed in the .claude/skills/ directory to be automatically loaded.
2. Skill Name: Use simple lowercase names with hyphens and avoid spaces.
3. File Format: Each skill must include a SKILL.md file.
4. YAML Format: The skill file must start with the correct YAML front matter.
5. MCP Dependency: Some skills require specific MCP tools to be configured and running.
6. Complexity Limit: Very large projects need to be implemented in stages.
7. Hardware Requirement: Some advanced features require better hardware configuration.

Best Practices

1. Clarify Requirements: Provide clear and specific requirement descriptions.
2. Implement in Stages: Complete complex projects in phases.
3. Provide Timely Feedback: Give feedback on the generated results.
4. Continuous Learning: Understand the capabilities and limitations of each skill.
5. Progressive Enhancement: Gradually enhance from basic to advanced.

🔮 Future Plans

Short-Term Goals

• Add more game type templates
• Optimize natural language understanding ability
• Improve code quality and performance
• Enhance team collaboration features

Long-Term Vision

• Fully AI-driven game development
• Real-time collaborative development platform
• Intelligent project management
• Automated testing and release

Version: 2.0.0 Last Update: 2025-11-09 Total Skills: 11 Status: Loaded and ready to use Classification: Core Development Skills (7) + Basic Support Skills (4) Feature: A complete AI-assisted game development workflow