用途:验证一个技能库是否一致、最新,并可用于分享或安装。
主要能力:validate 检查必填字段、文件夹一致性、frontmatter 有效性、集合完整性与生成文档同步;doctor 检查已安装技能健康度;check 查找可能需要更新的技能;build-docs --dry-run 验证生成文档是否同步;curate review 查看需要关注的技能队列。
使用方式:自动化健康检查时始终加 --format json;运行 build-docs 前先用 --dry-run 检查文档是否已同步;检查大型目录时用 --fields 限制输出。常用命令:npx ai-agent-skills validate、npx ai-agent-skills doctor --format json、npx ai-agent-skills check --format json、npx ai-agent-skills build-docs --dry-run --format json;若 currentlyInSync 为 false,则运行 npx ai-agent-skills build-docs 重新生成;npx ai-agent-skills curate review --format json 查看待处理队列。
健康清单:validate 无错误通过;doctor 无损坏安装;build-docs --dry-run 显示文档同步;无 whyHere 字段为空的技能;所有 house 技能在 skills/ 下有对应文件夹;skills.json 总数与实际技能数一致。
限制:validate 与 doctor 为只读,不会修改库;check 会发起网络请求验证上游来源,可能较慢或在不可达仓库上超时;curate review 队列基于缺失字段与过期验证日期推导,属于启发式提示而非强制要求。未通过 validate 与 doctor 前,不要将库推送到共享仓库。