Agent Skills简洁版介绍

定义：

Agent Skills 是模块化的能力包，包含指令、元数据和可选资源（脚本、模板），让AI Agent在需要时自动加载和使用。

想象你在给新员工做入职培训：

• ❌ 传统方式：每次都重复讲解相同的工作流程
• ✅ Skills 方式：准备好工作手册，需要时自己翻阅

Agent Skills 就像是给AI助手准备的”工作手册库”：

• 平时只知道手册目录（低成本）
• 需要时才打开具体章节（按需加载）
• 包含详细步骤和工具脚本（完整指导）

解决的核心问题：

问题1：重复性工作的低效

问题2：上下文窗口（Context Window）的浪费

问题3：专业领域知识的复用困难

技术架构：三层加载机制（Progressive Disclosure）

Level 1: 元数据（Metadata）- 总是加载

内容：SKILL.md 的 YAML frontmatter

--- 
name: pdf-processing 
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs. 
---

加载时机：启动时加载到系统提示（System Prompt）
Token 成本：~100 tokens/Skill
作用：让 AI Agent 知道有哪些 Skills 可用，什么时候该用

💡 关键优势：可以安装数十个 Skills，几乎没有性能损失

Level 2: 指令（Instructions）- 触发时加载

内容：SKILL.md 的主体部分

# PDF Processing
## Quick start 
Use pdfplumber to extract text: 
```python 
import pdfplumber 
with pdfplumber.open("document.pdf") as pdf: 
  text = pdf.pages[0].extract_text() 
``` 

For advanced form filling, see [FORMS.md](FORMS.md).

加载时机：当用户请求匹配 Skill 的 description 时
加载方式：通过 bash 命令读取文件（如 cat pdf-skill/SKILL.md）
Token 成本：<5,000 tokens
作用：提供详细的操作指南和最佳实践

Level 3+: 资源和代码（Resources & Code）- 引用时加载

内容类型：

加载时机：当 SKILL.md 中的指令引用这些文件时
加载方式：

• 额外文档：cat FORMS.md（进入上下文）
• 可执行脚本：python scripts/fill_form.py（仅输出进入上下文）
• 模板文件：按需读取

Token 成本：

• 文档：实际文件大小
• 脚本：仅脚本输出（代码不进入上下文）
• 几乎无限制

💡 关键优势：

• 脚本执行不消耗上下文（仅结果消耗）
• 可以包含大量参考资料（不用时不占 token）

与MCP、Function Call对比：

基本语法：

最小可行 Skill（Minimal Viable Skill）

完整skill结构：