技能概览

**Skill（技能）**是 GolemBot 中的能力单元。它是一个目录，包含指令和可选的辅助文件，教 Coding Agent 如何执行特定任务。

目录结构

skills/
├── general/              # 内置：通用助手
│   └── SKILL.md
├── im-adapter/           # 内置：IM 回复规范
│   └── SKILL.md
├── multi-bot/            # 内置：多 Bot 协作
│   └── SKILL.md
├── message-push/         # 内置：主动消息推送
│   └── SKILL.md
└── my-custom-skill/      # 你自定义的技能
    ├── SKILL.md          # 必需：指令 + 元数据
    ├── analyze.py        # 可选：辅助脚本
    └── reference.md      # 可选：知识文档

工作原理

1. 每次 assistant.chat() 调用时，GolemBot 扫描 skills/ 目录
2. 每个包含 SKILL.md 的子目录注册为一个技能
3. 技能通过符号链接注入引擎预期位置
4. Coding Agent 读取技能指令并获得描述的能力

社区技能仓库

GolemBot 的 SKILL.md 格式与 OpenClaw 的 ClawHub 生态 100% 兼容。

GolemBot 集成了多个社区技能仓库，可直接从 CLI 搜索和安装：

• ClawHub — 最大的社区技能市场，拥有 13,000+ 技能（默认仓库）
• skills.sh — 社区驱动的技能仓库，提供精选高质量技能

# 搜索技能（默认搜索 ClawHub）
golembot skill search "数据分析"

# 搜索指定仓库
golembot skill search "数据分析" --registry skills.sh

# 从 ClawHub 安装
golembot skill add clawhub:data-analysis

# 从 skills.sh 安装
golembot skill add skills.sh:owner/repo/skill

# 所有 skill 命令支持 --json，方便 agent 调用
golembot skill search "markdown" --json

可插拔的 registry 接口便于接入新的技能来源。当前支持：clawhub（默认）、skills.sh。

Agent 自主发现技能

所有 skill 命令支持 --json 输出。内置的 general 技能会教 agent 自主搜索和安装技能 — 当用户需要 agent 没有的能力时，agent 会主动搜索技能仓库并建议安装相关技能。

SKILL.md 格式

每个 SKILL.md 必须有 YAML frontmatter，至少包含 name 和 description：

---
name: my-skill
description: 这个技能做什么的简要说明
---

# 技能标题

给 Coding Agent 的使用指令。

核心原则

• 不在配置中声明 — skills/ 目录是唯一的事实来源
• 没有独立的 Tool 概念 — 脚本放在技能目录里，SKILL.md 描述如何调用
• 即放即用 — 复制目录即添加技能；删除目录即移除技能
• 引擎无关 — 同一个 Skill 在 Cursor、Claude Code、OpenCode 和 Codex 上都能用

下一步

• 创建技能 — 从零编写自定义技能
• 内置技能 — general 和 im-adapter 的功能说明
• ClawHub — 浏览 13,000+ 社区技能
• skills.sh — 精选社区技能仓库