用途：write-a-skill 用于把工作流正式化为可复用、可分享的智能体技能，也用于从零构建新的智能体能力，或把既有模式文档化以便智能体发现和使用。
关键设计原则：技能描述字段是智能体决定是否加载该技能时唯一能看到的内容，因此描述需写明技能做什么、包含具体触发语（如“Use when [context]”）、不超过 1024 字符，并精确到智能体能判断是否激活。
流程分三阶段。一、收集需求：明确该技能形式化什么任务或工作流、触发条件、边界（不做什么）、目标平台，以及是否与现有技能重叠。二、草拟技能：以 SKILL.md 为核心文件，控制在 100 行以内；当超出约 100 行、内容涉及用户并非总是需要的不同领域、或示例会挤占核心指令时，拆分到附加文件，支持 REFERENCE.md（详细参考）、EXAMPLES.md（具体示例）、scripts/（确定性工具脚本）。三、与用户评审：确认描述能否在正确请求上触发、指令是否清晰完整、边界能否防止误用、是否需要附加文件。
资料给出 jeo-skills 格式的 SKILL.md 模板，元数据包含 name、description、allowed-tools、compatibility、metadata（tags、platforms、version、source）；正文包含何时使用、何时不使用（并路由到具体技能）与核心指令。质量清单要求描述低于 1024 字符、含触发语、SKILL.md 低于 100 行、when-not-to-use 路由到具体技能、tags 覆盖可发现关键词、描述中不写实现细节。
限制：上游状态已被 writing-for-agents 取代，因 find-skills、upskill、solo-skills、openocta 仍指向它而保留。资料未提供安装命令、平台支持范围以外的细节、收费或定价、效果数据。参考包含项目标准与校验脚本路径。