godot-scene-authoring SKILL.md skillA

godot-scene-authoring from mindsmaster/godot-claude-code-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mindsmaster/godot-claude-code-skills/godot-scene-authoring@git:20261106.4e282b0

Pins git:20261106.4e282b0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mindsmaster/godot-claude-code-skills
Path
skills/godot-scene-authoring/SKILL.md
Versions recorded
1
Latest version
git:20261106.4e282b0, committed Nov 6, 2026
Size
13,746 bytes
Repository stars
3
License
MIT

在 Godot 4 里新做关卡、房间、HUD、菜单、NPC、道具、背景时用,决定内容摆进 .tscn 还是代码运行时搭。新建项目第一个场景,往已有项目加场景,打开场景一片空看不到东西,美术策划要在编辑器里直接看和调,自定义显示节点在编辑器里不显示,@tool 节点把材质 z_index 写进 tscn,确定性模拟 联机 服务器要读场景里摆的位置。先自查项目是摆在场景里还是运行时生成,再按结果新做或迁移。脚本生成 tscn、@tool 自绘节点、预制场景、_validate_property、internal 子节点、NOTIFICATION_EDITOR_PRE_SAVE、C# 重载。level authoring, WYSIWYG, prefab, data-driven, bake on save, empty scene, audit.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Godot 场景摆放

解决内容在哪里定义:有位置、有外观的东西摆进 `.tscn`,打开场景看到的就是游戏里的样子,选得中、拖得动、改了存盘就生效;代码只管规则和运行时才出现的东西。场景怎么拆、节点怎么通信见 godot-scene-architecture,插件和 Inspector 怎么写见 godot-editor-tooling,数据资源和配表见 godot-resources-data。

判断标准:不运行游戏,美术能不能在编辑器里把一盏灯拖到另一处、把 NPC 换个朝向、把 HUD 的血条挪个位置,存盘后进游戏就是改过的样子。

## 先自查

动手做场景前先看项目现在是哪种做法,别假设。三步,细节和脚本见 [references/audit.md](references/audit.md):

1. 打开或读几个现有 `.tscn`:节点数和游戏里看到的东西对得上,还是只有根节点和脚本
2. 搜脚本里的 `.new()` 加 `add_child`、给 `Control` 设 `position` `size`、`load("res://…png")`,搜配表里的坐标、贴图路径、颜色字段
3. 无头跑审计脚本,数每个场景 `_ready` 之后多出来的、owner 为空的节点

| 结果 | 怎么做 |
|---|---|
| 新项目,或还没有内容场景 | 按下面的做法新做 |
| 内容摆在场景里,脚本只管逻辑 | 照现有结构加内容 |
| 场景空壳,内容运行时按配表或代码建 | 告诉用户自查结果和迁移范围,同意后按 [references/migration.md](references/migration.md) 迁。没同意时,新系统照样摆进场景,往已有的代码搭系统里加东西时跟着现状写 |
| 两种都有 | 按系统分开判断,HUD、菜单、关卡、NPC 各算一项 |

程序生成的地图、按数据数量建的列表行属于运行时内容,不算问题。

## 先查内置

| 需求 | 用这个 | 别自己写 |
|---|---|---|
| 背景 道具 灯 HUD 菜单布局 | 节点直接摆进 `.tscn`,UI 用 Container 和 `Theme` | 代码 `new` 整棵树,场景只剩空壳 |
| 运行时才出现的敌人 子弹 列表行 | 预制 `.tscn` + `PackedScene.instantiate()` | 代码里逐个 `new` 子节点再设颜色尺寸 |
| 不开编辑器生成场景文件 | `extends SceneTree` 脚本建节点、设 owner、`PackedScene.pack` 后 `ResourceSaver.save` | 手拼大段 tscn 文本 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mindsmaster/godot-claude-code-skills/godot-scene-authoring@sha256:18c8a0eb9bff81ef

The line at the top of this page pins the label git:20261106.4e282b0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lujlzsayw24uhb5l.svg)](https://markdownregistry.com/a/art_lujlzsayw24uhb5l)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Nov 6, 2026.

versioncommittedcommitsizeaudit
git:20261106.4e282b0 latest2026-11-06 4e282b0 13,746 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13746 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mindsmaster/godot-claude-code-skills · 3 stars · license MIT · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_lujlzsayw24uhb5l
GET https://markdownregistry.com/api/v1/resolve?ref=mindsmaster/godot-claude-code-skills/godot-scene-authoring
GET https://markdownregistry.com/api/v1/blob/18c8a0eb9bff81ef75695678a6e75dc1e16f97dddf3c9f5b616c4a6c2a3b046a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mindsmaster/godot-claude-code-skills

CLAUDE.md CLAUDE.md file
mindsmaster/godot-claude-code-skills · CLAUDE.md
git:20261023.4c61c60 · audit A · 3 stars
godot-2d-in-3d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-2d-in-3d/SKILL.md · 在 Godot 4 的 3D 场景里放 2D 角色时用,2.5D 纸片人 HD-2D 像素角色配 3D 场景。Sprite3D AnimatedSprite3D billboard 正对镜头、pixel_size、投影阴影…
git:20261024.5ffa874 · audit A · 3 stars
godot-2d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-2d/SKILL.md · 写 Godot 4 的 2D 场景时用。CharacterBody2D 角色移动与平台跳跃、碰撞层、Area2D、TileMapLayer 瓦片地图与地形自动接边、Camera2D 跟随 平滑 limit…
git:20261024.5ffa874 · audit A · 3 stars
godot-3d SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-3d/SKILL.md · 搭建或调试 Godot 4 的 3D 场景时用。CharacterBody3D 角色移动、第一 第三人称相机 SpringArm3D、Jolt 物理与碰撞层、RayCast3D 查询、渲染器与光照 GI 选型 SDFGI VoxelGI…
git:20261024.5ffa874 · audit A · 3 stars
godot-animation SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-animation/SKILL.md · 写动画 缓动 角色状态动画 UI 动效 转场 精灵帧动画时用。AnimationPlayer 与 RESET 轨道、AnimationTree 状态机 BlendSpace、Tween create_tween 链式与…
git:20261024.5ffa874 · audit A · 3 stars
godot-audio SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-audio/SKILL.md · 写音效 音乐 音量设置 脚步声 战斗音乐切换 节奏同步时用,音效在游戏里发闷 模糊 与原文件听感不一样时也用。Audio bus 布局 Music SFX Voice、滑条调音量…
git:20261026.d9bd45f · audit A · 3 stars
godot-builtin-first SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-builtin-first/SKILL.md · 在 Godot 4 项目里动手写任何功能之前先用,看到 project.godot .tscn .gd,或要自己写相机 缓动 状态机 UI 布局 JSON 加载 输入映射 音频池 存档 场景切换 编辑器工具时。先查引擎有没有现成的节点…
git:20261106.4e282b0 · audit A · 3 stars
godot-csharp SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-csharp/SKILL.md · 在 Godot 里写 C# 时用。partial class 与源码生成器、[Export] [Signal] [GlobalClass] [Tool]、信号连接与断开、SignalName PropertyName 与…
git:20261103.d5bb6c3 · audit A · 3 stars
godot-editor-tooling SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-editor-tooling/SKILL.md · 写 Godot 4 编辑器扩展时用。@tool 工具脚本、@export_tool_button、EditorPlugin 与 plugin.cfg、EditorInspectorPlugin 定制…
git:20261106.16b31f7 · audit A · 3 stars
godot-gdscript SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-gdscript/SKILL.md · 写或改 GDScript 时用。静态类型 := 与 Array[T] Dictionary[K, V]、class_name、@export @onready、信号 connect emit lambda、await…
git:20261024.5ffa874 · audit A · 3 stars
godot-headless-testing SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-headless-testing/SKILL.md · 在终端里验证 Godot 4 改动时用,看不到编辑器也能自己跑通。修完脚本报错要确认整个项目没有脚本错误和 GDScript 警告,改完 GDScript 场景 C# 想自己验证,写冒烟测试 自动化测试,配 CI。--headless…
git:20261024.5ffa874 · audit A · 3 stars
godot-input SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-input/SKILL.md · 写移动 跳跃 攻击 视角控制 改键菜单 手柄支持时用。InputMap 动作代替硬编码按键、get_axis get_vector 死区、键盘手柄双绑定、_unhandled_input…
git:20261024.5ffa874 · audit A · 3 stars

Every file in mindsmaster/godot-claude-code-skills

Browse by kind, by grade A, or by owner.