该技能用于创建或扩充技术文档,适用场景包括编写新的 Agent Skill、更新已有技能,以及修改 AGENTS.md、README 等项目文档。
使用流程:先明确要记录的主题,不清楚时向用户确认;再确定目标。如果是 Agent 技能文档,先扫描已有技能的 description 字段做关键词匹配,找到潜在匹配后读取其内容确认是否合适:用户指定了某个技能且合适则继续;用户要求新技能且没有合适技能则创建;否则先与用户讨论再推进。若是 AGENTS.md、README 等通用文档,直接进行。
技能类文档需决定内容放置位置:SKILL.md 放使用该技能所必需的内容,references/ 放可选的详细内容。编写时面向“有经验的新手”,简洁具体,不写显而易见的信息或泛泛的最佳实践,标题清晰、目的明确。新文档通常 40–80 行,SKILL.md 不超过 500 行,代码片段保持简短并引用源文件获取完整示例。
新建技能时目录为 {skills-dir}/skill-name/,SKILL.md 为必需文件,其 frontmatter 需包含 name 和 description,name 必须与目录名一致,使用小写加连字符。
此外还提供可选的 Bootstrapping 模式:当用户要求通过分析代码库来生成技能(而非请求某个具体技能)时,先阅读 Bootstrapping Skills,即使已存在可复用技能,目标仍是生成项目专属文档。
限制与约束:参考资料提及 Agent Skills specification 与 Bootstrapping Skills,但除上述范围外,技能的更多细节、安装方式、平台支持与收费情况暂未提供。