Code
Terminal
npx skills add vercel-labs/agent-skillsTony D
February 23, 2026
智能体技能(Agent Skills)是一种轻量级、开放式的格式,用于通过专业知识和工作流扩展 AI 智能体的能力。
从核心上讲,一个技能就是一个包含 SKILL.md 文件的文件夹。该文件包含元数据(至少包括名称和描述)以及告知智能体如何执行特定任务的指令。技能还可以捆绑脚本、模板和参考资料。
my-skill/
├── SKILL.md # 必需:指令 + 元数据
├── scripts/ # 可选:可执行代码
├── references/ # 可选:文档
└── assets/ # 可选:模板、资源
搜索PPT相关的技能skills
npm warn exec The following package was not found and will be installed: skills@1.4.6
[38;5;250m███████╗██╗ ██╗██╗██╗ ██╗ ███████╗[0m
[38;5;248m██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝[0m
[38;5;245m███████╗█████╔╝ ██║██║ ██║ ███████╗[0m
[38;5;243m╚════██║██╔═██╗ ██║██║ ██║ ╚════██║[0m
[38;5;240m███████║██║ ██╗██║███████╗███████╗███████║[0m
[38;5;238m╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝[0m
[38;5;102mInstall with[0m npx skills add <owner/repo@skill>
[38;5;145manthropics/skills@pptx[0m [36m44.8K installs[0m
[38;5;102m└ https://skills.sh/anthropics/skills/pptx[0m
[38;5;145msupercent-io/skills-template@pptx-presentation-builder[0m [36m8K installs[0m
[38;5;102m└ https://skills.sh/supercent-io/skills-template/pptx-presentation-builder[0m
[38;5;145mclaude-office-skills/skills@ppt-visual[0m [36m1.5K installs[0m
[38;5;102m└ https://skills.sh/claude-office-skills/skills/ppt-visual[0m
[38;5;145mmyzy-ai/dokie-ai-ppt@dokie-ai-ppt[0m [36m742 installs[0m
[38;5;102m└ https://skills.sh/myzy-ai/dokie-ai-ppt/dokie-ai-ppt[0m
[38;5;145mtfriedel/claude-office-skills@pptx[0m [36m719 installs[0m
[38;5;102m└ https://skills.sh/tfriedel/claude-office-skills/pptx[0m
[38;5;145mbytedance/deer-flow@ppt-generation[0m [36m608 installs[0m
[38;5;102m└ https://skills.sh/bytedance/deer-flow/ppt-generation[0m
智能体不会一次性将所有技能加载到内存中。相反,它们遵循“即时”(Just-In-Time)激活模式:
description(描述)。SKILL.md 内容。SKILL.md 中的指令执行,可能会调用技能文件夹中捆绑的脚本或使用参考资料。~/.claude/skills/<skill-name>/SKILL.md
your_project/.claude/skills/<skill-name>/SKILL.md
~/.agents/skills/<skill-name>/SKILL.md
your_project/.agent/skills/<skill-name>/SKILL.md
~/.opencode/skill/<skill-name>/SKILL.md
your_project/.agent/skills/<skill-name>/SKILL.md
~/.gemini/antigravity/skills/<skill-name>/SKILL.md
your_project/.agent/skills/<skill-name>/SKILL.md
~/.trae/skills/<skill-name>/SKILL.md
your_project/.trae/skills/<skill-name>/SKILL.md
~/.codebuddy/skills/<skill-name>/SKILL.md
your_project/.codebuddy/skills/<skill-name>/SKILL.md
---
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`
:::