godot-headless-testing SKILL.md skillA

godot-headless-testing 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-headless-testing@git:20261024.5ffa874

Pins git:20261024.5ffa874 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-headless-testing/SKILL.md
Versions recorded
5
Latest version
git:20261024.5ffa874, committed Oct 24, 2026
First version recorded
Oct 22, 2026
Size
14,108 bytes
Repository stars
3
License
MIT

在终端里验证 Godot 4 改动时用,看不到编辑器也能自己跑通。修完脚本报错要确认整个项目没有脚本错误和 GDScript 警告,改完 GDScript 场景 C# 想自己验证,写冒烟测试 自动化测试,配 CI。--headless --import --check-only --script、退出码、从输出判 SCRIPT ERROR、模拟输入、截图、GUT gdUnit4。headless smoke test.

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 无头测试与命令行验证

给在终端里工作的 AI 用:改完代码后用 Godot 命令行自己验证,不依赖编辑器。管命令行参数、判失败的规则、冒烟脚本、输入模拟、截图、CI。不管单个节点或 API 怎么用,那些去对应的领域 skill。

示例都在 4.7.2 编辑器版上实测过,`$GODOT_BIN` 指 Godot 可执行文件,`--no-header` 去掉版本头。

## 先查内置

| 需求 | 用这个 | 别自己写 |
|---|---|---|
| 查单个脚本语法 | `--headless --check-only -s x.gd`,退出码 0 或 1 | 正则或自写解析器 |
| 新增 class_name 或资源后 | `--headless --import` | 手改 `.godot/global_script_class_cache.cfg` |
| 跑主场景 N 帧后退出 | `--quit-after N`,配 `--fixed-fps 60` 可复现 | `sleep` 加 kill |
| 加载场景、断言、按结果退出 | SceneTree 脚本加 `quit(code)` | 自己拼 main 循环 |
| 引擎报错也算失败 | `OS.add_logger` 的 Logger 子类计数(4.5+) | 只靠 grep 或只靠退出码 |
| 传参给脚本 | `--` 之后的参数,`OS.get_cmdline_user_args()` 读 | 环境变量或写临时文件 |
| 按键、动作输入 | `Input.action_press`、`Input.parse_input_event` | 直接改节点状态冒充输入 |
| 看画面 | `xvfb-run`,Forward+ 用 `--rendering-driver vulkan`,Compatibility 用 `opengl3` | headless 下截图 |
| 录一段画面 | `--write-movie out/f.png` 或 `.avi`,同样要 xvfb | 循环截图 |
| 查类和方法是否存在 | `ClassDB.class_has_method`、类参考 XML | 凭记忆写 |
| 导出验证 | `--export-pack`,不需要模板 | 手动打 zip |
| 日志留档 | `--log-file 目录须已存在的路径` | `tee` 之外再造日志类 |
| 单元测试库 | GUT 或 gdUnit4,见 references/ci-and-frameworks.md | 自写断言框架 |

## 验证顺序

改完代码按这个顺序跑,前一步不过不进下一步:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mindsmaster/godot-claude-code-skills/godot-headless-testing@sha256:071f32f4365d585c

The line at the top of this page pins the label git:20261024.5ffa874, 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_3tas3bwaq3aauvq2.svg)](https://markdownregistry.com/a/art_3tas3bwaq3aauvq2)

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

Versions

The registry has recorded 5 versions of this file, between Oct 22, 2026 and Oct 24, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261024.5ffa874 latest2026-10-24 5ffa874 14,108 BA view · diff
git:20261023.a7870c22026-10-23 a7870c2 14,413 BA view · diff
git:20261022.91fb1982026-10-22 91fb198 13,407 BA view · diff
git:20261022.048752c2026-10-22 048752c 13,250 BA view · diff
git:20261022.8badd2a2026-10-22 8badd2a 13,168 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 (14108 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_3tas3bwaq3aauvq2
GET https://markdownregistry.com/api/v1/resolve?ref=mindsmaster/godot-claude-code-skills/godot-headless-testing
GET https://markdownregistry.com/api/v1/blob/071f32f4365d585ca93b54974d585163e15e7bb9da4ce62dcac729ef76495f82

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-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
godot-multiplayer SKILL.md skill
mindsmaster/godot-claude-code-skills · skills/godot-multiplayer/SKILL.md · 写联机 多人 主机权威 同步 后加入 断线重连时用。ENetMultiplayerPeer 建连、@rpc 与 multiplayer_authority、MultiplayerSpawner…
git:20261030.5bfe137 · audit A · 3 stars

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

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