关于 authoring-godot-prompter-skills
authoring-godot-prompter-skills 为 GodotPrompter 仓库中的技能和 Agent 提供文件格式模板，面向内容作者与维护者。它说明 YAML frontmatter、章节组织、GDScript 与 C# 配对规范，以及通过验证脚本检查文件。
主要功能
- 01技能文件 frontmatter 模板
- 02技能章节组织规范
- 03GDScript 与 C# 配对要求
- 04Agent 定义格式模板
- 05技能验证脚本检查
适用场景
- 01创建符合仓库规范的技能文件
- 02编写 Agent 定义
- 03检查技能中的 C# 示例配对
- 04提交前验证格式与文件大小
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/authoring-godot-prompter-skills确认已加载。
详细介绍
编写 GodotPrompter 技能和 Agent
本仓库的文件格式模板。内容本身的约定和大小限制见根目录中的 CLAUDE.md。
SKILL.md 格式
每项技能都必须以 YAML frontmatter 开头：
---
name: skill-name
description: Use when [trigger] — [brief scope]
---
之后依次为：
- 标题和简介
- 相关技能行：
> **Related skills:** **skill-a** for X, **skill-b** for Y. - 带有模式和示例的编号章节
- 先写 GDScript，再写对应的 C#（使用
gdscript和csharp语言标签） - 末尾附上实现检查清单
C# 对等性
验证器还会检查 references/*.md 中的 C# 对等内容（csharp-parity-*-reference），因此 Pattern X 的迁移会持续受到检查。按语言划分章节的文件（## C#、## Dash (C#)、### … — C#）会按文件检查，而不是按章节检查；仅在正文中提及 C# 的标题不算语言分区。
如果某个章节确实无法提供对应的 C# 内容，请只标记该章节，切勿标记整个技能：
此标记在 SKILL.md 和 references/*.md 中均有效。必须说明原因；省略原因会报错（每个标记都会检查，不仅是缺少 C# 的章节），因为无法说明原因的豁免与未写出的示例无法区分。原因中可以包含 < 和 >，而围栏代码块中的标记会被忽略，因此文件可以说明此标记，而不豁免自身。
不要使用以下两种更宽泛的做法：将技能添加到 GDSCRIPT_ONLY_BY_DESIGN 会豁免其中的所有章节；将标题改为 "… (GDScript)" 会触发语言分区检查，并悄然将整个文件降级为文件级检查。这两种做法都会掩盖相邻章节中的实际缺漏。
仅包含注释的围栏 ```gdscript 代码块不算代码示例——它只是围栏中的正文，会被标记为未配对的 GDScript 代码块。请将其写成正文或项目符号列表。
Agent 格式
agents/<name>.md 中的 Agent 定义使用 YAML frontmatter：
---
name: agent-name
description: |
When to use, with <example> blocks.
model: inherit
---
完成前
运行 node scripts/validate-skills.mjs — 它会检查 frontmatter、交叉引用和 16 KB 大小限制。