技能创建指南
Skill Creator - 创建或更新 Agent Skills
设计、结构化、打包技能的完整指南
什么是 Skills：
Skills 是模块化的自包含包，通过提供专业领域知识、工作流程和工具来扩展 AI 能力。它们是特定领域或任务的"入职指南"——将通用 AI 转变为配备程序性知识的专业代理。
Skills 是模块化的自包含包，通过提供专业领域知识、工作流程和工具来扩展 AI 能力。它们是特定领域或任务的"入职指南"——将通用 AI 转变为配备程序性知识的专业代理。
Skills 提供什么
1. 专业工作流程
特定领域的多步骤程序，从概念到落地的完整流程
2. 工具集成
与特定文件格式或 API 配合的说明，如 GitHub、飞书、Wwise 等
3. 领域专业知识
公司特定知识、架构模式、业务逻辑、最佳实践
4. 捆绑资源
脚本、参考资料和资产，用于复杂和重复性任务
核心原则
简洁是关键
上下文窗口是公共资源。Skills 与系统提示、对话历史、其他 Skills 的元数据共享上下文窗口。
默认假设：AI 本身已经非常聪明。 只添加 AI 不知道的信息。挑战每一条信息："AI 真的需要这个解释吗？"
上下文窗口是公共资源。Skills 与系统提示、对话历史、其他 Skills 的元数据共享上下文窗口。
默认假设：AI 本身已经非常聪明。 只添加 AI 不知道的信息。挑战每一条信息："AI 真的需要这个解释吗？"
设定适当的自由度
🔓 高自由度
基于文本的说明
适用：多种方法都有效，决策依赖上下文，启发式指导方法
🔐 中等自由度
伪代码或带参数的脚本
适用：存在首选模式，可接受一些变化，配置影响行为
🔒 低自由度
特定脚本，参数少
适用：操作脆弱易错，一致性至关重要，必须遵循特定序列
Skills 结构
skills/
└── your-skill/
├── SKILL.md # 必需：技能定义和说明
├── README.md # 可选：用户可见的文档
├── scripts/ # 可选：脚本和工具
│ ├── setup.sh
│ └── helper.py
└── references/ # 可选：参考资料、案例
└── examples.md
└── your-skill/
├── SKILL.md # 必需：技能定义和说明
├── README.md # 可选：用户可见的文档
├── scripts/ # 可选：脚本和工具
│ ├── setup.sh
│ └── helper.py
└── references/ # 可选：参考资料、案例
└── examples.md
SKILL.md 头部格式
---
name: skill-name
description: 一句话描述这个技能的作用
---
name: skill-name
description: 一句话描述这个技能的作用
---
创建步骤
- 确定技能范围 - 明确技能要解决什么问题，提供什么能力
- 设计工作流程 - 从用户请求到完成的完整步骤
- 编写 SKILL.md - 包含头部信息、核心概念、使用方法、示例
- 创建辅助文件 - 脚本、参考资料、案例等
- 测试技能 - 验证技能是否能正确触发和执行
- 优化精简 - 删除冗余内容，保留核心信息
最佳实践
- ✅ 具体而非抽象 - 提供具体的命令、参数、示例，而非泛泛而谈
- ✅ 优先示例而非解释 - 简洁的示例胜过冗长的说明
- ✅ 使用正确的术语 - 与工具/平台官方文档保持一致
- ✅ 错误处理 - 说明常见错误和解决方法
- ✅ 版本控制 - 记录技能的版本和更新历史
避免的陷阱：
❌ 不要重复 AI 已知的通用知识
❌ 不要提供与特定版本绑定的过时效信息
❌ 不要在 SKILL.md 中塞入大量参考文档
❌ 不要使用模糊的语言，如"根据需要"
❌ 不要重复 AI 已知的通用知识
❌ 不要提供与特定版本绑定的过时效信息
❌ 不要在 SKILL.md 中塞入大量参考文档
❌ 不要使用模糊的语言，如"根据需要"
技能使用场景
🎮 游戏开发
SRPG设计、网络游戏设计、音频设计、关卡设计
💻 技术开发
GitHub自动化、部署流程、测试工程
🔧 硬件创客
Arduino开发、3D打印、硬件原型
🌐 商业运营
跨境电商、数据分析、内容创作
📚 参考资料
- OpenClaw 文档 - 官方开发文档
- ClawHub - 技能分享平台
- OpenClaw GitHub - 开源项目