AgentSkill让Claude变身全能工具人?
每个技能文件夹里,必须有一个叫「SKILL.md」的文件(大写!),它相当于“插件说明书”,告诉AI这个技能能干嘛、怎么干。网上有很多现成的优质“插件”,比如GitHub的,直接下载复制到文件夹里就行。文件内容示例 (C:\Users\用户名\.claude\skills\xlsx\SKILL.md---# 【1. 元数据区 / Metadata】# 作用:Claude 启动时只会读取这一小部分。
最近Anthropic推出的Agent Skill(Claude skill)又刷屏互联网,那他到底是个啥?能够帮我解决什么问题,这篇文章帮你解决这个问题,同时也教你如何使用。
1. Agent Skill 是什么?
简单来说,AgentSkill就是AI的==“模块化技能包”==
传统AI的“本事”都是固定的,就像一个啥都学但啥都不精的通才;而Agent Skill把不同功能拆成独立的“插件”
- PDF总结
- Excel分析
- PPT生成
- 。。。
你需要啥就装啥,AI只会专注做好这件事
核心逻辑:AI版“带目录的书” ,不浪费半点力气
传统的 System Prompt 往往把所有规则一次性塞给 AI,既浪费 Token 又容易让模型混淆。Agent Skill 将能力分层管理,就像一本书:
Agent Skill不一样,它把技能分成3层,像一本带目录的书:
-
第1层:元数据 (Metadata) ≈ 目录
- 内容:技能的名称 (
name) 和简短描述 (description)。 - 加载机制:始终加载。AI 只看目录,判断“用户的问题我需不需要查这本书”。
- 优势:极度节省 Token,几乎不占内存。
- 只写技能名字+一句话功能(比如“PDF总结:快速提炼文章重点”)。AI启动时只看目录,知道自己有啥本事,不占内存;
- 内容:技能的名称 (
-
第2层:指令 (Instructions) ≈ 正文
- 内容:具体的 Prompt、操作步骤、约束条件。
- 加载机制:按需加载。只有当 AI 决定调用该技能时,才会读取这部分内容进入上下文。
- 只有当你需要用这个技能时,AI才会翻开“正文”,看具体怎么操作(比如“第一步读PDF,第二步提取关键信息”);
-
第3层:资源 (Resources) ≈ 附录
* 内容:辅助脚本 (scripts/)、模板文件 (templates/) 或参考数据。
* 加载机制:按需调用。在指令执行过程中被引用时才读取。
* 里面藏着脚本、模板这些“工具”,AI执行时才会拿出来用(比如生成PPT的模板、分析数据的代码)。
2. 为什么要用Agent Skill
2.1 Agent Skill的特点
- 标准化:不仅仅是 Claude,Cursor、Codex、OpenCode 等新一代 AI 编程工具均开始支持此标准。
- 低消耗:解决了“随着能力增加,Context Window 爆炸”的问题。
- 配合 MCP:Skill 定义“SOP(标准作业程序)”,MCP 提供“工具接口(如读写文件)”,两者结合实现复杂的 Agent 工作流。
2.2 三个核心优势
✅ 不卡壳:装100个技能也不慢,因为AI只在需要时加载对应功能,不会“记一堆没用的东西”;
✅ 零门槛:不用学复杂指令,直接说人话就行(比如“帮我分析这个CSV文件”“把这篇PDF做成PPT”);
✅ 全兼容:不光Claude能用,Cursor、Codex这些AI编程工具都支持,一个技能全家通用。
3. Skill配置指南
假设您已安装好 Claude Code 并通过 settings.json 配置了 DeepSeek/GLM 等兼容模型,如果还没安装,可以看我的这篇文章Claude Code 安装指南
如果安装了,就接着往下看吧,以下是加载skill的完整流程。
📂 第一步:建立“技能库”
Claude Code 会自动扫描用户根目录下的 .claude/skills 文件夹。
标准路径结构(请务必遵守此层级):
C:\Users\用户名\.claude\skills\ <-- skill所在目录
│
├── 📂 pdf-summary\ <-- [技能包] 文件夹名建议用 kebab-case
│ │
│ ├── 📄 SKILL.md <-- [🔴 核心] 必须叫 SKILL.md (大写)
│ │
│ ├── 📂 scripts\ <-- [手脚] 存放 Python/Bash 脚本
│ │ └── 🐍 extract.py
│ │
│ └── 📂 templates\ <-- [素材] 存放输出模板
│ └── 📄 format.txt
│
└── 📂 git-automator\ <-- 另一个技能包
└── 📄 SKILL.md
所有“AI插件”都存在这里,比如“PDF总结”“Excel分析”,每个技能建一个独立文件夹(名字用英文,比如pdf-summary)。
📝 第二步:编写 SKILL.md (标准定义)
每个技能文件夹里,必须有一个叫「SKILL.md」的文件(大写!),它相当于“插件说明书”,告诉AI这个技能能干嘛、怎么干。
网上有很多现成的优质“插件”,比如GitHub的 awesome-claude-skills,直接下载复制到文件夹里就行。
文件内容示例 (C:\Users\用户名\.claude\skills\xlsx\SKILL.md):
---
# 【1. 元数据区 / Metadata】
# 作用:Claude 启动时只会读取这一小部分。description 必须准确概括功能,
# 只有当用户的问题与这段描述匹配时,下方的指令区才会被加载。
name: csv-data-summarizer
description: 使用 Python 和 pandas 分析 CSV 文件,生成统计摘要并绘制快速可视化图表。
metadata:
version: 2.1.0
dependencies: python>=3.8, pandas>=2.0.0
---
# CSV Data Summarizer
<!-- 【2. 指令区 / Instructions】 -->
<!-- 作用:当技能被触发后,Claude 会遵循这里的规则去执行任务 -->
## When to Use (触发时机)
当用户满足以下条件时使用此 Skill:
- 上传或引用了一个 CSV 文件
- 要求对表格数据进行摘要、分析或可视化
- 想要了解数据的结构和质量
## Critical Behavior (核心行为准则)
⚠️ **绝对准则**:
1. **禁止询问用户意图**:不要问 "你想让我做什么?" 或提供选项。
2. **立即执行全量分析**:自动运行分析、生成所有相关图表并展示结果。
3. **智能适配**:根据数据内容(销售、客户、财务等)自动决定分析方向,无需用户指定。
## Automatic Steps (自动化步骤)
1. **加载与检查**:读取 CSV 到 pandas DataFrame。
2. **识别结构**:判断列类型(日期、数值、分类)。
3. **执行分析**:根据数据类型生成统计数据(如时间序列趋势、相关性热力图等)。
4. **生成输出**:一次性展示概览、统计数据、缺失值分析和可视化图表。
---
# Files
<!-- 【3. 资源区 / Resources】 -->
<!-- 作用:列出此 Skill 需要调用的具体文件(位于同级目录中) -->
- `analyze.py` - 核心分析逻辑代码
- `requirements.txt` - Python 依赖库列表
- `resources/sample.csv` - 用于测试的示例数据
🚀 第三步:加载与触发
-
重启 Claude Code:
关闭并重新打开终端,输入claude启动。 -
检查加载:
在对话框中输入指令/doctor或者直接问它:“你现在加载了哪些 skills?”
它会列出已发现的技能,例如:pdf-summary-pro。 -
触发使用:
无需特殊命令,直接用自然语言:“帮我读一下桌面上这个 annual_report.pdf,我要看财报摘要”
Claude 会识别意图 -> 自动命中SKILL.md-> 执行内部逻辑。
4. 补充
核心机制:渐进式披露
Claude 不是一次性把所有 Skill 的内容都塞进 Context (上下文) 里的。
- 启动时:只加载
SKILL.md顶部的name和description(元数据)。这几乎不消耗 Token。 - 命中时:只有当用户的问题与
description匹配时,Claude 才会将该SKILL.md的正文和相关脚本加载进上下文。
这意味着你可以安装 100 个技能,而不会让 Claude 变笨或变慢。
安全提示
下载别人的 Agent Skill (比如从 GitHub 上的 awesome-claude-skills) 时要格外小心。
下载别人分享的“AI插件”时,一定要注意:
-
插件里的「scripts」文件夹,可能藏着能在你电脑上执行的代码;
-
不明来源的插件别乱装!可能会删你文件、偷你数据;
-
安装前先打开「scripts」文件夹,看看里面的代码有没有奇怪的操作(比如“删除所有文件”“上传数据到XX网站”)。
完全自主权
如果想给claude code完全自主权,而不是每次调用skill或更改代码都询问你是否同意,那么,可以使用这个命令来启动claude code:
claude --dangerously-skip-permissions
但是,就像这个命令内容一样,dangerously(危险地),开启后 Claude 拥有了完全的自主权。
- 风险:它可能会直接修改你的代码、删除文件、安装依赖或执行 shell 命令,而不会再次征求你的同意。
- 建议:仅在你信任当前任务环境,或者在版本控制(Git)已经提交了代码(方便回滚)的情况下使用此模式。
5. 最终文件夹层级结构 - 样例:
.claude/skills/
├── pptx-creation/(PPT生成插件)
│ ├── SKILL.md(插件说明书)
│ ├── scripts/(执行代码)
│ │ └── generate_slides.py(生成PPT的代码)
│ └── assets/(模板资源)
│ └── 商务模板.pptx
│
└── xlsx-analysis/(Excel分析插件)
├── SKILL.md
├── scripts/(清洗数据、生成图表的代码)
└── examples/(参考案例)
更多推荐


所有评论(0)