mcpField
V
validate-skills

validate-skills

github.com/callstackincubatorAgent 工作流1.7k7.3k 次安装3 周前更新
代码仓库

关于 validate-skills

用于按照 agentskills.io 规范和 Claude Code 最佳实践检查 `skills/` 中技能的技能。它指导审核者检查元数据、描述、引用链接和内容结构。

主要功能

  1. 01检查技能名称及目录匹配
  2. 02验证描述和可选字段
  3. 03审查正文长度与引用结构
  4. 04检查 Markdown 链接和内容冗余

适用场景

  1. 01发布前审查技能目录
  2. 02查找无效的技能元数据
  3. 03识别无法从入口访问的引用文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills

安装后在 Claude Code 中输入/validate-skills确认已加载。

详细介绍

验证技能

根据 agentskills.io 规范和 Claude Code 最佳实践，验证 skills/ 中的所有技能。

验证清单

针对每个技能目录，检查：

规范合规性（agentskills.io）
检查项规则
name 格式1-64 个字符，仅包含小写字母、数字和连字符；不能以连字符开头或结尾，也不能包含连续连字符
name 与目录匹配目录名称必须与 name 字段相同
description 长度1-1024 个字符，不能为空
可选字段有效如果存在，检查 license、metadata、compatibility
最佳实践（Claude Code）
检查项规则
描述格式使用第三人称，说明功能和适用场景
正文长度少于 500 行
加载深度为一层SKILL.md 是渐进式披露的唯一入口：每个参考文件都必须能从 SKILL.md 访问。参考文件之间可以交叉链接以便导航（见下方说明）。
链接使用 Markdown 格式使用 [text](path)，而不是单独的文件名
不重复不要在正文中重复描述
简洁只添加 Claude 尚不了解的上下文

一层加载深度与交叉链接。 一层加载深度规则针对的是渐进式披露加载链——必须先加载另一个参考文件才能发现某个参考文件（SKILL.md → a.md → b.md，其中 b.md 未在 SKILL.md 中链接）。这是一个缺陷：它会使加载器无法发现相关内容。

该规则不禁止导航性交叉链接。根据 AGENTS.md，参考文件末尾必须包含指向同级参考文件的“Related Skills”页脚，这是必需的。只要交叉链接两端都能从 SKILL.md 直接访问，就没有问题。只有那些只能通过另一个参考文件访问的文件才需要标记。

运行方法

  1. 查找所有技能目录：

    fd -t d -d 1 . skills/

  2. 对每个技能，阅读 SKILL.md 并根据上述规则进行检查

  3. 按以下格式报告问题：

    ## Validation Results

### skills/example-skill
- [PASS] name format valid
- [FAIL] name "example" doesn't match directory "example-skill"
- [PASS] description length OK (156 chars)

参考资料

评论

支持 Markdown