SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsgodot-skills

godot-skills

General & other

View repository

Updated 10-15 22:13

About this skill

Unified Entry Point for Godot Skills

Skill Objective

As the unified entry point for all Godot-related skills, intelligently select the most suitable sub-skill based on the user's description, and ensure the MCP connection is normal before invoking any sub-skill. Users do not need to understand the functions of the 15 specific skills; the system automatically handles the MCP connection status.

🔌 MCP Connection Management

Connection Detection

  • Automatic Detection: Automatically detect the MCP connection status before each skill invocation
  • Connection Verification: Via mcp__godot-mcp__get_project_info verify the connection
  • Status Report: Clear connection status display

Automatic Startup

  • Integrated auto-launcher: Built-in godot-mcp-auto-launcher functionality
  • Automatic Startup: Automatically start the MCP server when the connection fails
  • Retry Mechanism: Intelligent retry and error recovery

Strict Constraints

  • Use MCP Tools Only: All Godot operations must go through mcp__godot-mcp__* tools
  • No Direct Operations: Cannot directly read or write Godot project files
  • Safety First: Ensure project data safety

📚 Integrated Sub-skills (15)

🎯 Core Development Skills (7)

  1. godot-project-creator - Project Creator
  2. godot-gameplay-developer - Gameplay Development
  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 Operator
  2. godot-camera-system - Camera System
  3. godot-material-manager - Material Manager
  4. godot-resource-workflow - Resource Workflow
  5. godot-compatibility-checker - Compatibility Checker

📚 Supporting Auxiliary Skills (3)

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

🎯 How to Use

Users only need to describe their needs in natural language, and the system will automatically:

  1. Detect MCP Connection → Ensure Godot communication is normal
  2. Analyze User Intent → Identify the specific type of need
  3. Select the Best Skill → Intelligently match professional skills
  4. Invoke Sub-skill → Execute specific functions (only through MCP tools)
  5. Return Results → Provide detailed processing results

MCP Connection Detection Process

用户请求 → 检测MCP连接 → [连接正常] → 继续处理
                ↓
            [连接失败] → 启动MCP服务器 → 重试检测 → 继续处理
                ↓
            [启动失败] → 报告错误 → 提供解决方案

Example Dialogue

用户: 我想创建一个2D平台游戏项目
系统: [MCP检测: 连接正常] → [检测: 项目创建] → 调用godot-project-creator → 生成完整项目架构

用户: 实现角色跳跃和移动机制
系统: [MCP检测: 连接正常] → [检测: 玩法开发] → 调用godot-gameplay-developer → 创建物理系统

用户: 设计血条和主菜单界面
系统: [MCP检测: 连接正常] → [检测: UI设计] → 调用godot-ui-designer → 创建界面布局

用户: 优化游戏性能，提升帧率
系统: [MCP检测: 连接正常] → [检测: 性能优化] → 调用godot-performance-optimizer → 分析并优化

# 如果MCP未连接的情况
用户: 修复这个兼容性问题
系统: [MCP检测: 连接失败] → [启动MCP服务器] → [重试检测成功] → [检测: 兼容性] → 调用兼容性检查器

🧠 Intelligent Matching Rules

Project Creation Category

Keywords: create, new, project, initialize, start, project, create, setup → Select: godot-project-creator

Gameplay Development Category

Keywords: gameplay, logic, mechanism, system, feature, gameplay, logic, mechanic, feature → Select: godot-gameplay-developer

UI Design Category

Keywords: interface, UI, menu, button, interaction, interface, menu, hud, dialog → Select: godot-ui-designer

Animation and Effects Category

Keywords: animation, effects, particles, resources, animation, effects, particles, visual → Select: godot-animation-studio

Performance Optimization

Keywords: performance, optimization, frame rate, memory, adaptation, performance, optimize, fps → Select: godot-performance-optimizer

Testing and Debugging

Keywords: testing, debugging, errors, bug, test, debug, unit, integration → Select: godot-test-debugger

Compatibility Check

Keywords: compatibility, version, migration, API, version, migration, upgrade → Select: godot-compatibility-checker

Documentation Research

Keywords: documentation, research, API, query, documentation, research, latest → Select: context7-auto-research

Chinese Language Support

Keywords: Chinese, localization, bilingual, environment, chinese, localization → Select: chinese-dev-guide

Syntax Guide

Keywords: syntax, GDScript, conventions, code, syntax, gdscript, style → Select: gdscript-syntax-guide

🔧 Skill Directory Structure

godot-skills/
├── SKILL.md                    # 主技能定义
├── sub-skills/                 # 子技能目录 (15个专业技能)
│   ├── 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: Call when retry fails godot-mcp-auto-launcher to start the server
  • Port Detection: Supports automatic detection of ports 9080 and 9081
  • Error Diagnosis: Provides detailed error information and solutions

Common Problem Solutions

问题1: "MCP连接失败"
解决: 自动启动MCP服务器，检测端口占用

问题2: "Godot编辑器未启动"
解决: 提醒用户启动Godot编辑器并启用MCP插件

问题3: "权限不足"
解决: 提供权限配置指导和解决方案

⚠️ Important Rules

MCP Tool Usage Constraints

  • Use MCP Tools Only: All Godot operations must go through mcp__godot-mcp__* tools
  • No Direct File Operations: Cannot directly read or write Godot project files (.tscn, .gd, .tres, etc.)
  • Safety First: Ensure project data safety and avoid accidental modifications
  • Tool Verification: Verify MCP tool availability before each operation

Skill Design Principles

  • No External Package Dependencies: Use only the features provided by the skill system
  • Pure Skill Invocation: Invoke sub-skills through the Skill tool
  • Intelligent Routing: Select skills based on keyword and pattern matching
  • Fault Tolerance Handling: Provide fallback skill suggestions and error recovery

Mandatory MCP Check

  • Connection Prerequisite: MCP connection must be checked before any Godot operation
  • Tool Verification: Verify the availability of all MCP tools
  • Status Reporting: Report MCP connection status in real time
  • Automatic Recovery: Automatically attempt recovery when connection fails

🎯 Skill Trigger Modes

Automatic Trigger Conditions

  • Godot-related keywords detected
  • Mentions game development, UI design, performance optimization, etc.
  • Project creation or feature implementation required
  • MCP Connection Detection(highest priority)

Trigger Priority

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

MCP Pre-check Process

用户请求 → [强制] MCP连接检测 → [成功] 意图分析 → 技能执行
                          ↓
                      [失败] 启动MCP → 重试检测 → 意图分析
                          ↓
                      [启动失败] 错误报告 → 解决方案

Fallback Mechanism

  • MCP Connection Failure: Automatically call godot-mcp-auto-launcher
  • Skill Matching Failure: Provide a list of related skills
  • Manual User Selection: Allow specifying a particular 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...

Goal: Provide Godot developers with the most convenient unified skill entry point, making complex development work simple and efficient!