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

## 一、Skills 是什么？

把 AI 助手想象成一台智能手机——出厂就很强，但真正让手机发挥威力的是 App Store 里的应用。**Skills 就是 AI 世界的 App**。
每一个 Skill 都是一段「技能包」，告诉 AI：**遇到这类问题，按这个流程走。**
核心价值，四个关键词：
- **可复用** — 写一次，永久调用，不用每次从零写 Prompt
- **可分享** — 一键发布到社区，他人搜索即可安装
- **按需加载** — 只有触发时才激活，不占常驻资源
- **扩展能力** — AI 本身不会做的事，装个 Skill 就会了

## 二、一个 Skill 长什么样？
Skill 本质上是一个小文件夹，结构极简：
```
my-awesome-skill/
├── SKILL.md        ← 核心，缺它啥都不是
├── scripts/        ← 可选，放辅助脚本
└── assets/         ← 可选，放模板/图片等
```
>![image](https://developer.qcloudimg.com/http-save/yehe-5877188/303fbf7ae186783cccbf944c29266242.png)

### 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]
---
```
常用元数据字段速查：

|字段|作用|是否必填|
|:-:|:-:|:-:|
|`name`|Skill 名称|是|
|`description`|功能描述（用于搜索摘要）|是|
|`version`|语义化版本号（semver）|是|
|`requires.env`|必需的环境变量|否|
|`requires.bins`|必须存在的 CLI 二进制|否|
|`envVars`|环境变量详细声明（支持可选）|否|
|`install`|依赖安装声明（brew/node/go/uv）|否|
|`os`|操作系统限制|否|
|`emoji`|显示图标|否|

**② 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」，它会调用工具自动生成标准文件，你审查一遍确认逻辑即可。

>![image](https://developer.qcloudimg.com/http-save/yehe-5877188/283ddc3c240e85a37568aee32342235b.png)
## 四、使用自己写的 Skill
写好 Skill 后，放到正确路径即刻生效，AI 自动根据触发词加载，无需重启。
### 个人级（跨项目生效）

```
~/.workbuddy/skills/my-skill/SKILL.md
```
放到这里，所有项目都能用。适合个人效率工具、通用工作流。

### 项目级（团队共享）


```
{项目目录}/.workbuddy/skills/my-skill/SKILL.md
```
放到项目目录下，团队成员克隆项目后自动拥有该 Skill。适合项目特定的规范、部署流程等。
**两种级别的选择逻辑：**
- 只和自己有关 → 个人级
- 需要团队协作 → 项目级
- 两者都放？没问题，项目级优先级更高
## 五、使用他人的公共 Skill
ClawHub（[clawhub.ai](https://clawhub.ai/)）是 AI Skills 的社区市场，类似 npm 之于 Node.js、Docker Hub 之于容器。目前已收录 **52,000+** 工具，**180,000+** 用户，**1,200万+** 下载量。
### 方式一：网页搜索安装
1. 访问 [clawhub.ai](https://clawhub.ai/)
2. 在搜索框输入关键词（如 "GitHub integration"、"security"、"dashboard"）
3. 浏览结果，查看评分和下载量
4. 点击 Install 一键安装到本地
### 方式二：CLI 命令安装
```
# 搜索
openclaw skills search "calendar"

# 安装
openclaw skills install todoist-cli

# 更新所有已安装的 Skill
openclaw skills update --all
```
### 安全审查：安装前必看
安装他人分享的 Skill 前，系统会自动做安全扫描：
|风险等级|处理方式|
|:-:|:-:|
|**P0 高危**|强烈警告，建议不要安装|
|**P1 中危**|需二次确认后才允许安装|
|**P2 安全**|直接安装|

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

## 六、发布 Skill 到 ClawHub
当你写了一个好用的 Skill，想让更多人受益，就发布到 ClawHub。
>![image](https://developer.qcloudimg.com/http-save/yehe-5877188/ff849ba53e363c7be0ff09765ee50358.png)
### 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](https://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 怎么选？
|场景|推荐CLI|命令|
|:-:|:-:|:-:|
|搜索 / 安装 / 更新 Skill|`openclaw`（原生）|`openclaw skills search/install/update`|
|发布 Skill|`clawhub`（独立）|`clawhub skill publish`|
|登录认证|`clawhub`|`clawhub login`|
|查看已安装列表|`clawhub`|`clawhub list`|
|CI/CD 集成|`clawhub`|加 `--json` 参数|

简单记：**日常用 `openclaw`，发布用 `clawhub`。**
## 一句话总结
>Skills 让 AI 的能力从「一次性输出」变成「可复用的专家服务」——写一次，永久复用；分享出去，变成社区资产。

### 本文使用的Agent工具为workbuddy，其他Agent工具类同
**相关链接**
- ClawHub 市场：[clawhub.ai](https://clawhub.ai/)
- 官方文档：[documentation.openclaw.ai/clawhub](https://documentation.openclaw.ai/clawhub/)
- 开源仓库：[github.com/openclaw/clawhub](https://github.com/openclaw/clawhub)
- Skill 格式规范：[documentation.openclaw.ai/clawhub/skill-format](https://documentation.openclaw.ai/clawhub/skill-format)

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

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

先锋会员

人工智能

Skills是AI智能体的插件系统，类似AppStore。通过编写SKILL.md文件，AI可被训练成特定领域的专家，实现技能复用和社区共享。Skill开发只需定义触发场景和步骤，支持个人和项目级部署。ClawHub平台提供超5万款技能库，用户可一键安装或发布原创Skill。

容器

GitHub

Agent

2026采购季 | AI焕新·智启新局

expert-service

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AI 时代的「插件革命」—— Skills 全解析-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐