update-skill 是帮助作者在对应仓库创建或修改 SKILL.md 的 Skill，处理名称、描述、正文结构和参考资料组织。你提供已有指令及适用场景，AI 会按仓库约定整理成更容易识别和维护的技能文件。
它把描述字段看得很重。描述既要说做什么，也要说什么时候用；“帮助开发”过于笼统，“根据代码差异生成提交信息，适用于准备提交或检查暂存改动”才给出了可识别的任务。
正文结构没有要求每篇都一样。简单技能可以直接写清步骤，复杂内容则把详细材料放到参考目录，只在入口留下关键流程和清晰链接，避免每次加载都带入大量暂时用不到的内容。
原文还提供了可选的格式验证路线，用来检查前置元数据和命名约定。但格式通过只说明文件结构符合规则，不代表 Agent 一定能在所有请求下正确选择它。
这份指南以 Warp 仓库约定为背景，适合正在维护 Skill 文件的人。使用时应结合目标环境的规范，重点把能力边界与触发场景写具体。