工具与校验

最后校验：2026-05-30

工具不能替你写出好 Skill，但能帮你减少低级错误、加快验证和安装流程。建议把工具分成三类：创作、安装、校验。

创作工具

skill-creator

skill-creator 是 Anthropic 官方示例库中的创作型 Skill。它本身也是一个 Skill，用来帮助你生成新的 Skill 草稿。

适合：

• 第一次写 Skill
• 需要交互式澄清需求
• 想自动生成目录骨架
• 想获得 description 触发词建议

使用思路：

Use the skill-creator skill to help me build a skill for [your use case].

它通常会协助你：

• 收集目标任务
• 判断是否需要 scripts/、references/、assets/
• 生成 SKILL.md 初稿
• 提醒常见边界和触发场景

TIP

skill-creator 生成的是草稿，不是免审成品。交付前仍要跑 评估 Skill 和 安全与信任模型 的检查。

安装工具

npx skills add

社区常见安装方式：

npx skills add --skill webapp-testing

从远程仓库安装：

npx skills add https://example.com/org/my-skill.git --agent codex

指定目标 agent：

npx skills add --skill pdf-form-filler --agent claude-code

安装前要确认：

• 来源是否可信
• 是否包含脚本
• 是否声明工具权限
• 是否会联网或上传数据

校验工具

skills-ref

skills-ref 是 agentskills.io 参考实现中的校验工具，适合检查基础格式：

skills-ref validate ./my-skill

典型检查：

✓ name field valid (matches directory)
✓ description length within 1024 chars
✗ Found README.md in skill directory — recommend removing
✗ scripts/helper.py uses Windows-style path

适合发现：

• frontmatter 语法错误
• name 与目录不一致
• description 超长或为空
• 不推荐的目录结构
• 路径风格问题

skillgrade

社区质量评分工具通常会做更高阶的检查：

• description 是否过宽或过窄
• 是否有触发评估样例
• 是否覆盖边界场景
• 是否有 with / without 对照
• 是否可运行脚本与测试集

这类工具适合在团队内做质量门禁，但不要把分数当成唯一标准。

IDE 集成

不同 IDE 与 agent 客户端逐步支持 Skill 编辑能力：

• 目录识别
• frontmatter lint
• 路径补全
• Skill 列表浏览
• 显式触发入口
• marketplace / catalog 安装

如果你的团队统一使用某个 IDE，可以把 Skill 存放路径和校验命令写进项目文档。

校验流水线建议

项目级 Skill 可以加入 CI：

检查 frontmatter
  ↓
检查路径与目录结构
  ↓
跑触发评估样例
  ↓
跑关键脚本 smoke test
  ↓
检查链接与引用文件是否存在

最低门槛：

• [ ] skills-ref validate 通过
• [ ] SKILL.md 少于 500 行
• [ ] 没有同目录 README.md
• [ ] 所有引用文件存在
• [ ] 所有脚本至少支持 --help 或可执行 smoke test

工具选择建议

需求	优先工具
创建第一个 Skill	skill-creator
安装社区 Skill	npx skills add 或平台内置 marketplace
检查基础格式	skills-ref
检查触发质量	自建 eval / skillgrade 类工具
团队门禁	CI + format validate + smoke test

下一步

• 看优秀范例：Catalog 与示例。
• 看平台差异：平台兼容性。
• 看 Codex 专属配置：Codex Skills。