godot-mcp: Skill for Claude Code

.claude/skills/godot-skills/SKILL.md

godot-skills is a skill for Claude Code from hhhh124hhhh/godot-mcp. It costs 36 tokens per session (2,429 once invoked), scanned A, original, MIT.

A single entry point for Godot development helpers that chooses among 15 specialised skills based on a natural-language request and checks the Godot connection first.

In plain words
What is it for?
Use it to route requests for project creation, gameplay, interface design, animation, optimisation, testing, resource work, and other listed Godot tasks.
Why use it?
It removes the need to know which separate Godot helper to choose and manages the required communication with the running project.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is hhhh124hhhh/godot-mcp's own configuration. It tells Claude Code how to work on godot-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything godot-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to hhhh124hhhh/godot-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/hhhh124hhhh/godot-mcp/main/.claude/skills/godot-skills/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/hhhh124hhhh/godot-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for godot-skills

README.md
[![agentmods](https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-skills/github.svg)](https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-skills)
Your own site
<a href="https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-skills"><img src="https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-skills/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for godot-skills

Your own site · 80×15
<a href="https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-skills"><img src="https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-skills.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,429 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00036 $0.02429
Opus 5 $0.00018 $0.01215
Sonnet 5 $0.00007 $0.00486
Haiku 4.5 $0.00004 $0.00243

Measured 12d ago against content hash c738ffeb6b02, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

godot-skills scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (sub-skills/godot-mcp-auto-launcher/scripts/start-mcp.js, sub-skills/skill-creator_技能创建器/scripts/init_skill.py, sub-skills/skill-creator_技能创建器/scripts/package_skill.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/godot-skills/SKILL.md · 238 lines

How it starts

The opening of the file, as written. The whole thing — 238 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Godot技能统一入口

技能目标

作为所有Godot相关技能的统一入口,根据用户描述智能选择最适合的子技能,并确保在调用任何子技能前MCP连接正常。用户无需了解15个具体技能的功能,系统会自动处理MCP连接状态。

🔌 MCP连接管理

连接检测

  • 自动检测:每次调用技能前自动检测MCP连接状态
  • 连接验证:通过 mcp__godot-mcp__get_project_info 验证连接
  • 状态报告:清晰的连接状态显示

自动启动

  • 集成auto-launcher:内置 godot-mcp-auto-launcher 功能
  • 自动启动:连接失败时自动启动MCP服务器
  • 重试机制:智能重试和错误恢复

严格约束

  • 仅使用MCP工具:所有Godot操作必须通过 mcp__godot-mcp__* 工具
  • 禁止直接操作:不能直接读写Godot项目文件
  • 安全优先:确保项目数据安全

📚 集成的子技能 (15个)

🎯 核心开发技能 (7个)

  1. godot-project-creator - 项目创建器
  2. godot-gameplay-developer - 玩法开发
  3. godot-ui-designer - UI设计器
  4. godot-animation-studio - 动画工作室
  5. godot-performance-optimizer - 性能优化器
  6. godot-test-debugger - 测试调试器
  7. godot-product-polisher - 产品打磨器

🔧 专业功能技能 (5个)

  1. godot-batch-operations - 批量操作器
  2. godot-camera-system - 相机系统
  3. godot-material-manager - 材质管理器
  4. godot-resource-workflow - 资源工作流
  5. godot-compatibility-checker - 兼容性检查器

📚 支持辅助技能 (3个)

  1. context7-auto-research - 自动研究员
  2. chinese-dev-guide - 中文开发指南
  3. gdscript-syntax-guide - GDScript语法指南

🎯 使用方式

用户只需用自然语言描述需求,系统会自动:

  1. 检测MCP连接 → 确保Godot通信正常
  2. 分析用户意图 → 识别具体需求类型
  3. 选择最佳技能 → 智能匹配专业技能
  4. 调用子技能 → 执行具体功能(仅通过MCP工具)
  5. 返回结果 → 提供详细的处理结果

MCP连接检测流程

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

示例对话

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

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

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

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

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

🧠 智能匹配规则

项目创建类

关键词:创建、新建、项目、初始化、开始、project、create、setup → 选择:godot-project-creator

Read the full file on GitHub · 238 lines

Files

What ships with it

23 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 238 lines · 36 tokens per session scan A c738ffeb6b02

Subscribe to this mod's changes

godot-skills is a skill published in the GitHub repository hhhh124hhhh/godot-mcp (42 stars, last pushed 10mo ago), licensed MIT. It adds 36 tokens to every session and 2,429 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gameobject-component-destroy

Destroy one or more Components from a target GameObject. Missing (null) components are skipped — they cannot be destroyed. Use 'gameobject-find' and 'gameobject-component-get' to identify the components first.

IvanMurzak/Unity-MCP · 49 tokens

unity-version-split

Split a C# file into Unity 6.5+ and pre-Unity 6.5 variants. Use when a file needs different implementations for different Unity versions due to API changes (e.g., EntityId vs int, GetEntityId vs GetInstanceID).

IvanMurzak/Unity-MCP · 59 tokens

godot-signals-groups

Build event-driven, decoupled Godot 4.7 gameplay with signals and node groups: declare and emit custom signals, connect with Callables (incl. bind/one-shot), and broadcast to many nodes via groups and callgroup. Use when wiring node communication in a Godot project, replacing tight references with signals…

gamedev-skills/awesome-gamedev-agent-skills · 95 tokens

unity-addressables

Manage Addressables groups, entries, profiles and content builds (com.unity.addressables, reflection-based).

Besty0728/Unity-Skills · 25 tokens

motion

How an agent turns a character mesh into a usable animated FBX — and how to judge whether the result is shippable.

OpenDCAI/GameFactory-3A · 0 tokens

threejs-exposure-color-grading

Build a measured exposure and grading path in Three.js. Use for a 64x36 encoded luminance meter, asynchronous readback, weighted log-average exposure, asymmetric adaptation, single tone-map ownership, and a generated 32-cube post-tone-map LUT.

scottstts/Threejs-Awesome-Graphics-Agent-Skills · 60 tokens