AI 时代的「插件革命」—— Skills 全解析

你的 AI 助手很聪明，但它不是万能的。Skills 就是那个让它从「通才」变成「专家」的开关。

一、Skills 是什么？

把 AI 助手想象成一台智能手机——出厂就很强，但真正让手机发挥威力的是 App Store 里的应用。Skills 就是 AI 世界的 App。

每一个 Skill 都是一段「技能包」，告诉 AI：遇到这类问题，按这个流程走。

核心价值，四个关键词：

• • 可复用 — 写一次，永久调用，不用每次从零写 Prompt
• • 可分享 — 一键发布到社区，他人搜索即可安装
• • 按需加载 — 只有触发时才激活，不占常驻资源
• • 扩展能力 — AI 本身不会做的事，装个 Skill 就会了

二、一个 Skill 长什么样？

Skill 本质上是一个小文件夹，结构极简：

my-awesome-skill/
├── SKILL.md        ← 核心，缺它啥都不是
├── scripts/        ← 可选，放辅助脚本
└── assets/         ← 可选，放模板/图片等

SKILL.md 的灵魂：两大区块

① Frontmatter（元数据）— 告诉系统「我是谁」

---
name:daily-report
description:每天生成工作日报，总结今日完成任务
version:1.0.0
metadata:
openclaw:
requires:
env:
-WORK_API_KEY
bins:
-curl
primaryEnv:WORK_API_KEY
emoji:"📋"
homepage:https://github.com/you/daily-report-skill
install:
-kind:node
package:some-cli
bins: [some-cli]
---

常用元数据字段速查：

② Markdown 正文（操作指令）— 告诉 AI 「怎么做」

# 日报生成技能

1. 读取今日工作记忆文件
2. 按「完成事项 / 遗留问题 / 明日计划」三段生成报告
3. 遇到无记录的情况，输出「今日无新增任务」
4. 写入 `reports/YYYY-MM-DD.md`

就是普通的自然语言，和写 SOP 一模一样——分步骤、说清楚每步做什么、遇到异常怎么处理。

关键约束：SKILL.md 是唯一必需文件，总包大小上限 50MB，仅允许文本文件，Slug 必须小写且 URL 安全。

三、怎么编写自己的 Skill？

写 Skill 的关键是三件事：

① 想清楚触发场景

你希望 AI 在什么时候自动拿出这个 Skill？把那个场景的关键词写进 description，AI 就会在合适的时机自动匹配调用。

② 用自然语言写步骤

Skill 里的指令不是代码，就是你平时写文档的风格。分步骤、说清楚每步做什么、遇到边界怎么处理。 AI 读得懂自然语言，不需要伪代码。

③ 声明工具权限

需要读文件？加 Read。需要执行命令？加 Bash。只用来回答问题不动文件？留空就行。权限越小越安全。

最快的写法

直接告诉 AI：「帮我创建一个 Skill，用来做 XX」，它会调用工具自动生成标准文件，你审查一遍确认逻辑即可。

四、使用自己写的 Skill

写好 Skill 后，放到正确路径即刻生效，AI 自动根据触发词加载，无需重启。

个人级（跨项目生效）

~/.workbuddy/skills/my-skill/SKILL.md

放到这里，所有项目都能用。适合个人效率工具、通用工作流。

项目级（团队共享）

{项目目录}/.workbuddy/skills/my-skill/SKILL.md

放到项目目录下，团队成员克隆项目后自动拥有该 Skill。适合项目特定的规范、部署流程等。

两种级别的选择逻辑：

• • 只和自己有关 → 个人级
• • 需要团队协作 → 项目级
• • 两者都放？没问题，项目级优先级更高

五、使用他人的公共 Skill

ClawHub（clawhub.ai）是 AI Skills 的社区市场，类似 npm 之于 Node.js、Docker Hub 之于容器。目前已收录 52,000+ 工具，180,000+ 用户，1,200万+ 下载量。

方式一：网页搜索安装

1. 1. 访问 clawhub.ai
2. 2. 在搜索框输入关键词（如 “GitHub integration”、“security”、“dashboard”）
3. 3. 浏览结果，查看评分和下载量
4. 4. 点击 Install 一键安装到本地

方式二：CLI 命令安装

# 搜索
openclaw skills search "calendar"

# 安装
openclaw skills install todoist-cli

# 更新所有已安装的 Skill
openclaw skills update --all

安全审查：安装前必看

安装他人分享的 Skill 前，系统会自动做安全扫描：

手动检查建议：打开 SKILL.md 查看 allowed-tools 和 requires.env 部分，确认 Skill 申请的权限是否合理。一个「帮你写周报」的 Skill 不应该申请执行任意 Shell 命令的权限。

六、发布 Skill 到 ClawHub

当你写了一个好用的 Skill，想让更多人受益，就发布到 ClawHub。

Step 1：安装 CLI

npm i -g clawhub
# 或
pnpm add -g clawhub

Step 2：登录

clawhub login

通过 GitHub 账号认证（需关联一个足够老的 GitHub 账号以通过上传门槛）。

Step 3：预览发布（推荐）

clawhub skill publish ./my-skill --dry-run

--dry-run 只预览不上传，检查元数据是否完整、文件是否符合规范。

Step 4：正式发布

clawhub skill publish ./my-skill \
  --slug my-skill \
  --name "My Awesome Skill" \
  --version 1.0.0 \
  --changelog "首版发布"

也可以用网页端：访问 clawhub.ai/skills/publish 直接上传。

发布后的管理

# 查看当前身份
clawhub whoami

# 更新版本
clawhub skill publish ./my-skill --version 1.1.0 --changelog "修复触发词匹配问题"

# 同步所有已安装 Skill
clawhub sync --all

# 查看已安装列表
clawhub list

重要须知

• • 许可证：发布到 ClawHub 的 Skill 一律采用 MIT-0 许可证，任何人可自由使用、修改、再分发（含商业用途），无需署名
• • 不支持付费：ClawHub 不支持付费 Skill、定价或收入分成
• • 版本规范：版本号必须遵循 semver（语义化版本），如 1.0.0、2.1.3

七、两套 CLI 怎么选？

简单记：日常用 openclaw，发布用 clawhub。

一句话总结

Skills 让 AI 的能力从「一次性输出」变成「可复用的专家服务」——写一次，永久复用；分享出去，变成社区资产。

本文使用的Agent工具为workbuddy，其他Agent工具类同

相关链接

• • ClawHub 市场：clawhub.ai
• • 官方文档：documentation.openclaw.ai/clawhub
• • 开源仓库：github.com/openclaw/clawhub
• • Skill 格式规范：documentation.openclaw.ai/clawhub/skill-format