Agent Skills 入门和精通看这篇就够了！

前言

Agent Skills 是 Anthropic 推出的开放标准能力扩展机制，已被视为 AI Agent 生态的核心组成部分。

本文介绍 Skills 的概念、运作原理，以及最实用的使用指南。

希望可以帮助大家快速上手！下面是官网地址：

https://agentskills.io/what-are-skills

正文

Agent Skills 概念与运作原理

核心定义

Agent Skills 是模块化的、可复用的能力扩展包，专为通用 AI Agent（如 Claude Code、Cursor 等）设计。

每个 Skill 打包了完整的“做事方法”：包括任务指导指令、执行流程、最佳实践、可选的代码脚本、参考文档、素材资源等。

一句话总结：Skills 教 Agent 如何稳定、高质量地完成特定任务，而非仅仅提供工具调用接口。

与 MCP 的本质区别

• MCP（Model Context Protocol）：统一协议，关注 Agent 如何调用外部工具/服务/数据，不定义任务逻辑。
• Skills：完整的能力包，不仅教“用什么工具”，还教“怎么一步步做这件事”，包含规划、执行、纠错的全流程知识。

Skills 的文件结构（标准示例）

my-skill/
├── SKILL.md    # Required: instructions + metadata
├── scripts/    # Optional: executable code
├── references/ # Optional: documentation
└── assets/     # Optional: templates, resources

文件详细信息如下：

必选SKILL.md（核心文件）

• YAML 元数据：name、description（~100 tokens，常驻上下文，用于匹配判断）
• 正文：详细指令、流程、注意事项（建议 <5000 tokens，触发时加载）

例如：baoyu-comic skills 的 SKILL.md 文件如下

---
name: baoyu-comic
description: Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic".
---

# Knowledge Comic Creator
xxx

## Usage
xxx

## Options

### Visual Dimensions
xxx

### Partial Workflow Options
xxx

### Art Styles (画风)
xxx

### Tones (基调)
xxx

可选（Level 3，按需加载）：

• scripts/：预写代码脚本（Agent 直接执行，结果进上下文，代码本身不占 token）
• reference/：参考文档、规范、知识材料
• assets/：模板、图片、案例文件
• 子技能文档（如 xxx.md）：复杂任务拆分，独立加载

我安装的 skills 目录

我安装的 skills 目录

渐进式披露（核心运行机制）

为了避免上下文窗口爆炸，Skills 采用三级加载策略：

1. Level 1（始终加载）：SKILL.md 的元数据（name + description）。Agent 启动时就放进系统提示，用于判断“这个任务需不需要用我”。
2. Level 2（触发加载）：当用户消息与元数据匹配时，Agent 读取 SKILL.md 完整正文，加载进上下文。
3. Level 3（按需动态加载）：子文档、脚本、参考文件等。只有真正需要时才读取（比如脚本只执行不进上下文，输出结果才进）。

运行流程示例

用户发任务 → Agent 匹配 Level 1 元数据 → 决定调用 Skill → 加载 Level 2 指令 → 根据指令规划 → 按需调用 Level 3 资源/脚本 → 执行 → 观察结果 → 循环直到完成。 这套机制让 Agent 能同时安装几十个 Skill 而不卡顿，同时保证关键时刻有足够详细指导。

Trae 使用 Agent Skills 使用指南

下载

方法1: 浏览 https://skills.sh

找一个 skills 仓库，进入详情复制下载命令

复制下载命令

复制下载命令

方法2: 直接找到 github 仓库，比如 baoyu 系列仓库：

https://github.com/jimliu/baoyu-skills

复制后控制台运行：

npx skills add https://github.com/jimliu/baoyu-skills

❝不管哪种方法，下载过程基本上一样

选中需要的 skills 摁下空格选择（支持多选）。

下载

下载

选中之后回车，可以选择下载到哪些 agent 平台，如果之前选择过，可以选择和上次一样

选择 agent 平台

选择 agent 平台

回车之后会需要下载范围：

下载范围

下载范围

回车之后需要选择下载方法

下载方法

下载方法

继续回车两次即可完成安装！

done

done

验证是否生效：问 你现在有哪些 Skill 可用？ 或直接观察是否按 Skill 指导执行。

验证

验证

使用已安装的 Skill

直接说：

使用技巧  baoyu-comic 为 agent-skills.md 文章配插图，风格 ligne-claire

可以看到已经根据我的文章生成了封面图等信息的 PlainText

生成 PlainText

生成 PlainText

然后我讲 PlainText 复制到豆包生成封面：

Ligne-Claire 风格，清线风格，一个程序员坐在电脑前，屏幕上显示着"Agent Skills"的字样，旁边有一个扩展包的图标，上方有醒目的标题"Agent Skills 终极指南"，下方有副标题"入门、精通、预测"，整体风格简洁明了，充满科技感。

下面生成的结果：

结果

结果

对于我这种写 prompt 困难户，这简直就是神器！

最后

Agent Skills 通过渐进式披露 + 模块化设计，让通用 Agent 轻松拥有垂直专业能力！

今天的分享就这些了，感谢大家的阅读，如果文章中存在错误的地方欢迎指正！