创建高质量技能,采用模块化结构、渐进式展示和令牌高效设计。
设置 : 在第一次使用时, 读取集成准则的设置是一项面向实际任务的技能,主要用于用户想要创建或改进技能;代理引导结构, 审查内容, 并确保质量;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
首次使用时,请阅读 setup.md 了解集成指南。
用户希望创建或改进某项技能时使用。Agent 负责引导结构设计、审核内容并确保质量。
若用户需要项目跟踪功能,请在其主目录下创建对应文件夹。
参考 memory-template.md 查看模板结构。
Agent 不会自动创建文件。务必先征得用户同意。
技能遵循如下目录结构:
skill-name/ ├── SKILL.md # 核心指令(简洁版) ├── [topic].md # 按需加载的详细说明 └── references/ # 大型文档(可选)
| 主题 | 文件 |
|---|---|
| 设置流程 | setup.md |
| 项目跟踪 | memory-template.md |
| 模式与示例 | patterns.md |
目标行数为 30–50 行,上限为 80 行。细节内容应移至辅助文件中。每一行都必须具备明确的 token 价值。
第 1 层:元数据(名称 + 描述)——始终加载 第 2 层:SKILL.md 正文——技能触发时加载 第 3 层:辅助文件——按需加载
仅用一句话,长度控制在 15–25 词之间;首词必须为动作动词;描述技能能力本身,而非触发条件。
| ❌ 错误示例 | ✅ 正确示例 |
|---|---|
| “当用户需要 PDF 文件时使用” | “处理、合并及提取 PDF 内容” |
| “Docker 辅助工具” | “构建、部署和调试 Docker 容器” |
| “Git 使用指南” | “管理分支、解决冲突并自动化工作流” |
更多示例请参见 patterns.md。
每项技能必须包含以下三部分:
## 当前适用场景 —— 激活触发条件## 核心规则 —— 3–7 条编号规则若内容超过 20 行,或仅为特定场景所需,则应拆分为独立文件,并在“快速参考”表格中建立引用关系。
所有信息仅存在于一个位置。SKILL.md 可引用其他文件,但不得重复其内容。
以初次接触该技能的 Agent 视角通读全文:每条指令是否清晰、必要?
| 陷阱 | 失败原因 | 修正方式 |
|---|---|---|
| 解释“X 是什么” | 模型已具备相关知识 | 改为说明“何时使用”与“如何使用” |
| 在描述中写“当……时使用” | 浪费字符空间 | 仅使用动作动词 |
| 在描述中罗列关键词 | 显得类似垃圾信息 | 保持一句干净利落的表述 |
| 将模板直接写入 SKILL.md | 导致 SKILL.md 膨胀 | 移至单独文件 |
| 使用模糊的“观察”类指令 | 易被判定为可疑行为 | 明确指出需采集的具体数据类型 |
| 未声明即创建文件 | 触发安全机制警告 | 在文档中添加“数据存储”章节予以说明 |
如用户确认安装,可运行:clawhub install
skill-manager —— 管理已安装的技能skill-update —— 更新现有技能skill-test —— 在本地测试技能clawhub star skill-builderclawhub sync相关专题
热门下载
相关下载
精品课程
共6课时 | 54.6万人学习
共89课时 | 133.4万人学习
共49课时 | 82.2万人学习