Agent Skills Creator 用于在 Agent Skills 开放格式下创建和改进技能,覆盖从模式选择到验证、README 更新的完整生命周期。
用途
它面向两类工作:创建新的 agent skill,以及审计或重写已有的 skill,包括 SKILL.md、references、规则文件夹、脚本和评估。它明确不用于 AGENTS.md/CLAUDE.md 指令文件,也不用于一般文档质量改进。
主要能力
它提供模式选择、目录与前置元数据创建、SKILL.md 正文撰写、参考或规则文件添加、验证、README 更新、安装冒烟测试和评估迭代等工作流。它附带多个参考文件,分别覆盖能力差量、撰写技巧、技能模式、格式规范、规则文件夹结构、改进已有技能、可执行代码、评估与迭代、以及在自建、改编或采用第三方技能之间的决策。
使用方式
创建新技能时按步骤执行:选择模式;创建目录和 frontmatter;撰写 SKILL.md 正文;添加参考或规则文件;验证;更新 README.md(以及 docs/skills.mdx);冒烟测试安装;评估并迭代。审计已有技能时,先阅读 references/improving-existing-skills.md,该流程会从十一个维度评分,执行有序重写,并复用第 5 至第 8 步完成验证与交付。简化技能或更新集合也使用同一参考,并结合 references/capability-delta.md 做保留决策和集合台账。
验证使用本地脚本,从仓库根目录运行:
skills/agent-skills-creator/scripts/validate.sh skills/<name> # one skill skills/agent-skills-creator/scripts/validate.sh --all # every skill in the repo
输出会区分格式要求与仓库约定,包括被采纳为本地门禁的建议。所有 FAIL 都需要修复。也可运行 skills-ref validate <dir> 做独立的元数据和命名检查,但这些检查都不代表行为质量或对所有宿主的兼容性。
适用场景
适用于新建 agent skill、审计或重写已有 skill、简化 skill 或更新集合、处理 skill 触发错误或描述在拥挤列表中被截断的问题,以及避免技能在无人要求的情况下过早交回审查。
限制
已安装到 ~/.agents/skills/<name>/ 的副本是复制而非指向仓库的链接,编辑仓库不会影响运行中的会话,陈旧副本会静默加载。不要为冒烟测试覆盖全局安装,也不要用远程默认分支作为未推送更改的证据。验证器只能检查机械门禁,无法判断描述是否会正确路由。