用途：当用户想创建、创作、编写或设计一个新的 Agent Skill（即 SKILL.md，可含可选 references/ 与 scripts/）时使用，目标是让 AI 智能体学会执行某一重复性任务。在 OpenKnowledge 中，技能是一等、可版本化、可安装的产物：用 write / edit 技能动词编写，再安装进用户编辑器。
核心流程： 1）捕获意图并分类前先查重：用 skills({}) 列出受管技能，用 skills({ name }) 读取可能匹配项；可再用 skills({ query: "<2-4 个触发词>" }) 搜索公开市场，必要时用 import({ source, skill: name, add: [...] }) 导入。若已有或公开技能覆盖大部分需求，应停止并建议复用。 2）先明确范围且不得静默推断：Global 存于主目录技能根（如 ~/.claude/skills/<name>/），install 分发到所有项目的编辑器；Project 存于仓库技能根（如 .claude/skills/<name>/ 或 .agents/skills/ 枢纽），随 git 共享。若所在仓库本身是技能分发仓库（插件或目录仓库），则不适用上述两种范围，应按该仓库既有布局写在同级技能旁，不要安装。 3）规划内容：正文为持久可复用指令，约 500 行以内；超长则拆入 references/<topic>.md 并在正文指向。不要包含 README/CHANGELOG/QUICK_REFERENCE、技能自身安装说明、版本历史或宿主专有内容。 4）纪律类技能需 RED 基线：写前在无技能的新会话运行场景，逐字记录错误与借口，作为正文要堵的漏洞；参考类技能可跳过。 5）用 write({ skill: { name, description, body, scope } }) 编写。前言契约：name 为小写字母、数字、连字符，≤64，与目录同名；description ≤1024 字符，无 XML 标签，无 version 字段。深度文件用 write({ skill: { name, files: [{ path, content }] } }) 添加，路径须在技能目录内，references 保持一层深度。 6）运行 GREEN 评估：参考类确认任务正确完成；纪律类叠加 2–3 种压力并确认仍守规则，再补漏洞复测。 7）优化 description：只写触发时机（用用户措辞、动词、具体情境），不写正文摘要，避免智能体只读描述而跳过正文。 8）安装：install({ name, add: [...] }) 增加位置，remove 移除，mode 仅作用于本次命名的位置，convert 改变某位置形式（copy 或 link）。符号链接指向源不会漂移；复制可自动刷新，手工编辑会分叉。
限制：无“到处卸载”，删除所有其他位置后源文件夹仍对其智能体加载；技能只通过 delete({ skill }) 消失。项目技能可用 history 回滚，全局技能在此版本无版本化。包含可执行 scripts/ 的技能会原样投射到另一智能体的信任域，只应包含用户已审阅的脚本。缺失事实：官方正文未提供。