技能简介
技能创建(create-agent-skills)提供创建有效技能的指导。技能是模块化的自包含包,通过提供专业工作流、工具和领域知识来扩展 Claude 的能力,将通用代理转变为专业代理。
能做什么
- 设计专业工作流(特定领域的多步骤程序)
- 工具集成(特定文件格式或 API)
- 领域专业知识(公司特定知识、业务逻辑)
- 打包资源(脚本、参考资料、资产)
- 学习核心原则(简洁、自由度设置)
- 理解技能结构(SKILL.md + 可选资源)
使用说明
安装 Skill:
通过 ClawHub 安装:
clawhub install create-agent-skills
核心原则:
简洁是关键——上下文窗口是公共资源。默认假设 Claude 已经很聪明,只添加 Claude 不知道的内容。质疑每条信息:”Claude 真的需要这个解释吗?”、”这段文字值得它的 token 成本吗?”优先简洁示例而非冗长解释。
设置自由度:匹配特定性与任务脆弱性和变化性。高自由度(文本指令):多种方法有效、决策依赖上下文、启发式指导方法。中自由度(伪代码或带参数脚本):存在首选模式、可接受一些变化、配置影响行为。低自由度(特定脚本、少量参数):操作脆弱易错、一致性关键、必须遵循特定序列。
技能结构:
必需 SKILL.md:YAML frontmatter(name、description)+ Markdown 指令。可选资源:scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出使用的文件)。
SKILL.md 要点:name 和 description 是 Claude 确定何时使用技能的唯一依据,必须清晰全面。指令仅在技能触发后加载。
何时使用资源:Scripts:重复重写相同代码或需要确定性可靠性。References:Claude 应参考的文档。Assets:模板、图标、字体等输出文件。
输入与输出
| 项目 | 内容 |
|---|---|
| 输入 | 技能名称、描述、工作流设计、资源文件 |
| 输出 | SKILL.md、scripts/、references/、assets/、技能包 |
| 适用人群 | 创建自定义技能的用户、扩展Claude的开发者 |
| 不包含 | 自动生成、市场发布、验证工具 |
见下方输入与输出表格。
风险提示
- SKILL.md 必须精简,避免冗余
- name 和 description 决定技能触发时机,务必准确
- 避免 SKILL.md 和 references 内容重复
- 参考资料文件大(>10k词)时需在 SKILL.md 中包含 grep 搜索模式
- 自由度设置不当可能导致 Claude 执行不当
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/bowen31337/create-agent-skills/SKILL.md
来源类型:GitHub
