「skill-lint」在上传前检查 Agent Skills 的 SKILL.md

skill-lint 是一个给 Agent Skills 做体检的小工具。它检查的是每个技能目录里的 SKILL.md：frontmatter 写法对不对，name 有没有缺失，名字是不是符合小写短横线格式，目录名和技能名是否一致，description 长度是否超标，引用的相对文件是否真的存在。

这类工具看起来很小，但对正在维护技能库的人很实用。因为很多 Agent Skill 的问题不是运行时报错，而是上传到 Claude.ai、接入 Claude Code 或其它 agent 时才发现格式不合规。skill-lint 的定位就是把这些问题提前挡在本地或 CI 里。

适合放进技能仓库的 CI

README 里给了 GitHub Action 用法：在 push 或 pull request 时跑 himself65/skill-lint@v3，默认检查指定的 skills 目录。也可以通过 claude: 'true' 开启 Claude.ai Web 上传相关的额外限制，例如名称里不能包含 reserved words，description 里不能出现尖括号。

命令行用法也很直接：npx skill-lint ./skills。如果你在做一个公开的技能合集，或者公司内部有一批 agent 工作流文档，这个 lint 步骤可以减少很多低级返工。它还提供 --json 输出，方便接到自定义脚本或仪表盘里。

检查项覆盖了最常见的坑

它会把缺少 SKILL.md、frontmatter 无效、未知字段、description 过长、metadata 格式不对、正文行数或 token 过多、引用层级太深、引用文件缺失等问题标出来。对单个技能作者来说，这像一个小型规范助手；对维护者来说，它能把 review 里最机械的部分自动化掉。

项目本身是 TypeScript 写的，MIT 许可证，既能作为 GitHub Action，也能作为 npm CLI 和程序化 API 使用。它的 star 数还不高，但正好踩在 Agent Skills 生态刚开始变多的节点上：当技能越来越像“可分发的工作流包”，lint 工具就会变得越来越有必要。