Skill Doctor

skill-doctor — skill 合集 lint 工具

发布一个 skill 前,用本工具确认它符合合集的目录约定(SKILL.md frontmatter、README 徽章、bin/tests 配对等)。

何时触发

用户说"检查 skill / lint skill / skill 规范校验 / 这个 skill 合规吗 / 发布前检查"。

用法

检查单个 skill

bash skill-doctor/bin/lint-skill.sh 

示例(在合集根目录运行):

bash skill-doctor/bin/lint-skill.sh ./my-new-skill

遍历整个合集

for d in */; do
  [ -f "$d/SKILL.md" ] || continue
  bash skill-doctor/bin/lint-skill.sh "$d"
done

退出码说明

| 退出码 | 含义 | |--------|------| | 0 | 全部通过(或只有 warning) | | 2 | 存在 error 级问题,阻止发布 |

Error vs Warning

Error(exit 2,须修复才能发布):

1. 缺少 SKILL.md
2. SKILL.md 没有 YAML frontmatter(缺 --- 围栏),或 frontmatter 缺 name: / description:
3. frontmatter 的 name: 值与目录名不一致
4. 缺少 README.md
5. README.md 未包含 img.shields.io 徽章
6. 存在 bin/ 目录且里面有 .sh 文件,却没有 tests/run.sh

Warning(exit 0,建议改但不拦):

• description 为空或未含"触发"字样(建议 description 写明触发词)

边界

• 只检查目录结构与 frontmatter 格式,不校验 SKILL.md 内容质量。
• 不执行 tests/run.sh(只检查文件是否存在);要跑测试请单独执行。
• 纯 bash,零外部依赖。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: YuAICode
• Source: YuAICode/ai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.