用途:write-a-skill 用于创建新的 Agent 技能,强调规范结构、渐进披露(progressive disclosure)和打包资源。当用户想要创建、编写或构建新技能时使用。
主要能力与流程:
- 收集需求:向用户询问技能覆盖的任务/领域、应处理的具体用例、是否需要可执行脚本或仅需说明、是否包含参考材料。
- 起草技能:创建 SKILL.md(简明说明);若内容超过 500 行则增设参考文件;如需确定性操作则添加工具脚本。
- 与用户评审:确认是否覆盖用例、是否有遗漏或不清晰之处、某节是否需要更详细或更精简。
技能结构:skill-name/ 目录含 SKILL.md(必需),可选 REFERENCE.md、EXAMPLES.md 及 scripts/(如 helper.js)。
SKILL.md 模板:含 frontmatter 的 name 与 description,正文分 Quick start、Workflows、Advanced features,并可用链接指向单独文件,如 See REFERENCE.md。
description 要求:是 Agent 决定加载哪个技能时唯一看到的内容,会与其他已安装技能一同出现在系统提示中。目标:说明该技能提供什么能力、何时/为何触发(具体关键词、上下文、文件类型)。格式:最多 1024 字符,第三人称,首句写它做什么,第二句写 Use when [specific triggers]。示例:Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction. 反例:Helps with documents.
何时添加脚本:操作是确定性的(验证、格式化)、同一段代码会被反复生成、错误需要显式处理时。脚本相比生成代码可节省 token 并提升可靠性。
何时拆分文件:SKILL.md 超过 100 行、内容属于不同领域(如 finance 与 sales schema)、高级功能很少需要时。
评审清单:description 含触发词(Use when...);SKILL.md 少于 100 行;无时效性信息;术语一致;包含具体示例;引用只嵌套一层。
限制:资料未提供收费、价格、平台或安装命令等额外信息。