Agent 是智能体，Skills 是技能的意思，Agent Skills（智能体技能）是将专业知识、工作流规范固化为可复用资产的核心工具。
Agent Skills 本质上是一个模块化的 Markdown 文件，能教会 AI 工具 （如 Claude、GitHub Copilot、Cursor 等） 执行特定任务，且支持自动触发、团队共享与工程化管理，彻底告别重复的提示词输入。
Agent Skills 的本质不是工具，而是：
行为规范 + 专业知识 + 使用时机的组合
Skills 基础内容参考：Skills 教程
核心形式：
Agent Skills 的工作原理
Agent Skills 的关键是渐进式披露，分三层加载：
支持的工具和环境
目前主要支持：
为什么需要 Skills？它解决了什么问题？
普通 AI 代理（如 Claude 或 Copilot）很聪明，但缺少特定上下文时容易出错。例如：
Agent Skills 解决这些问题：
核心概念快速理解
Skill 执行流程
Skill 的最小结构
my-skill/ └── SKILL.md （唯一必需）
SKILL.md 基本模板:
--- name: your-skill-name description: What it does and when Claude should use it --- # Skill Title ## Instructions Clear, concrete, actionable rules. ## Examples - Example usage 1 - Example usage 2 ## Guidelines - Guideline 1 - Guideline 2
元数据字段:
Skills 支持在内容中插入动态变量：
例如：
--- name: session-logger description: 记录当前会话活动 --- 请将以下内容写入日志文件： logs/${CLAUDE_SESSION_ID}.log $ARGUMENTS
调用：
/session-logger 用户登录成功
实际会生成会话专属日志记录。
SKILL.md 文件的核心构成
以 Claude 的 PDF 文档编辑技能为例，Claude 原生可解析 PDF，但无法直接操作（如填写表单），该技能补足了这一短板。
多文件 Skill（渐进式披露）
渐进式披露机制
下图显示了当用户消息触发技能时，上下文窗口如何变化:
推荐目录结构
为避免上下文膨胀：
推荐结构:
my-skill/ ├── SKILL.md ├── reference.md ├── examples.md # 存放示例文件 └── scripts/ └── helper.py
第一个 Skill
让我们暂时忘掉复杂的创建过程，先从 使用一个现成的 Skill 开始，感受它带来的便利。
创建 Skill 目录
Skills 存放在 ~/.claude/skills/ （个人全局）或项目目录下的 .claude/skills/ （项目专用）。
本章节再项目目录下测试，先创建个目录 claude-test:
mkdir claude-test
进入该目录，创建 skills 的目录与文件：
mkdir -p .claude/skills/python-naming-standard
编写配置文件 SKILL.md
在目录下创建 SKILL.md，这是 Skill 的大脑 ，告诉 Claude 什么时候用它。
--- name: Python 内部命名规范技能 description: 当用户要求重构、审查或编写 Python 代码时，请参考此规范。 --- ## 指令 1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。 2. 如果发现不符合此规则的代码，请自动提出修改建议。 3. 在执行 `claude commit` 前，必须检查此规范。 ## 参考示例 - 正确：`def _internal_calculate_risk():` - 错误：`def _calculate_risk():`
字段要求：
创建完后文件结构如下：
你的项目现在看起来应该是这样的：
my-project/ ├─ src/ │ └─ test.py # 项目源码 ├─ .claude/ │ ├─ skills/ │ │ └─ hello-world/ │ │ ├─ skill.md # Skill 定义（YAML + Instructions，机器可执行） │ │ └─ README.md # Skill 说明（人类阅读，可选） │ └─ config.yml # Claude 项目级配置（可选） ├─ .gitignore └─ README.md # 项目整体说明
接下来我们再终端执行以下命令启动 Claude Code：
claude
输入任务：
帮我写一个计算用户折扣的函数
Claude 就会会扫描已安装的 Skills，发现你的请求涉及 "Python 代码编写"，匹配了 python-naming-standard。
它会根据 SKILL.md 中的要求，生成如下代码：
def _internal_get_discount(user_score): # 计算逻辑... return discount
添加资源文件（可选）
另外我们可以在 .claude/skills/ 下添加以下目录：
在同一文件夹添加：
然后在 SKILL.md 中引用：
查看示例 commit：./examples/good-commit.txt 运行脚本：使用工具执行 ./scripts/process.py
官方市场
除了自己编写，你还可以利用 2025 年末发布的 Agent Skills 开放标准：
我们可以将本仓库注册为 Claude Code 的插件市场，只需在 Claude Code 中执行以下命令：
/plugin marketplace add anthropics/skills
然后就可以使用 /plugin 查看：
安装指定技能集的步骤：
我们也可直接通过命令安装上述两类插件：
/plugin install document-skills@anthropic-agent-skills /plugin install example-skills@anthropic-agent-skills
注意： 使用插件安装的 skills 目录在 ～/claude/plugins/marketplaces/ 下。
插件安装完成后，需要重启一下 Claude Code。
使用的时候只需在指令中提及技能名称即可调用，例如安装 document-skills 插件后，可向 Claude Code 下达指令：
使用 PDF 技能提取 path/to/some-file.pdf 文件中的表单字段
或者创建一个 PPT：
创建一个 Agent Skill 的演示文稿
可以看到，调用了 /document-skills:pptx ：
开始生成：
之后就会告诉你生成的文件位置：
Agent Skills 相关资源整理
