如果有人问2026年最值得学习的AI技能是什么，答案一定是Skills。
从Claude Code到OpenClaw、Hermes Agent，几乎所有主流Agent都在依赖Skills提升工作质量和效率。缺乏Skills支撑的Agent如同需要反复培训的新员工，而配备Skills的Agent则像经验丰富的同事，能够开箱即用、配合默契。
Skills正在成为Agent领域最具影响力的创新之一。简而言之，模型是大脑，Agent是躯体，Skills则是双手。掌握如何“教”AI比仅仅学会如何“问”AI更为重要。将重复性工作、团队隐性知识、操作细节封装成.skill文件，这些文件会成为最可靠的数字助手。
1、Skills是什么
2025年10月16日，Anthropic首次发布Agent Skills。该功能最初仅在Claude Code中可用，且需要Pro付费账户。
Anthropic发布Agent Skills
同年12月18日，Anthropic将Agent Skills作为统一标准向所有用户开放。随后，Codex、Cursor、Antigravity、OpenCode、Trae、Qoder、CodeBuddy等Coding Agent，以及Claude Cowork、Skywork、MiniMax Agent、扣子等桌面Agent陆续支持Skills。
2026年春节后爆火的OpenClaw和最近大热的Hermes Agent同样支持这一功能。
Skills的本意是”技能包”。人类拥有多种技能，如骑车、游泳、驾驶、烹饪、摄影；Skills就是为AI准备的技能包。
Anthropic官方定义：Skills是一套模块化能力，允许开发者通过结构化的文件夹来增强Claude Code的功能。每个Skill包含一个核心的SKILL.md文件及相关辅助资源。当用户向Claude Code提出请求时，系统会根据请求内容和Skill描述自动判断是否调用相应Skill。
更直白的解释是：Skills是为AI定制的标准操作手册（SOP）。每个Skill都有一个专门文件夹用于存放执行指令、资源文件和参考资料。这个文件夹能让AI从”职场新手”迅速转变为”熟练员工”。
用一个比喻说明三者的区别：
Prompt如同顾客点单，指令明确但执行方式由厨师决定。MCP提供厨房工具和食材，让AI不再空手操作。Skills则是秘制菜谱和员工守则，规定动作顺序、质量底线和执行标准。有了Skills，AI按部就班工作而不必猜测用户意图。
2、Skills的核心架构
了解基本概念后，从文件夹层面分析Skills架构。
打开Claude Code安装文件夹（默认位于C盘，文件名.Claude），找到Skills文件目录，通常包含以下结构：
「skill-creator」skill的文件夹架构
- SKILL.md：skill核心指令，包含名称、触发条件、任务流程、执行指引
- scripts：存放可执行代码，如Python、Bash脚本
- references：存放按需加载的参考文档，如技术规范、API文档、代码片段、设计指南
- assets：存放素材资源，如模板、字体、图片、logo等
标准Skill结构如下：
skill-name/
├── SKILL.md (必需)
│ ├── YAML frontmatter (必需)
│ │ ├── name: (必需)
│ │ └── description: (必需)
│ └── Markdown instructions (必需)
└── Bundled Resources (可选)
├── scripts/ - 可执行代码
├── references/ - 参考文档
└── assets/ - 资源文件
除SKILL.md为必选项外，其他均为可选项，可根据需要灵活配置。
Agent运行skill时执行以下流程：
- 以SKILL.md为第一指引，了解skill对大模型的要求
- 结合当前任务，判断是否调用scripts、references和assets
- 通过”规划-执行-观察”的循环反馈完成用户任务
SKILL.md是架构中最关键的部分：
SKILL.md内部剖析（图by苍何）
首先是name，通常使用英文和连字符组成，如「frontend-design」。
description是YAML元数据的核心环节，质量直接影响Agent能否准确触发该skill。
以Anthropic官方的frontend-design skill为例，其description字段内容如下：
「frontend-design.skill」的description字段
翻译为中文：该skill用于创建具有高级设计感的专业前端界面，适用于网页组件、页面或应用程序开发场景，生成的代码富有创意且精致，避免千篇一律的AI风格。
description字段直接决定Claude Code在何种情况下自动触发并加载该skill。写得不够清晰或不准确，即使skill再强大，Agent也可能在需要时无法想起使用它。
根据最佳实践，写好description的核心策略和模板如下：
核心原则：触发即正义
Description的首要任务不是给人看，而是给AI路由机制看。需明确回答两个问题：这个skill做什么？用户在什么场景或说什么话时应该使用它？
“黄金结构”公式
高质量description通常遵循：[一句话核心功能] + [具体执行动作] + [明确触发关键词/场景]
优秀写法示例：
案例A：代码审查技能
name: security-code-review
description: Reviews code for security vulnerabilities and best practices. Use when the user asks to "review code", "check for bugs", "analyze security", or mentions specific issues like SQL injection, XSS, or performance bottlenecks.
案例B：PDF处理技能
name: pdf-processor
description: Extracts text, tables, and metadata from PDF files; merges or splits documents. Use when working with PDF files, converting PDFs to text, filling forms, or when the user uploads a PDF and asks for summary/extraction.
写好description的秘诀在于模拟用户提问方式。想象如何向AI提出请求，将这些请求的关键词都写入description。
标准SKILL.md的Markdown格式大致如下：
---
name: 你的skill名称
description: 简要描述该技能的功能以及何时该使用它
---
# 你的技能名称
## 指令 (Instructions)
为 Claude Code 提供清晰、逐步的操作指南。
## 目标 (Goal)
## 示例 (Examples)
展示使用该技能的具体代码或操作案例。
创建「PDF分析」skill的SKILL.md示例：
---
name: pdf
description: 从PDF文档中提取和分析文本。当用户要求处理或阅读PDF时使用。
---
# PDF 处理技能：
1.使用本文件夹中的extract_text.py脚本提取PDF中的文本：
python3 extract_text.py <input_file>
2.提取后，请以结构化格式总结要点。
3、Skills的三个核心机制
Skills的核心架构包含三个协同工作的机制。
以Remotion skill（专门制作视频）的SKILL.md设置为例：
---
name: remotion-best-practices
description: Best practices for Remotion - Video creation in React
metadata:tags: remotion, video, react, animation, composition
---
## When to use
Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge.
## Captions
When dealing with captions or subtitles, load the [./rules/subtitles.md](./rules/subtitles.md) file for more information.
## Using FFmpeg
For some video operations, such as trimming videos or detecting silence, FFmpeg should be used. Load the [./rules/ffmpeg.md](./rules/ffmpeg.md) file for more information.
## Audio visualization
When needing to visualize audio (spectrum bars, waveforms, bass-reactive effects), load the [./rules/audio-visualization.md](./rules/audio-visualization.md) file for more information.
## How to use
Read individual rule files for detailed explanations and code examples:
该skill通过三个机制约束AI行为：
机制一：智能开关（YAML元数据）
每个Skill文件开头（用—包裹的区域）是控制面板，作为元数据始终加载到Claude Code系统提示中，如同技能的”开关”和”权限卡”。
机制二：随用随取的参考（渐进式披露）
传统AI存在”记忆”问题：若将所有开发规范一次性输入，短期记忆（上下文窗口）会被撑爆，导致AI出现幻觉。
Skills的设计巧妙之处在于平时不占用脑容量，只在需要时加载。用户创建数十个Skills如同存放在书架上的工具书，Claude Code平时不翻阅，只在触发特定技能时，才将相关”小抄”加载进大脑。
机制三：行动导向与子代理
Skills不仅让AI读取说明书，还能让AI”动手执行”。在Skill指导下，Claude Code可以执行命令行、搜索文件、运行测试等操作。对于复杂任务，Agent可召唤子代理（Subagent）专门处理子任务，完成后将结果汇报。
渐进式披露（Progressive Disclosure）是Skills最重要的设计哲学。Skills信息不是一次性加载，而是分三层逐步展示：
| 层级 | エレメント | 加载时机 | Token配额 | は英語の -ity、-ism、-ization に対応する。 |
|---|---|---|---|---|
| 第一层 | 元数据（name + description） | 始终在上下文中 | 约100词 | 决定skill何时触发 |
| 第二层 | SKILL.md主体 | 技能触发后 | ＜5000词 | コア・ワークフロー |
| 第三层 | 配套资源（scripts/references/assets） | オン・デマンド・ロード | 限りなく | 详细参考和可执行代码 |
这种设计优势明显：假设一个Skill包含数百页技术文档，若每次对话都全部加载，上下文会迅速耗尽。通过渐进式披露，Claude Code只在需要时才加载相关文档，如同使用组织良好的指南书，只看需要的章节。
4、Skills与Prompt、MCP、Agent、Projects的区别
了解Skills后，需要明确它与其他概念的区别：
简而言之：Skills是预制菜，Prompt是现炒菜，Project是食材，MCP是物流和外卖系统。通过Skills，做法早已预设，用户只需指定菜名，AI就能快速准确地执行，同时节省Token成本。
在Claude Code中，一个SKILL.md文件包含以下功能：
- 包含精细的Prompt，告知AI目标、方法和预期效果
- 规定AI可使用的工具和可执行代码
- 指挥Agent按严格顺序执行，确保不偏离轨道
5、如何找到好用的Skills
获取优质Skills有三个主要渠道：
1）官方推荐
不想折腾代码、追求开箱即用的用户，这是最佳入口。
GitHub上Anthropic官方已预置一批强大的基础Skills，如处理复杂数据的xlsx skill、自动排版商业演示文稿的pptx skill。输入一句话，AI就能掌握这些高级技能。
Anthropic Skills：
https://github.com/anthropics/skills
Anthropic官方Skills
「Skill-creator」强烈建议安装，这是一个用于创建skill的skill，在GitHub上已超过80k star。有了它后，创建任意skill都变得极其简单。
Skill-creator：
https://github.com/anthropics/skills/tree/main/skills/skill-creator
Skill-creator.skill
安装命令很简单，在Claude Code中输入：
帮我安装这个skill，仓库地址是：
https://github.com/anthropics/skills/tree/main/skills/skill-creator
skill-creator安装命令
2）开源Skills市场
Agent Skills作为开放标准，全球开发者都在贡献。
agentskills.io如同AI时代的”应用宝”或”npm软件源”，是官方推荐的全球技能注册表，可搜索各行各业专家的成果。
GitHub开源宝藏库是程序员的热情所在，可直接搜索anthropics/skills官方仓库或社区维护的awesome-agent-skills列表。
GitHub上的「OpenSkills」开源仓库兼容多平台，可自动创建项目规则Markdown文件，”教会”其他AI Agent使用Skills。
OpenSkills项目地址：
https://github.com/numman-ali/openskills
此外还有skillsmp.com和skillsdirectory.com等专门针对Skills的商业平台。
3）自己创建
全网最好用的Skill往往是自己编写的。外部下载的技能虽好，却是通用常识；真正能建立商业护城河的是自己的”不外传的业务秘密”：
- 公司特有的代码命名规范
- 金牌销售应对客户退款的私域话术
- 财务部处理复杂报销的发票合规底线
6、手把手制作Skills：HTML信息图生成器
日常工作中想把文字制作成可视化信息图，可参考以下提示词生成：
提炼下面文字内容的核心关键点，创建一个HTML网页。
文字内容：
{这里是一段文字}
网页的设计要求如下：
1.视觉设计：采用{Magazine Layout}风格布局，{深色}主题色，营造现代高端氛围。
2.字体与排版：
·使用超大字体或数字突出核心要点，中文采用大号粗体，强调视觉冲击力。
·英文使用小号字体作为点缀，与中文形成比例反差，提升设计层次感。
3视觉元素：
·融入超大视觉元素（如标题、背景图或装饰）以突出重点，与小型元素形成强烈对比。
·使用简洁的勾线风格图形作为数据可视化或配图元素，保持现代感和清晰度。
4.色彩与效果：运用高亮色（单色透明度渐变）营造科技感，每种高亮色独立使用，避免不同高亮色之间的渐变混杂。
5.技术要求：引入专业图标库（如Font Awesome或Material Icons，通过CDN加载），避免使用emoji作为主要图标。
6.内容要求：提炼内容关键要点，不忽略重要细节。
用这段提示词整理模型信息，AI能生成直观的信息图：
Qwen3.6-Plus模型信息图
每次都复制提示词、再去AI Chat网站生成、下载、截图很麻烦。可以用这段提示词制作一个「HTML信息图生成器」skill，安装到Claude Code或OpenClaw中。以后需要时，直接告诉Agent「调用HTML信息图生成器.skill生成xxx」即可。
首先给skill取名，使用小写英文、语法标准，如「html-infographic-generator」，单词间用连字符连接。
按照前文介绍的Skills文件结构设计架构，信息图生成器通常只需SKILL.md文件，可按需添加reference文件夹中的设计指南和assets文件夹中的示例：
html-infographic-generator/
├── SKILL.md # 入口文档（设计规范+操作流程）
├── references/
│ └── design-guide.md # 详细设计指南
SKILL.md即Markdown格式，是一种轻量级标记语言，用纯文本格式编写文档，可转换为HTML/PDF。
SKILL.md通常包含：
---
name: 你的skill名称
description: 简要描述该技能的功能以及何时该使用它
---
# 你的技能名称
## 指令 (Instructions)
为 Claude Code 提供清晰、逐步的操作指南。
## 目标 (Goal)
## 示例 (Examples)
展示使用该技能的具体代码或操作案例。
最上面的—包裹区域是YAML元数据，包含name和description字段，是Agent识别Skill的名片。
「html-infographic-generator」的YAML元数据：
---
name: html-infographic-generator
description: 从用户文字中提炼核心关键点，生成Magazine Layout风格的深色主题HTML信息图网页；当用户需要将文字内容可视化、创建信息图、生成数据展示页面或制作图文混排页面时使用。
---
YAML元数据定义了HTML信息图生成器的功能：当用户需要内容可视化、创建信息图、生成数据展示页面或制作图文混排页面时，加载这个skill。
description字段是关键，决定Agent何时自动调用该skill。设计时需使用省略第二人称的祈使句，如”把用户上传的文字生成HTML”，而非”你帮我把这段文字生成HTML”。字数一般不超过500字，包含skill触发关键词即可。
写好YAML元数据后是具体执行指令。「html-infographic-generator.skill」的完整SKILL.md如下：
# HTML信息图生成器
## 任务目标
- 本 Skill 用于：从用户提供的文字内容中提炼核心关键点，生成视觉冲击力强的HTML信息图网页
- 能力包含：文本关键点提炼、信息架构设计、HTML/CSS代码生成、视觉设计实现
- 触发条件：用户发送文字内容并希望生成可视化信息图、数据展示页面、图文混排网页
## 设计规范
### 1. 视觉设计
- **布局风格**：采用Magazine Layout（杂志排版）风格，强调网格系统、留白对比、视觉层次
- **主题色调**：深色主题，背景色使用 `#0a0a0a` 或 `#1a1a1a`，营造现代高端氛围
- **视觉层次**：通过大小、粗细、位置、色彩对比建立清晰的信息层级
### 2. 字体与排版
- **中文文本**：使用大号粗体（60-120px），突出核心要点，强调视觉冲击力
- 标题字体：`font-weight: 700-900`
- 推荐字体：Noto Sans SC、Source Han Sans（通过Google Fonts加载）
- **英文文本**：使用小号字体（12-16px）作为点缀，与中文形成比例反差
- 字体选择：Roboto、Inter、SF Pro Display
- 用途：副标题、注释、装饰性文字
- **行高与间距**：
- 标题行高：1.1-1.3
- 正文行高：1.6-1.8
- 段落间距：使用em或rem单位保持比例一致性
### 3. 视觉元素
- **超大视觉元素**：融入超大标题、背景图或装饰元素以突出重点
- 标题字号可达120-200px
- 背景图使用低透明度（10-30%）避免干扰文字
- **对比原则**：超大元素与小型元素形成强烈对比
- **图形风格**：使用简洁的勾线风格图形作为数据可视化或配图元素
- 可使用CSS绘制几何图形（圆、线、矩形）
- SVG图标保持线条简洁（stroke-width: 1.5-2px）
### 4. 色彩与效果
- **基础色板**：
- 背景：`#0a0a0a`、`#1a1a1a`
- 主文字：`#ffffff`、`#f0f0f0`
- 次要文字：`#888888`、`#666666`
- **高亮色方案**（单色透明度渐变）：
- 青色系：`rgba(0, 255, 255, 0.8)` → `rgba(0, 255, 255, 0.1)`
- 洋红系：`rgba(255, 0, 255, 0.8)` → `rgba(255, 0, 255, 0.1)`
- 金色系：`rgba(255, 215, 0, 0.8)` → `rgba(255, 215, 0, 0.1)`
- 绿色系：`rgba(0, 255, 128, 0.8)` → `rgba(0, 255, 128, 0.1)`
- **渐变规则**：每种高亮色独立使用，避免不同高亮色之间的渐变混杂
- **科技感营造**：使用透明度渐变、发光效果（box-shadow）、渐变边框
### 5. 技术要求
- **图标库**：引入Font Awesome或Material Icons（通过CDN加载）
```html
<!-- Font Awesome -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
<!-- Material Icons -->
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
- 字体库：引入Google Fonts
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;700;900&family=Roboto:wght@300;400;700&display=swap" rel="stylesheet"> - 禁止使用emoji：避免使用emoji作为主要图标，统一使用专业图标库
6. 内容要求
- 关键点提炼：
- 识别核心主题、关键数据、重要结论
- 保留重要细节，不遗漏关键信息
- 合理分组，建立信息层次
- 信息架构：
- 主标题：最核心的信息
- 副标题：补充说明或引导
- 正文段落：详细阐述
- 数据/列表：结构化展示
手続き
步骤1：文本分析与关键点提炼
- 阅读用户提供的文字内容
- 识别核心主题、关键数据、重要结论
- 提炼3-8个核心关键点
- 确定信息优先级和层次关系
步骤2：信息架构设计
- 确定主标题内容（最核心信息）
- 规划副标题和正文段落
- 设计数据展示方式（数字、列表、图表）
- 确定视觉元素布局（标题位置、装饰元素、留白区域）
步骤3：HTML代码生成
- 引入必需资源（Font Awesome、Google Fonts）
- 编写HTML结构：
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>信息图</title> <!-- 引入资源 --> </head> <body> <!-- 内容结构 --> </body> </html> - 编写CSS样式：
- 基础样式（重置、字体、颜色变量）
- 布局样式（网格系统、容器、间距）
- 组件样式（标题、段落、卡片、图标）
- 效果样式（渐变、阴影、动画）
步骤4：输出与交付
- 生成完整的HTML文件（包含内联CSS）
- 确保代码格式规范、注释清晰
- 使用write_file工具保存文件到用户工作目录
资源索引
设计指南
- 详细设计规范：见 references/design-guide.md
- 包含：Magazine Layout风格说明、配色方案、布局模板、最佳实践
HTML模板
- 基础模板：见 assets/template.html
- 包含：基础结构、资源引入、示例样式、常用组件
ほら
設計原則
- 视觉冲击力优先：通过超大字体、强对比、高亮色营造视觉焦点
- 留白即设计：充分利用留白创造呼吸感和高级感
- 克制使用色彩：深色背景+单一高亮色系，避免色彩混乱
- モバイル適応：使用响应式设计，确保在不同设备上的可读性
技術的実現
- 所有样式内联在HTML文件中，确保文件可独立运行
- 使用CSS变量管理颜色和间距，便于维护
- 优先使用CSS实现视觉效果，减少对外部图片的依赖
- 确保代码结构清晰、注释充分
コンテンツハンドリング
- 不遗漏重要细节，但避免信息过载
- 使用视觉层次引导阅读顺序
- 数据类内容优先使用数字+图标+简短说明的形式
使用例
示例1：产品数据展示
輸入：用户发送某产品年度销售数据文字描述
扱う：
- 提炼核心数据：总销量、增长率、市场份额等
- 设计信息架构：主标题（核心数据）+ 数据卡片（详细指标）
- 生成HTML：使用超大数字展示、渐变背景、图标装饰
輸出：完整的HTML信息图文件
示例2：知识要点总结
輸入：用户发送某主题的知识内容或文章
扱う：
- 提炼3-5个核心知识点
- 设计信息架构：主标题 + 要点列表 + 补充说明
- 生成HTML：使用编号列表、图标标记、卡片布局
輸出：结构化的HTML信息图
示例3：事件时间线
輸入：用户发送某事件的发展过程描述
扱う：
- 提炼关键时间节点和事件
- 设计信息架构：时间线布局 + 事件卡片
- 生成HTML：使用垂直/水平时间线、节点标记、渐变效果
輸出：时间线风格的HTML信息图
SKILL.md包含任务目标、设计规范、操作步骤、资源索引、注意事项和使用示例，详细规定skill的工作流程和输出标准，全程使用Markdown格式编写。
为帮助Agent更好理解该skill，还创建了references参考文件夹，包含design-guide.md设计指南：
HTML信息图设计指南
ディレクトリ
-
- Magazine Layout风格说明
-
- 深色主题配色方案
-
- 字体排版最佳实践
-
- 视觉元素设计原则
-
- 常见布局模板
Magazine Layout风格说明
コア機能
Magazine Layout（杂志排版）风格借鉴传统杂志的视觉设计，强调：
-
- 网格系统：基于列的布局，创造有序的视觉结构
-
- 留白对比：大量留白突出内容，营造高级感
-
- 视觉层次：通过大小、粗细、位置建立清晰的信息优先级
-
- 图文混排：文字与视觉元素有机结合，增强表现力
设计要点
1. 网格系统
/* 基础网格布局 */
.container {
display: grid;
grid-template-columns: repeat(12, 1fr);
gap: 24px;
max-width: 1400px;
margin: 0 auto;
padding: 40px;
}
/* 内容区域 */
.content-wide {
grid-column: span 12; /* 全宽 */
}
.content-main {
grid-column: span 8; /* 主内容 */
}
.content-side {
grid-column: span 4; /* 侧边栏 */
}
2. 留白运用
- 页面边距：40-80px
- 元素间距：24-48px
- 段落间距：1.5-2em
- 列表项间距：12-20px
3. 视觉层次
Level 1: 超大标题 (120-200px) - 最核心信息
Level 2: 大标题 (48-72px) - 重要章节
Level 3: 中标题 (24-36px) - 段落标题
Level 4: 正文 (16-18px) - 详细内容
Level 5: 辅助文字 (12-14px) - 注释、说明
design-guide.md全文太长，详细略
该文件详细阐述设计风格、设计要点、页面布局模板和设计检查清单，是skill的注释文件，帮助Agent理解技能任务。
整个skill由2层结构、2份文件构成：html-infographic-generator.skill可将任意文字生成顶级审美的信息图。无需输入Prompt，直接给文字即可。Agent会自己总结、提炼，生成HTML信息图，适合产品介绍、宣传方案、新媒体素材等可视化内容。
该skill已免费发布在扣子技能商店，搜索关键词「HTML信息图生成器」可查找使用。
在扣子商店调用
Skill地址：
https://www.coze.cn/?skill_share_pid=7614920172729843731
7、安装公开的Skills
除自行制作skill外，也可安装公开的skill。
Skill通常托管在GitHub上，Anthropic的开源skill统一存放在此。
Anthropic的开源skill
仓库地址：
https://github.com/anthropics/skills/tree/main/skills
还有一些专门的skill市场：
https://www.skillhub.club
https://agentskills.io
https://skillsmp.com
https://www.skillsdirectory.com
https://skillhub.tencent.com
安装skill很简单，在Claude Code或OpenClaw中输入：
帮我安装这个skill，仓库地址是：
https://github.com/anthropics/skills/tree/main/skills/skill-creator
「Skill-creator」建议每个人都安装，这是一个专门创建skill的Skill，在GitHub上已有超过80k star。有了它后，创建Skill变得极其简单，只需输入：
用creator skill帮我创建一个word转PPT的skill。
Agent会自动设计框架、SKILL.md和运行脚本，完成skill创建。
8、创建与部署Skills的最佳实践
根据Anthropic官方文档和社区实践，创建并部署一个skill通常包含四个阶段：
阶段一：明确需求与边界
动手前先回答三个问题：
1）这个skill要解决什么具体问题？原则是”单一职责”，每个skill只专注一个能力。”处理PDF”太宽泛，”从PDF中提取表格并转换为CSV”是好的定义。
2）触发它的关键词/场景是什么？这决定description字段的写法。不要写”帮助处理文档”，而要写”当用户提到PDF、表单或文档提取时，用于从PDF中提取文本和表格”。
3）需要哪些资源？脚本、模板、参考文档还是示例数据？提前整理好，放入skill文件夹的对应子目录。
阶段二：构建skill文件夹
确定需求后创建文件结构，可选择三个存放位置：
| 類型論 | トレール | 使用シナリオ |
|---|---|---|
| 个人skill | ~/.claude/skills/ | 个人工作流优化、实验性功能 |
| 项目skill | .claude/skills/ | 团队协作、项目特定知识 |
| 插件skill | 通过插件系统安装 | 跨项目共享、公开发布 |
核心文件SKILL.md的结构：
---
name: your-skill-name
description: 清晰描述Skill的功能和触发场景，最多1024字符。
allowed-tools: Read, Grep # 可选：白名单工具列表
--------------------------------------------------
# Skill标题
## 功能说明
为Claude提供清晰的分步操作指导
## 使用示例
展示具体应用场景和方法
## 注意事项
边界条件、常见陷阱等
命名规范：name字段仅使用小写字母、数字和连字符，不超过64个字符。文件夹名称须与name一致。
阶段三：编写核心指令
这是决定skill质量的关键步骤。Anthropic内部团队经验表明，最有价值的内容是”常见陷阱”章节，应持续累积Agent的失败模式，让后来者直接绕坑。
高质量SKILL.md通常包含：
1）明确的职责边界：告诉Agent能做什么和绝对不能做什么。SQL分析skill应明确限定只能执行SELECT查询，禁止DROP、DELETE等危险操作。
2）具体的操作步骤：用编号列表而非段落文字。Agent对结构化内容的遵循度远高于叙述性文字。
3）输入输出规范：给出示例格式和预期输出，显著降低结果的随机性。
4）硬性约束：使用”必须””严禁””总是”等绝对化词汇。研究发现，包含至少3条明确约束和1个输出示例的skill，结果稳定性可提升60%。
阶段四：测试、调试与迭代
创建完成后按清单验证：
- 路径检查：确认SKILL.md位于正确目录（.claude/skills//）
- YAML校验：确保元数据格式正确，—包裹无误
- 触发测试：用自然语言提问，观察Agent是否识别并请求使用该skill
- 执行验证：检查输出是否符合预期格式和内容
如果skill未被触发，90%的情况是description写得不够具体。调试时可运行claude –debug查看详细加载日志。
比”理解”更重要的是亲手去做。尝试写出第一个.skill，把重复的工作、熟悉的流程、自己的经验沉淀成可复用的能力。
制作skill的那一刻，关于Agent和Skills的很多理解都会变得清晰起来。
