Setup
On first use, read setup.md for integration guidelines.
When to Use
User wants to create or improve a skill. Agent guides structure, reviews content, and ensures quality.
Data Storage
If user wants project tracking, create folder in their home directory.
See memory-template.md for the template structure.
The agent does NOT create files automatically. Always ask user first.
Architecture
Skills follow this structure:
CODEBLOCK0
Quick Reference
| Topic | File |
|---|
| Setup process | INLINECODE2 |
| Tracking projects |
memory-template.md |
| Patterns and examples |
patterns.md |
Core Rules
1. SKILL.md Must Be Short
Target 30-50 lines, max 80. Move details to auxiliary files. Every line must justify its token cost.
2. Progressive Disclosure
CODEBLOCK1
3. Descriptions Are Critical
One sentence, 15-25 words. Action verb first. Describes capabilities, not triggers.
| ❌ Wrong | ✅ Right |
|---|
| "Use when user needs PDFs" | "Process, merge, and extract PDF content" |
| "Helper for Docker" |
"Build, deploy, and debug Docker containers" |
| "Git guide" | "Manage branches, resolve conflicts, and automate workflows" |
See patterns.md for more examples.
4. Required Structure
Every skill needs:
- - Frontmatter: name, slug, version, description
- INLINECODE6 — activation triggers
- INLINECODE7 — 3-7 numbered rules
5. Auxiliary Files Over Inline Content
If content exceeds 20 lines or is only needed sometimes, split to separate file. Reference from Quick Reference table.
6. No Redundancy
Information lives in ONE place. SKILL.md references files, doesn't duplicate content.
7. Test Before Publish
Read the skill as if you're an agent encountering it fresh. Is every instruction clear and necessary?
Skill Building Traps
| Trap | Why it fails | Fix |
|---|
| Explaining what X is | Models already know | Explain WHEN and HOW |
| "Use when..." in description |
Wastes characters | Action verbs only |
| Keyword lists in description | Looks spammy | One clean sentence |
| Templates inline | Bloats SKILL.md | Separate file |
| Vague "observe" instructions | Gets flagged suspicious | Be specific about what data |
| Undeclared file creation | Security flag | Add Data Storage section |
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
skill-manager — manage installed skills - INLINECODE10 — update existing skills
- INLINECODE11 — test skills locally
Feedback
- - If useful: INLINECODE12
- Stay updated: INLINECODE13
技能名称：技能构建器/创作者
详细描述：
设置
首次使用时，请阅读 setup.md 以获取集成指南。
使用时机
用户想要创建或改进技能。智能体负责引导结构、审查内容并确保质量。
数据存储
如果用户需要项目跟踪，请在其主目录中创建文件夹。
模板结构请参见 memory-template.md。
智能体不会自动创建文件。务必先询问用户。
架构
技能遵循以下结构：
skill-name/
├── SKILL.md # 核心指令（简短）
├── [topic].md # 按需提供的详细信息
└── references/ # 大型文档（可选）
快速参考
memory-template.md |
| 模式与示例 | patterns.md |
核心规则
1. SKILL.md 必须简短
目标为30-50行，最多80行。将详细信息移至辅助文件。每一行都必须证明其 token 成本是合理的。
2. 渐进式信息展示
第1层：元数据（名称 + 描述）——始终加载
第2层：SKILL.md 正文——技能触发时加载
第3层：辅助文件——按需加载
3. 描述至关重要
一句话，15-25个单词。以动作动词开头。描述能力，而非触发条件。
| ❌ 错误 | ✅ 正确 |
|---|
| 当用户需要PDF时使用 | 处理、合并和提取PDF内容 |
| Docker助手 |
构建、部署和调试Docker容器 |
| Git指南 | 管理分支、解决冲突和自动化工作流 |
更多示例请参见 patterns.md。
4. 必需结构
每个技能都需要：
- - 前置元数据：名称、slug、版本、描述
- ## 使用时机 —— 激活触发条件
- ## 核心规则 —— 3-7条编号规则
5. 辅助文件优于内联内容
如果内容超过20行或仅在某些时候需要，请拆分为单独文件。通过快速参考表进行引用。
6. 无冗余
信息只存在于一个地方。SKILL.md 引用文件，不重复内容。
7. 发布前测试
以智能体初次接触该技能的角度阅读它。每条指令是否清晰且必要？
技能构建陷阱
| 陷阱 | 失败原因 | 修正方法 |
|---|
| 解释X是什么 | 模型已经知道 | 解释何时以及如何 |
| 描述中使用当...时使用 |
浪费字符 | 仅使用动作动词 |
| 描述中的关键词列表 | 看起来像垃圾信息 | 一个干净的句子 |
| 内联模板 | 使SKILL.md臃肿 | 单独文件 |
| 模糊的观察指令 | 被标记为可疑 | 具体说明哪些数据 |
| 未声明的文件创建 | 安全标记 | 添加数据存储部分 |
相关技能
如果用户确认，使用 clawhub install
安装：
- - skill-manager —— 管理已安装的技能
- skill-update —— 更新现有技能
- skill-test —— 本地测试技能
反馈
- - 如果有用：clawhub star skill-builder
- 保持更新：clawhub sync
