该技能用于协助用户编写 Agent Skill，即一个 SKILL.md 文件（可选 references/ 与 scripts/），用来教 AI 智能体完成某类重复任务。在 OpenKnowledge 中，技能是一等、可版本化、可安装的产物：先用 write / edit 技能动词编写，再安装到用户的编辑器中。
主要流程分八个阶段。第一，捕获意图并分类技能：先用 skills({}) 列出已有受管技能，用 skills({ name }) 读取可能匹配项，并用 skills({ query: "<2-4 个触发词>" }) 搜索公开市场；若已有或公开技能基本覆盖需求，应停止并建议复用，避免触发词重叠造成误触发。需要确认的信息包括具体重复任务示例、技能类型（参考/技巧类或纪律类）以及自由度高低。第二，明确作用域，不能静默推断：Global 存放于家目录技能根（如 ~/.claude/skills/<name>/）并分发到所有项目的编辑器；Project 存放于仓库技能根（如 .claude/skills/<name>/）并随 git 共享。若所在仓库本身是技能分发仓库或插件，则需按该仓库既有布局编写，不放入 .claude/skills/，也不执行安装。第三，规划内容：正文应控制在约 500 行以内，超出部分拆入 references/<topic>.md；不要包含 README、CHANGELOG、安装说明或版本历史。
编写时用 write({ skill: { name, description, body, scope } }) 创建；frontmatter 仅含 name（小写字母、数字、连字符，≤64，须等于目录名）和 description（≤1024 字符，无 XML 标签，无 version 字段）。深度文件通过技能动词管理，例如 write({ skill: { name, files: [...] } })、edit({ skill: { name, file, find, replace } })、skills({ name, file }) 读取、delete({ skill: { name, files } }) 删除；路径须为技能相对路径且不可越出技能目录。
纪律类技能需先做 RED 基线（在无技能时运行场景，记录错误与借口），写完后做 GREEN 评估并用多重压力测试确认仍遵守规则；参考类技能只需确认任务正确完成且正文不过长。描述是智能体判断是否加载的唯一依据，应写触发时机而非正文摘要，要具体并适当主动。安装用 install({ name, add: [...] })，可用 mode: "link" 或 "copy"，convert 改变单个位置形式，source 移动真实目录；安装是叠加式，不会重写未指定的位置。技能没有草稿态，源目录本身即为技能；删除整个技能须用 delete({ skill })，项目技能可用 history({ skill }) 与 restore_version 回滚，global 技能在当前构建中无版本化。含可执行 scripts/ 的技能会被原样投射到其他智能体的信任域，应仅包含用户已审查过的脚本。