Unified Entry for Godot Skills

Skill Objectives

🔌 MCP Connection Management

Connection Detection

• Automatic Detection: Automatically detect MCP connection status before each skill invocation
• Connection Verification: Verify connection via

  mcp__godot-mcp__get_project_info

• Status Reporting: Clear display of connection status

Automatic Startup

• Integrated auto-launcher: Built-in

  godot-mcp-auto-launcher

  functionality
• Automatic Startup: Automatically start the MCP server when connection fails
• Retry Mechanism: Intelligent retry and error recovery

Strict Constraints

• MCP Tools Only: All Godot operations must be performed using

  mcp__godot-mcp__*

  tools
• No Direct Operations: Cannot directly read or write Godot project files
• Security First: Ensure project data security

📚 Integrated Sub-skills (15)

🎯 Core Development Skills (7)

1. godot-project-creator - Project Creator
2. godot-gameplay-developer - Gameplay Developer
3. godot-ui-designer - UI Designer
4. godot-animation-studio - Animation Studio
5. godot-performance-optimizer - Performance Optimizer
6. godot-test-debugger - Test Debugger
7. godot-product-polisher - Product Polisher

🔧 Professional Function Skills (5)

1. godot-batch-operations - Batch Operations Tool
2. godot-camera-system - Camera System
3. godot-material-manager - Material Manager
4. godot-resource-workflow - Resource Workflow
5. godot-compatibility-checker - Compatibility Checker

📚 Support & Auxiliary Skills (3)

1. context7-auto-research - Auto Researcher
2. chinese-dev-guide - Chinese Development Guide
3. gdscript-syntax-guide - GDScript Syntax Guide

🎯 Usage Methods

1. Detect MCP Connection → Ensure normal Godot communication
2. Analyze User Intent → Identify specific demand types
3. Select Optimal Skill → Intelligently match professional skills
4. Invoke Sub-skill → Execute specific functions (only via MCP tools)
5. Return Results → Provide detailed processing results

MCP Connection Detection Flow

User Request → Detect MCP Connection → [Connection Normal] → Continue Processing
                ↓
            [Connection Failed] → Start MCP Server → Retry Detection → Continue Processing
                ↓
            [Startup Failed] → Report Error → Provide Solutions

Example Conversations

User: I want to create a 2D platformer game project
System: [MCP Detection: Connection Normal] → [Detection: Project Creation] → Invoke godot-project-creator → Generate complete project structure

User: Implement character jumping and movement mechanics
System: [MCP Detection: Connection Normal] → [Detection: Gameplay Development] → Invoke godot-gameplay-developer → Create physics system

User: Design health bar and main menu interface
System: [MCP Detection: Connection Normal] → [Detection: UI Design] → Invoke godot-ui-designer → Create interface layout

User: Optimize game performance and improve frame rate
System: [MCP Detection: Connection Normal] → [Detection: Performance Optimization] → Invoke godot-performance-optimizer → Analyze and optimize

# If MCP is not connected
User: Fix this compatibility issue
System: [MCP Detection: Connection Failed] → [Start MCP Server] → [Retry Detection Successful] → [Detection: Compatibility] → Invoke compatibility checker

🧠 Intelligent Matching Rules

Project Creation Category

Gameplay Development Category

UI Design Category

Animation & Effects Category

Performance Optimization Category

Testing & Debugging Category

Compatibility Check Category

Documentation & Research Category

Chinese Support Category

Syntax Guide Category

🔧 Skill Directory Structure

godot-skills/
├── SKILL.md                    # Main skill definition
├── sub-skills/                 # Sub-skills directory (15 professional skills)
│   ├── godot-project-creator/
│   ├── godot-gameplay-developer/
│   ├── godot-ui-designer/
│   ├── godot-animation-studio/
│   ├── godot-performance-optimizer/
│   ├── godot-test-debugger/
│   ├── godot-product-polisher/
│   ├── godot-batch-operations/
│   ├── godot-camera-system/
│   ├── godot-material-manager/
│   ├── godot-resource-workflow/
│   ├── godot-compatibility-checker/
│   ├── context7-auto-research/
│   ├── chinese-dev-guide/
│   ├── gdscript-syntax-guide/
│   └── skill-creator_技能创建器/

🔧 MCP Error Handling

Connection Failure Handling

• Automatic Retry: Automatically retry 3 times when MCP connection fails
• Start MCP: Invoke

  godot-mcp-auto-launcher

  to start the server if retries fail
• Port Detection: Support automatic detection of ports 9080 and 9081
• Error Diagnosis: Provide detailed error information and solutions

Common Problem Solutions

Problem 1: "MCP Connection Failed"
Solution: Automatically start the MCP server and detect port occupancy

Problem 2: "Godot Editor Not Started"
Solution: Remind users to start the Godot Editor and enable the MCP plugin

Problem 3: "Insufficient Permissions"
Solution: Provide permission configuration guidance and solutions

⚠️ Important Rules

MCP Tool Usage Constraints

• MCP Tools Only: All Godot operations must be performed using

  mcp__godot-mcp__*

  tools
• No Direct File Operations: Cannot directly read or write Godot project files (.tscn, .gd, .tres, etc.)
• Security First: Ensure project data security and avoid accidental modifications
• Tool Verification: Verify MCP tool availability before each operation

Skill Design Principles

• No External Dependencies: Only use functions provided by the skill system
• Pure Skill Invocation: Invoke sub-skills via Skill tools
• Intelligent Routing: Select skills based on keyword and pattern matching
• Fault Tolerance Handling: Provide backup skill suggestions and error recovery

MCP Mandatory Checks

• Connection Pre-check: Must detect MCP connection before any Godot operation
• Tool Verification: Verify the availability of all MCP tools
• Status Reporting: Real-time reporting of MCP connection status
• Automatic Recovery: Automatically attempt recovery when connection fails

🎯 Skill Trigger Modes

Automatic Trigger Conditions

• Detect Godot-related keywords
• Mention game development, UI design, performance optimization, etc.
• Need project creation or feature implementation
• MCP Connection Detection(highest priority)

Trigger Priority

1. MCP Connection Detection - Must be executed before each invocation
2. Intent Recognition - Analyze user's specific needs
3. Skill Matching - Select the most suitable sub-skill
4. Fault Tolerance Handling - Provide backup solutions

MCP Pre-check Flow

User Request → [Mandatory] MCP Connection Detection → [Success] Intent Analysis → Skill Execution
                          ↓
                      [Failed] Start MCP → Retry Detection → Intent Analysis
                          ↓
                      [Startup Failed] Error Report → Solutions

Backup Mechanisms

• MCP Connection Failure: Automatically invoke godot-mcp-auto-launcher
• Skill Matching Failure: Provide a list of related skills
• Manual User Selection: Allow specifying a specific skill
• Error Recovery: Provide detailed usage suggestions

MCP Tool Verification List

• mcp__godot-mcp__get_project_info

  - Project Information Retrieval

• mcp__godot-mcp__create_node

  - Node Creation

• mcp__godot-mcp__update_node_property

  - Node Property Update

• mcp__godot-mcp__create_script

  - Script Creation

• mcp__godot-mcp__open_scene

  - Scene Opening
• Other related MCP tools...