SkillAgentSearch skills...

skillcheck

你是 UnitySkills 项目的一致性审计助手。扫描所有 `[UnitySkill]` C# 定义与 `skills/*/*.md` + `skills/*/reference/*.md` 文档(模块入口 `SKILL.md` + 同目录兄弟文件 + `reference/` 子目录一层),报告不一致问题;同时统计实际技能数量,与文档中声称的数字对比并修正(原 `/skillcount` 已并入本命令)。

Install / Use

npx skills add Besty0728/Unity-Skills

Installs into whichever agent you are using.

About this skill
⚡

Claude Commands

Claude Code slash commands

Quality Score

92/100

Supported Platforms

Claude Code

Tags

Our assessment of skillcheck

skillcheck scores 92/100 on our quality scale, 900th of 4,698 Development & Engineering skills we index (top 20%).

Its Claude Commands is 15 KB long, well organised into 22 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
18/20
Description
15/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so skillcheck is actively maintained.
  • Our last check on 2026-10-27 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

skillcheck compared with similar skills

All 4 of these similar skills score higher than skillcheck; compare them before choosing.

SkillScoreStarsUpdatedFormat
skillcheck (this skill)by Besty0728921.8k53d agoClaude Commands
claude-memby thedotmack100117.6ktodayCLAUDE.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md

Frequently asked questions

How do I install skillcheck?
Run npx skills add Besty0728/Unity-Skills. The install tabs above show the steps for each supported agent.
Which AI agents does skillcheck work with?
It is written for Claude Code, as a Claude Commands file. Other agents that read the same format can often use it too.
Is skillcheck safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is skillcheck still maintained?
The repository was last updated about 2 months ago, so skillcheck is actively maintained.

Skill Check — C# 代码与 SKILL.md 一致性审计 + 技能数量同步

你是 UnitySkills 项目的一致性审计助手。扫描所有 [UnitySkill] C# 定义与 skills/*/SKILL.md 文档,报告不一致问题;同时统计实际技能数量,与文档中声称的数字对比并修正(原 /skillcount 已并入本命令)。

目标

检测以下问题(这些是 v1.6.8 修复的那类 bug 的根源——文档声称支持的参数在代码中不存在):

  1. 幽灵 Skill:SKILL.md 中记录了但 C# 代码中不存在的 Skill
  2. 完全无文档的 Skill:C# 中存在 [UnitySkill] 但在整个 skills/ 文档树中完全无提及的 Skill(注意:本项目为 schema-first 设计——skill 无需逐个写 ### skill_name 定义,故"无 ### 定义"本身不算缺陷,详见步骤 3a)
  3. 参数不一致:SKILL.md 文档的参数表与 C# 方法签名不匹配(多余参数、缺失参数、类型不匹配)
  4. 元数据缺失:[UnitySkill] 特性中缺少 Category、Operation、Tags、Outputs 等关键元数据
  5. 数量失同步:文档(AGENTS.md / README / README_CN / SKILL.md)中声称的技能总数与模块计数表和实际代码不一致

步骤 1:收集 C# Skill 定义

扫描 SkillsForUnity/Editor/Skills/*Skills.cs 中所有 [UnitySkill(...)] 标记的方法:

  1. 对每个 Skill 提取:

    • Skill 名称([UnitySkill("skill_name", ...)] 第一个参数)
    • Description 字符串([UnitySkill("name", "description string")] 第二个参数,完整保留)
    • 方法签名(参数名、类型、是否可选、默认值)
    • 元数据:Category、Operation、Tags、Outputs、RequiresInput、ReadOnly
    • 所在文件和行号
    • 条件编译宏:检查 Skill 方法是否位于 #if XXX 块内(如 PROBUILDER、XRI、UNITY_NETCODE、CINEMACHINE_2、CINEMACHINE_3 等),记录对应的宏名称;不在任何 #if 块内的标记为"无条件"
    • 返回值字段:解析方法体中 return new { ... } 匿名对象的字段名列表(正则提取即可,不需要完美覆盖所有分支)
  2. 解析纪律(历史假绿源头,必须遵守):

    • 括号配平切分 attribute 块:一个 skill 的元数据只能取它自己 [UnitySkill(...)] 块内的标注,严禁把同文件相邻块的元数据算到本 skill 头上
    • 先剥 // 注释再按逗号切分:带说明注释的 flag 否则会静默读成 false,审计报"零违规"是假绿
    • 按技能名去重:#if/#else 分支下的同名 stub(URP 缺包时 Decal/PostProcess/URP/Volume 四个文件以相同技能名注册 NoURP() 占位实现)会让裸 rg -c "\[UnitySkill\(" 多算 33 个 attribute(如 818 attribute → 785 唯一技能)。一切后续比对和计数都以"按第一个字符串参数去重后的唯一技能名"为准
    • SkillRouter.cs 等非 *Skills.cs 文件中出现的 [UnitySkill( 多为注释/文档文字,不计入
  3. Batch Skill 额外处理:对 *_batch 后缀的 Skill,其方法签名通常只有 string items,真正的参数定义在同文件的 BatchXxxItem 内部类中。额外提取该类的所有 public 属性(属性名、类型、默认值),作为 batch skill 的"实际参数列表"。

  4. 汇总为 C# Skill 清单

步骤 2:收集 SKILL.md 文档定义

扫描 SkillsForUnity/unity-skills~/skills/*/SKILL.md 中所有记录的 Skill:

  1. 对每个 SKILL.md 提取:

    • Skill 名称(### skill_name 标题)
    • 参数表(| Parameter | Type | Required | ... 表格中的参数名和类型)
    • Batch Item Properties(**Item properties**: 后列出的属性名列表)
    • Returns 声明(**Returns**: 后花括号内的字段名列表)
    • 所属模块(目录名)
  2. 额外提取(按模块级别):

    • DO NOT 列表:从 ## Guardrails → **DO NOT** 区块提取被声称"不存在"的 skill 名。⚠️ 条目格式恒为 `幻觉名` does not exist → use `真实名`:只提取箭头 →(或 ->)左侧、紧邻 "does not exist"/"do not exist" 的 skill 名;箭头右侧 "use xxx" 是推荐替代的真实 skill,必须排除,绝不能当作"被声称不存在"。例如 `gameobject_move` / `gameobject_rotate` do not exist → use `gameobject_set_transform`:只取 gameobject_move、gameobject_rotate,排除右侧的 gameobject_set_transform。
    • Skills Overview 表格:从 ## Skills Overview 表格中提取所有列出的 skill 名
  3. 汇总为文档 Skill 清单

注意:动态识别 Advisory 模块并跳过。扫描每个 skills/*/SKILL.md 时,如果文档中没有任何 ### skill_name 格式的 Skill 端点定义,则视为 Advisory 模块(纯架构/设计指导),自动跳过,不参与后续交叉比对。不要硬编码 Advisory 列表。

步骤 3:交叉比对

3a. Skill 名称比对

Schema-first 前提:本项目文档采用 schema-first——精确的 skill 名/参数/返回由 GET /skills/schema(见各 SKILL.md 末尾 ## Exact Signatures 节)提供,模块 SKILL.md 无需为每个 skill 写 ### skill_name 定义。因此"C# 有但文档无 ### 定义"是预期正常态,不是缺陷。这与项目自带测试 SkillDocumentationConsistencyTests 一致——它只校验幽灵 skill,从不校验"未文档化"。

  • 取 C# 清单和文档清单的差集:
    • 文档有 ∩ C# 无 → 幽灵 Skill 🔴(唯一硬错误:AI 会尝试调用不存在的 Skill)
    • C# 有 ∩ 文档无 ### → 仅作 🟢 信息统计(schema-first 下非问题),不报 🟡 中等。仅当某 skill 在整个 skills/ 树中完全无任何提及(连 Route/Overview/参考文档都没有)时,才作为 🟢 建议提示补文档。

3b. 参数签名比对

对两边都存在的 Skill,逐个比对参数:

  • 文档多出的参数(高风险):文档声称支持但 C# 方法签名中没有 → AI 传参后被 SkillRouter 静默忽略
  • C# 多出的参数(中风险):C# 支持但文档未记录 → AI 不知道可以使用
  • 类型不匹配(低风险):文档写 string 但 C# 是 int 等

参数比对时注意:C# 方法可能有 = null、= 0、= false 等默认值,这些对应文档中 Required = No 的参数。

Batch Skill 特殊处理:对 *_batch Skill,不比对方法签名(固定为 string items),而是比对 BatchXxxItem 类的属性列表与文档中 **Item properties** 列出的属性名。规则同上:文档多出 → 高风险,C# 多出 → 中风险。同时检查 batch item 属性与对应单个 Skill 的参数是否一致(如 gameobject_create 有 x,y,z 但 BatchCreateItem 还有 rotX,rotY,rotZ,scaleX,scaleY,scaleZ,这种差异应标注但不算错误)。

3c. 元数据完整性检查

对每个 C# Skill 检查:

  • Category 是否已设置(非默认值)
  • Operation 是否已设置
  • Tags 是否非空
  • Outputs 是否非空(对有返回值的 Skill)

3d. Description 字符串一致性检查

[UnitySkill] 的 description 字符串是 AI 在 /skills 列表中看到的摘要,直接影响路由决策。检查:

  • Description 中提到的参数名是否都存在于方法签名中(或 BatchItem 属性中)。例如 description 写 {name, primitiveType, x, y, z} 但方法实际还有 parentName 等 → 遗漏不算错误,但 description 提到了方法签名中不存在的参数 → 🟡 中等
  • Batch Skill 的 description 中列出的 item 字段是否与 BatchXxxItem 类属性一致。例如 description 写 {name, primitiveType, x, y, z, parentName} 但 BatchItem 还有 rotX, scaleX 等 → 🟡 中等(遗漏关键参数)

3e. Returns / Outputs 一致性检查

背景:曾出现 prefab 模块 9 个 skill 里 5 个 Returns 与代码漂移的案例——文档 **Returns** 声明的字段与 C# 方法体实际 return new { ... } 已经不一致。仅靠"以 Outputs 为中转"的两两比对,在 Outputs 元数据本身缺失、未更新、或审计时提取有误差的情况下,容易漏掉"文档 Returns 与实际返回值直接对不上"这一漂移,因此下述三条边必须分别独立核对,不能只做两两传递、省略第三边。

三方独立交叉验证(三条边缺一不可,不依赖 Outputs 单点中转推导出第三边):

  1. Outputs 元数据 vs 文档 Returns:[UnitySkill] 的 Outputs = new[] { "field1", "field2" } 与文档 **Returns**: {field1, field2, ...} 中的字段名比对
  2. C# 实际返回值 vs Outputs 元数据:解析方法体中 return new { ... } 的字段名,与 Outputs 数组比对(正则提取,覆盖主路径即可,不要求 100% 覆盖所有分支)
  3. 文档 Returns vs C# 实际返回值(直接比对):把文档 **Returns**: {field1, field2, ...} 与方法体 return new { ... } 的字段名直接对照,不经 Outputs 中转——这是唯一能抓出"Outputs 和 Returns 一起漂移、彼此表面仍然对齐"这类案例的手段
  4. 任一边不一致标记为 🟡 中等(AI 依赖返回值做下一步决策,但不如参数不一致严重)

豁免 entityId:entityId 由 SkillRouter.GetEffectiveOutputs / GetSkillParameters / GetEffectiveDescription 在 /skills manifest 层对所有含 instanceId 的 skill 自动注入,因此不需要在静态 Outputs 元数据中显式声明。校验时遇到「C# return new { ... entityId ... } 含 entityId」或「文档 Returns 出现 entityId」而 Outputs 未声明的情况,一律不算不一致,跳过该字段(同理适用于 parentEntityId / childEntityId 等定位入参)。

3f. DO NOT 列表验证(反向幽灵检查)

扫描每个 SKILL.md 的 ## Guardrails → **DO NOT** 区块,只取箭头左侧声称"不存在"的 skill 名(箭头方向规则见步骤 2.2),与 C# 实际 skill 名清单交叉验证:

  • 如果某个箭头左侧声称"不存在"的 skill 实际已存在于 C# 中 → 🔴 严重(文档错误地否认了真实 skill)
  • 否则正常,无问题

⚠️ 此处最易误判:切勿把箭头右侧 "use xxx" 的推荐 skill 纳入校验——它们本就是真实存在的替代项。把右侧 skill 当成"被声称不存在但实际存在"会批量产出假阳性。正确预期:DO NOT 区块右侧推荐 skill 应 100% 真实存在、左侧幻觉 API 应 100% 不存在,故本项正常结果为 0 误报。

3g. Skills Overview 表格完整性

每个 SKILL.md 顶部的 ## Skills Overview 表格应覆盖该模块所有 skill。检查:

  • Overview 中列出但模块实际没有的 skill → 🟡 中等(误导读者)
  • 模块实际有但 Overview 未列出的 skill → 🟢 建议(不影响 AI 调用,但文档不完整)

3h. Mode 元数据 ↔ 文档一致性(v1.9.0+)

针对 Skill 模式权限系统(见 temp/skill-mode-permission-plan.md),扫描所有 [UnitySkill(...)] 中的 Mode = SkillMode.SemiAuto 标注(默认 FullAuto 无需标注)。

  1. 列出所有显式标注 Mode = SkillMode.SemiAuto 的 skill 名(含所在文件 & 行号)
  2. 与下列文档来源比对:
    • unity-skills~/skills/SKILL.md 主索引 Mode 列的 SA 标注
    • 每个模块 SKILL.md 的 ## Guardrails 区 **Mode** 字段
  3. 标注差异:
    • C# 标 SA 但文档无标注 → 🟡 中等(文档需补 SA 标注)
    • 文档标 SA 但 C# 未标 / 标了别的 → 🔴 严重(AI 看文档以为是 SemiAuto,实际走 FullAuto 流,Approval 模式下会无谓触发 grant)

3i. NeverInSemi 自动判定覆盖(v1.9.0+)

按 SkillsModeManager.IsForbiddenInSemi() 规则对所有 skill 自动判定(规则见方案第 8 节):

满足以下任意一条即 NeverInSemi:
- Operation 含 Delete flag
- MayEnterPlayMode = true
- MayTriggerReload = true
- RiskLevel == "high"(大小写不敏感)

校验:

  1. 覆盖统计:自动判定为 NeverInSemi 的 skill 总数(当前约 75-79),按模块分组列出

  2. 语义矛盾检测:若某 skill 同时被 Mode = SkillMode.SemiAuto 手标 + 满足自动 NeverInSemi 判定 → 🔴 严重(必须移除其 SA 标注,或调整元数据让其不再满足 NeverInSemi 规则)

    ⚠️ 判定必须逐 [UnitySkill(...)] attribute 块进行:一个 skill 的 Mode/Operation/RiskLevel/MayEnterPlayMode/MayTriggerReload 只能取它自己 attribute 块内的标注。严禁把同一 *.cs 文件中其他 skill(尤其相邻块)的 Operation=Delete 等元数据"按文件"或"按相邻"算到本 skill 头上。典型误判:查询类 xxx_find/xxx_list/xxx_get(实为 Operation=Analyze/Query 且标了 SemiAuto)被同文件的 xxx_delete 污染成"含 Delete"。建议用括号配平精确切分每个 attribute 块。正确预期:真实矛盾通常为 0。

3j. /permission/* 端点存活校验(可选 — 需服务运行)

如果当前 Unity Editor + UnitySkills server 正在运行,发起以下 HTTP 检查(推荐用 unity_skills.py 客户端函数):

  1. get_permission_status() → 响应必须含字段 mode、panelApprovalRequired、granted、pending、counts
  2. get_server_status()(GET /health)→ 必须含新字段 currentMode、panelApprovalRequired、pendingCount、grantedCount
  3. get_skills()(GET /skills)→ 每条 skill entry 必须含 mode 字段(值为 "semi" 或 "full")

任一字段缺失 → 🔴 严重(REST API 与文档/客户端不一致,AI 路由会出错)。

服务未运行时跳过本子步骤,在报告统计中标注「已跳过:服务离线」。

3k. SKILL.md Frontmatter 合规校验(Agent Skills 标准 + Codex/Claude 硬限)

背景:Codex / Claude 等原生 skill 发现器把每个含 SKILL.md 的子目录当成一个独立 skill 注册,并在 discovery 阶段读取其 frontmatter description 做触发匹配。description 超过 1024 字符会被直接拒绝加载该 skill(典型报错 Skipped loading N skill(s) due to invalid SKILL.md files)。本项目真实调用走顶层入口 + GET /skills/schema,子 description 应保持精简,避免触发该硬限。

扫描 unity-skills~/SKILL.md 及所有 unity-skills~/skills/**/SKILL.md(含 REST 与 advisory 模块),逐文件校验 frontmatter:

  1. description 长度 ≤ 1024 字符 → 超限 🔴 严重(该 skill 被发现器拒载,AI 完全看不到它)。注意按字符数(含中文)统计,非字节数。
  2. name 长度 ≤ 64 字符 → 超限 🔴 严重。
  3. YAML frontmatter 结构合法:文件以 --- 开头并正确闭合;name 与 description 两个必填键存在且非空 → 缺失 / 不闭合 → 🔴 严重。
  4. 无 UTF-8 BOM:文件开头不得有 EF BB BF 字节(SkillInstaller.cs 明确:BOM 会让部分 agent 拒析 frontmatter)→ 有 BOM → 🟡 中等。
  5. (信息项 🟢)discovery 总量:累加所有 SKILL.md 的 description 字符数,提示总和是否逼近发现器 ~8000 字符软预算(超出时发现器可能截断或省略部分 skill)。
  6. 根 SKILL.md 字节硬红线:unity-skills~/SKILL.md ≤ 8,192 字节(用户拍板的硬红线;v2.6.0 瘦身后长期在 8,1xx 徘徊)→ 超限 🔴 严重。口径 = LF 归一化后的 UTF-8 字节数,与 RootSkillDoc_ShouldStayWithinByteBudget 测试一致:tr -d '\r' < SKILL.md | wc -c,不要直接 wc -c——Windows 检出(core.autocrlf=true)会把 92 个换行写成 CRLF,同一份文档裸 wc -c 多出 92 字节(issue #59:8185 → 8277 假红)。报告中始终给出当前字节数与剩余余量;新增内容一律下沉 references/ 或模块文档,不进根文件。
  7. 行尾锁定(issue #59 回归闸):
    • 仓库根 .gitattributes 必须存在且含 *.md text eol=lf(缺失 → 🔴 严重:Windows UPM git 安装会在 PackageCache 检出 CRLF,用户无法自行修复)
    • unity-skills~/**/*.md 内不得含 \r(rg -l $'\r' unity-skills~ 应为空;命中 → 🟡 中等,说明有文件以 CRLF 提交,git add --renormalize . 后重新提交)
    • 任何按字节/哈希度量文件的测试或脚本,必须先做 \r\n→\n 归一化再计数(新增此类校验时同样适用)

正常预期:0 项超限、0 BOM、0 CRLF、.gitattributes 在位。本项是防止"超 1024 拒载"与"CRLF 假红"两类 bug 复发的核心闸门。

步骤 4:技能数量统计与文档同步(原 /skillcount,唯一允许写文件的步骤)

基于步骤 1 去重后的唯一技能清单做数量统计,与文档声称的数字对比并修正。

4a. 统计口径(历史踩坑,必须遵守)

  • 总数 = 唯一技能名数,不是 attribute 出现次数。裸 rg -c "\[UnitySkill\(" 会把 #if/#else 同名 stub 双算(Decal 7 + PostProcess 10 + URP 7 + Volume 9 = 33 个重复),禁止直接拿裸 grep 结果去改文档。
  • 模块计数表按 SkillCategory 归组,不按文件。枚举里没有 Batch 和 Diagnose:BatchSkills.cs 的技能拆进 Workflow + Validation,DiagnoseSkills.cs 的并入 Debug。按文件口径会误报 Workflow/Validation/Debug 三处"不一致"并"顺手"加出 Batch/Diagnose 两行——那是把正确的表改坏。
  • 相邻数字各有定义,别互相"对齐":*Skills.cs 文件数(55)≠ 功能模块数(54,Diagnose 无独立模块文档)≠ SkillCategory 数(53)。三者不同是自洽的。
  • 以工作区为基线:若存在未提交变更,数量以工作区为准,不要拿 HEAD 复核后误改。

4b. 读取文档中的数字

| 文件 | 搜索内容 | |------|---------| | AGENTS.md | 架构行的 56 *Skills.cs / 54 SkillCategory / 805 skills(无模块计数表) | | README.md | badge 数字、正文中的总数 | | README_CN.md | 同上中文版 | | SkillsForUnity/unity-skills~/SKILL.md | 总数引用 |

用 Grep 搜索文档中与实际总数不同的旧数字(如 \d+ 个 REST、\d+ Skills、Skills-\d+ 等上下文)。

⚠️ 不修改 CHANGELOG.md 中的历史条目 — 那些是版本发布时的快照。

4c. 对比并修正

如果实际总数与文档不一致:

  1. 替换总数:将文档中所有旧总数替换为实际统计总数
  2. 更新模块计数表:同步 README.md 和 README_CN.md 中的分类概要表(SkillCategory 口径;AGENTS.md 不再维护该表)

替换时注意上下文匹配,避免误替换(如版本号中的数字)。修正后用 rg -n "{旧数字}" 验证旧数字不再出现(非技能计数上下文除外)。

如果一致:不改任何文件,报告中输出 ✅ 所有文档中的技能数量已是最新({N} Skills)。

步骤 5:输出审计报告

按严重程度分级输出:

🔍 UnitySkills 一致性审计报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 统计
- C# Skills 总数:{N} 唯一(attribute {M} 个,#if/#else 同名 stub 去重 {M-N});无条件:{X},条件编译:{Y}
- 文档 Skills 总数:{M}
- 匹配:{X}
- Advisory 模块(自动跳过):{列出跳过的模块名}
- Mode = SemiAuto 标注:{N}(C# 显式手标)
- NeverInSemi 自动判定:{N}(纯元数据规则,无兜底名单)
- /permission API 校验:{已通过 / 已跳过:服务离线 / N 项失败}
- Frontmatter 合规:{通过(0 超限)/ N 项超限}(最长 description:{module} {len} 字符;discovery 总量:{sum} / ~8000 软预算)
- 根 SKILL.md 预算:{N} / 8192 字节(LF 归一化口径,余量 {8192-N})
- 行尾锁定:{✅ .gitattributes 在位、0 个 CRLF 文档 / 🔴 .gitattributes 缺失 / 🟡 N 个 CRLF 文件}

📊 数量同步(原 /skill

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.8k
CategoryDevelopment
Updated1mo ago
Forks165

Languages

C#

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions