由 AI 驱动
  • 主页
  • 手册
    • SQL 手册
    • R 手册
    • Python 手册
    • 机器学习手册
    • TensorFlow 手册
    • AI 手册
  • 博客
  • 简历
  • 中文/EN
    • 中文
    • English

On this page

  • 什么是技能 (Skills)?
  • SKILL.md 示例
  • 添加技能
    • 安装
    • 搜索技能
    • 检查技能更新
    • 更新所有已安装技能
  • 智能体如何使用技能
  • 不同智能体的设置方式

智能体技能 (Agent Skills)

  • Show All Code
  • Hide All Code

  • View Source
AI
技能
Author

Tony D

Published

February 23, 2026

什么是技能 (Skills)?

智能体技能(Agent Skills)是一种轻量级、开放式的格式,用于通过专业知识和工作流扩展 AI 智能体的能力。

从核心上讲,一个技能就是一个包含 SKILL.md 文件的文件夹。该文件包含元数据(至少包括名称和描述)以及告知智能体如何执行特定任务的指令。技能还可以捆绑脚本、模板和参考资料。

my-skill/
├── SKILL.md          # 必需:指令 + 元数据
├── scripts/          # 可选:可执行代码
├── references/       # 可选:文档
└── assets/           # 可选:模板、资源

SKILL.md 示例

---
name: code-review
description: 代码审查与质量检查专家
allowed-tools: Read, Grep, Bash, Edit
---

# 代码审查专家

你是一位遵循行业最佳实践的资深代码审查员。

## 审查重点
1. **代码质量**
   - 命名规范
   - 代码复杂度
   - 代码重复率

2. **安全性**
   - SQL 注入风险
   - XSS 漏洞
   - 身份验证与授权问题

3. **性能**
   - 算法效率
   - 资源使用情况
   - 缓存策略

添加技能

安装

Code
Terminal
npx skills add vercel-labs/agent-skills
Code
Terminal
# 列出仓库中的技能
npx skills add vercel-labs/agent-skills --list
Code
Terminal
# 完整的 GitHub URL
npx skills add https://github.com/vercel-labs/skills/tree/main/skills/find-skills

搜索技能

搜索PPT相关的技能skills

Code
npx skills find PPT
npm warn exec The following package was not found and will be installed: skills@1.4.6

███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
███████╗█████╔╝ ██║██║     ██║     ███████╗
╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
███████║██║  ██╗██║███████╗███████╗███████║
╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

Install with npx skills add <owner/repo@skill>

anthropics/skills@pptx 44.8K installs
└ https://skills.sh/anthropics/skills/pptx

supercent-io/skills-template@pptx-presentation-builder 8K installs
└ https://skills.sh/supercent-io/skills-template/pptx-presentation-builder

claude-office-skills/skills@ppt-visual 1.5K installs
└ https://skills.sh/claude-office-skills/skills/ppt-visual

myzy-ai/dokie-ai-ppt@dokie-ai-ppt 742 installs
└ https://skills.sh/myzy-ai/dokie-ai-ppt/dokie-ai-ppt

tfriedel/claude-office-skills@pptx 719 installs
└ https://skills.sh/tfriedel/claude-office-skills/pptx

bytedance/deer-flow@ppt-generation 608 installs
└ https://skills.sh/bytedance/deer-flow/ppt-generation

检查技能更新

Code
Terminal
npx skills check

更新所有已安装技能

Code
Terminal
npx skills update

智能体如何使用技能

智能体不会一次性将所有技能加载到内存中。相反,它们遵循“即时”(Just-In-Time)激活模式:

  1. 检测:智能体扫描所有可用技能的 description(描述)。
  2. 匹配:当用户的请求与某个技能的描述匹配时,智能体读取完整的 SKILL.md 内容。
  3. 执行:智能体按照 SKILL.md 中的指令执行,可能会调用技能文件夹中捆绑的脚本或使用参考资料。

不同智能体的设置方式

  • Claude Code CLI
  • Gemini CLI
  • Opencode CLI
  • Antigravity IDE
  • Trae IDE
  • CodeBuddy IDE

用户层级 (User Level)

~/.claude/skills/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.claude/skills/<skill-name>/SKILL.md

用户层级 (User Level)

~/.agents/skills/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.agent/skills/<skill-name>/SKILL.md

用户层级 (User Level)

~/.opencode/skill/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.agent/skills/<skill-name>/SKILL.md

用户层级 (User Level)

~/.gemini/antigravity/skills/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.agent/skills/<skill-name>/SKILL.md

用户层级 (User Level)

~/.trae/skills/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.trae/skills/<skill-name>/SKILL.md

用户层级 (User Level)

~/.codebuddy/skills/<skill-name>/SKILL.md

项目层级 (Project Level)

your_project/.codebuddy/skills/<skill-name>/SKILL.md

Source Code
---
title: "智能体技能 (Agent Skills)"
author: "Tony D"
date: "2026-02-23"
categories: [AI, 技能]
image: "images/my screenshots.png"
format:
  html:
    code-fold: show
    code-tools: true
    code-copy: false
execute:
  warning: false

editor: 
  markdown: 
    wrap: 72
engine: knitr
---

# 什么是技能 (Skills)?

智能体技能(Agent Skills)是一种轻量级、开放式的格式,用于通过专业知识和工作流扩展 AI 智能体的能力。

从核心上讲,一个技能就是一个包含 `SKILL.md` 文件的文件夹。该文件包含元数据(至少包括名称和描述)以及告知智能体如何执行特定任务的指令。技能还可以捆绑脚本、模板和参考资料。

```text
my-skill/
├── SKILL.md          # 必需:指令 + 元数据
├── scripts/          # 可选:可执行代码
├── references/       # 可选:文档
└── assets/           # 可选:模板、资源
```


# SKILL.md 示例

```markdown
---
name: code-review
description: 代码审查与质量检查专家
allowed-tools: Read, Grep, Bash, Edit
---

# 代码审查专家

你是一位遵循行业最佳实践的资深代码审查员。

## 审查重点
1. **代码质量**
   - 命名规范
   - 代码复杂度
   - 代码重复率

2. **安全性**
   - SQL 注入风险
   - XSS 漏洞
   - 身份验证与授权问题

3. **性能**
   - 算法效率
   - 资源使用情况
   - 缓存策略
```


# 添加技能

## 安装

```{python}
#| eval: false
#| filename: "Terminal"
npx skills add vercel-labs/agent-skills
```


```{python}
#| eval: false
#| filename: "Terminal"
# 列出仓库中的技能
npx skills add vercel-labs/agent-skills --list
```

```{python}
#| eval: false
#| filename: "Terminal"
# 完整的 GitHub URL
npx skills add https://github.com/vercel-labs/skills/tree/main/skills/find-skills
```


## 搜索技能

搜索PPT相关的技能skills

```{bash}
npx skills find PPT
```

## 检查技能更新

```{python}
#| eval: false
#| filename: "Terminal"
npx skills check
```


## 更新所有已安装技能

```{python}
#| eval: false
#| filename: "Terminal"
npx skills update
```

# 智能体如何使用技能

智能体不会一次性将所有技能加载到内存中。相反,它们遵循“即时”(Just-In-Time)激活模式:

1. **检测**:智能体扫描所有可用技能的 `description`(描述)。
2. **匹配**:当用户的请求与某个技能的描述匹配时,智能体读取完整的 `SKILL.md` 内容。
3. **执行**:智能体按照 `SKILL.md` 中的指令执行,可能会调用技能文件夹中捆绑的脚本或使用参考资料。



# 不同智能体的设置方式



::: panel-tabset

## Claude Code CLI

### 用户层级 (User Level)

`~/.claude/skills/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.claude/skills/<skill-name>/SKILL.md`

## Gemini CLI

### 用户层级 (User Level)

`~/.agents/skills/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.agent/skills/<skill-name>/SKILL.md`

## Opencode CLI

### 用户层级 (User Level)

`~/.opencode/skill/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.agent/skills/<skill-name>/SKILL.md`


## Antigravity IDE

### 用户层级 (User Level)

`~/.gemini/antigravity/skills/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.agent/skills/<skill-name>/SKILL.md`

## Trae IDE

### 用户层级 (User Level)

`~/.trae/skills/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.trae/skills/<skill-name>/SKILL.md`


## CodeBuddy IDE

### 用户层级 (User Level)

`~/.codebuddy/skills/<skill-name>/SKILL.md`

### 项目层级 (Project Level)

`your_project/.codebuddy/skills/<skill-name>/SKILL.md`



:::
 
 

This blog is built with ❤️ and Quarto.