| name | skill-verification |
| description | Verify that a created or imported skill conforms to this project's skill conventions. Use when the user asks to check, validate, or review a skill; or after creating/importing a skill to ensure it will load and behave correctly. |
Skill 验证
本技能说明如何验证新建或导入的技能是否符合本项目的技能设定。验证通过后，技能会出现在「Skills 配置」列表中并被加入 Agent 的系统提示。
何时使用
- 用户要求检查、验证或审阅某个技能时
- 新建或导入技能后，确认其能正确加载时
- 技能未在列表中显示或未被 Agent 使用时，排查是否符合规范时
本项目技能设定摘要
- 基础路径：所有路径均相对于应用运行目录（
AppDomain.CurrentDomain.BaseDirectory）。
- 系统技能：
.agents/sys.skills/，只读，随应用发布。子目录名 = 技能 id。
- 用户技能：
.agents/skills/，可通过应用 UI 增删改、导入。子目录名 = 技能 id。
- 加载规则：仅当目录内存在
SKILL.md 且其 YAML frontmatter 合法（含 name 和 description）时，该目录才会被当作技能加载；否则不会出现在列表和系统提示中。
- Frontmatter：本应用只解析
name 和 description，其他字段（如 allowed-tools）当前不解析，可省略。
- ReadFile：读取技能内文件时，路径为相对运行目录，例如
.agents/sys.skills/<id>/SKILL.md 或 .agents/skills/<id>/references/xxx.md。
验证步骤
1. 检查技能位置与结构
- 技能目录必须位于以下之一（路径相对运行目录）：
.agents/sys.skills/<id>/.agents/skills/<id>/
- 目录内必须存在 SKILL.md。
- 若为新建/导入技能，确认 id（目录名）已做合法化（无效路径字符会被替换）。
不符合：出现 ~/.claude/skills/、.claude/skills/ 等非本项目路径，或技能未放在 .agents 下。
2. 检查 SKILL.md frontmatter
用 ReadFile 读取该技能的 SKILL.md（例如 .agents/skills/<id>/SKILL.md），确认：
- 第一行为
---，且存在闭合的 ---。
- 在 frontmatter 中必须包含：
- name：非空，建议小写、连字符，与目录名一致或作为展示名。
- description：非空，建议同时说明「做什么」和「何时使用」。
- YAML 合法：无 tab、缩进正确；若含引号需成对。
不符合：缺少 name 或 description、拼写错误、或 frontmatter 无效（会导致该目录不被加载）。
3. 检查正文与引用是否符合本项目
- 产品/环境表述：正文和 description 中不应出现「Cursor」「Claude」等其它产品名。应使用「本应用」「the agent」「应用运行目录」等表述。
- 路径：不得出现
~/.claude/skills/、.claude/skills/。应使用 .agents/sys.skills/、.agents/skills/（并说明相对运行目录）。
- 加载方式：不得写「Restart Cursor」或「重启以加载」。应说明：添加/导入后应用会自动重建 Agent，无需重启。
- 调试方式：不得出现
claude --debug 等本应用不存在的 CLI。应说明通过「Skills 配置」或 ReadFile 验证路径与内容。
- 引用技能内文件：若提示 Agent 用 ReadFile 读本技能其它文件，应给出运行目录相对路径，例如
.agents/sys.skills/<id>/references/xxx.md。
4. 可选自检
- 在应用工具栏打开「Skills 配置」，确认该技能出现在列表中（系统或用户），且名称、描述显示正常。
- 若为用户技能，可发送与 description 匹配的提问，确认 Agent 会选用该技能（必要时通过 ReadFile 读取 SKILL.md）。
验证清单（逐项打勾）
输出建议
验证完成后，可向用户简要说明：
- 符合：列出已满足的项，并说明技能应已出现在「Skills 配置」且可被 Agent 使用。
- 不符合：列出不满足的项及对应修改建议（如：将某路径改为
.agents/skills/<id>/，或将「Claude」改为「the agent」）。
