Agent Skill 完全解析

AI Agent

Agent Skill 完全解析

从概念到实战｜一文搞懂

Anthropic 官方 2025.12.18 开放标准

💡 导读
Anthropic 于 2025 年 10 月 16 日推出 Agent Skill，起初仅用于提升 Claude 特定任务表现。12 月 18 日正式发布为开放标准，支持跨平台、跨产品复用。VS Code、Codex、Cursor 等工具已陆续加入支持。

💎核心观点

📄

本质是说明文档

大模型可随时翻阅的操作手册

⚡

按需加载机制

选中才加载，极致节省 Token

🧩

三层渐进式披露

元数据 / 指令 / 资源逐层触发

🧠什么是 Agent Skill？

一句话：Agent Skill 就是大模型可以随时翻阅的说明文档。模型自己翻一翻就知道怎么干活。

智能客服投诉先安抚情绪，不得随意承诺

会议总结按「参会人 · 议题 · 决定」格式输出

不用每次重复粘贴长串要求，模型自会查阅文档。

🔧基本用法（四步）

创建文件夹

在 ~/.claude/skills/ 下创建 skill 文件夹

创建 skill.md

每个 Agent Skill 必配此文件

填写元数据 + 指令

metadata：name + description；instruction：规则 + 示例

在 Claude Code 中使用

模型自动匹配并应用对应 Skill

⚙️核心机制：按需加载

📋 轻量级目录

所有 Skill 的名称 + 描述，始终对模型可见

🎯 命中才加载

模型选中某个 Skill 后，才读取完整 skill.md 正文

💰 节省 Token

几十个 Skill 也只消耗一份目录的 Token

🚀高级用法

📄 Reference 按需读取

条件触发的「文档文件」。例如在会议总结 Skill 中写财务提醒规则：仅在提到钱 / 预算 / 采购时，才加载集团财务手册并标注超标情况。

不相关的场景绝不占用上下文 —— 这就是「按需中的按需」。

⚡ Script 执行不读取

条件执行的「代码脚本」。例如在会议总结后运行 upload.py 上传到服务器。代码只会被执行，不会被读取，上下文消耗约等于零。

🏗️渐进式披露三层结构

第 1 层元数据层 · 所有 Skill 的名称+描述始终加载

第 2 层指令层 · 被选中 Skill 的 skill.md 正文按需加载

第 3 层资源层 · Reference 读取 / Script 执行按需中的按需

⚖️Agent Skill vs MCP

🔌

MCP

独立运行的程序
连接外部数据
适合复杂交互

📄

Skill

说明文档
轻量脚本逻辑
适合简单处理

官方一句话：
"MCP connects Claude to data,
Skill tells Claude what to do with that data."
MCP 连接数据，Skill 处理数据。

🔪 瑞士军刀也能切菜，但没人会这么干 —— 能干≠适合干。

✅行动建议

✔️

轻量逻辑、格式要求 → 用 Agent Skill

✔️

复杂数据连接、外部交互 → 用 MCP

🌟

最佳实践：两者结合，效果最优

CuteNote.app 颜值笔记生成