用途:该技能用于创建、测试或发布 OpenClaw 技能,需要编写 SKILL.md、配置 metadata 门控、组织参考文件路由或了解 ClawHub 发布时使用。不适用于通用 OpenClaw 运行时配置、构建 MCP 服务器、技能系统之外的智能体编排逻辑,以及修改 OpenClaw 核心或内置技能。
主要能力:提供新技能的完整工作流,包括命名、目录结构、frontmatter 编写、描述撰写、正文组织、metadata 门控、参考文件整理、测试和发布。给出了必须遵守的规则,如 SKILL.md 是唯一必需文件、frontmatter 必须从第 1 行开始、不得含尖括号、名称不得含 claude 或 anthropic、描述不超过 1024 字符、正文不超过 500 行、metadata 必须为单行 JSON、references 中每个文件都必须被路由。
使用方式:提供决策树按任务路由到参考文件;新技能按 kebab-case 动词-名词命名,创建包含 SKILL.md、可选 references/、scripts/、assets/ 的目录;frontmatter 必填 name 与 description;测试时明确选择运行时路径或 dry-run 路径,运行时测试需复制到 <workspace>/skills/<name>/ 或 ~/.openclaw/skills/<name>/ 并确认出现在 openclaw status 中;发布前读取 ClawHub 发布清单。
适用场景与限制:适用技能创建、frontmatter 配置、门控、参考组织、测试与发布;技能发现位置有优先级,workspace 高于个人目录,个人目录高于 npm 打包,名称冲突时高优先级胜出。技能消耗 token 分发现、激活、深度参考三层。限制包括运行时测试具有二元性,无运行时或写入权限时只能做 dry-run 并将运行时验证标记为受阻;不得声称经过运行时测试除非已安装且可见。