Agent Skills 101：从零理解技能包

Agent Skills 是自 2021 年 Copilot 问世以来，开发者与 AI 编程工具交互方式上最大的一次转变。本指南说明它们是什么、生态为何增长如此之快，以及如何今天就开始使用。

什么是 Agent Skills？

Agent Skill 是一套结构化指令，用来教 AI 编程助手完成特定任务。可以把它理解成 AI Agent 的「插件」。

一个 Skill 至少包含一个文件：SKILL.md，其中通常有：

---
name: my-skill
description: What this skill does
---

后面是 AI Agent 会读取并遵循的 Markdown 说明。部分 Skill 还会在 scripts/ 目录放可执行脚本，在 references/ 目录放参考文档。

SKILL.md 标准

2025 年 12 月，Anthropic 将 SKILL.md 格式开源，作为描述 AI Agent 能力的标准。数月内，OpenAI、Microsoft、Google 相继采用。格式刻意保持简单：

• YAML frontmatter：元数据（name、description、version）
• Markdown 正文：指令（做什么、何时做、怎么做）
• 可选 scripts/：自动化任务
• 可选 references/：上下文文档

正因为足够简单，生态在不到一年内增长到 70 万+ Skill。任何人都能写 SKILL.md，无需 SDK、API 或构建步骤。

Skill 存放在哪里

Skill 通常保存在本机，例如：

~/.claude/skills/          # Claude Code
~/.codex/skills/           # OpenAI Codex CLI
~/.cursor/skills/          # Cursor（通过扩展）

启动会话时，Agent 会发现技能目录下的所有 Skill，并把说明加载进上下文。当你的请求与某个 Skill 的用途匹配时，Agent 就会使用它。

Skill 如何改变工作流

没有 Skill 时

你需要写很长的提示，把需求说清楚：

Write a React component for a user profile card. It should accept name, email,
and avatar URL as props. Use TypeScript. Include a loading skeleton. Write
unit tests with Jest and React Testing Library. Follow our project's convention
of using CSS modules.

每次都要重复项目约定、格式规范和测试习惯。

有 Skill 之后

安装一次即可。然后你可以说：

Create a UserProfile component with name, email, and avatar props.

Skill 已经知道你的约定、测试方式和格式偏好，Agent 会自动按 Skill 执行。

差别不一定在输出质量（可能相近），而在输入成本：Skill 把详细说明变成一句话请求。

2026 年的 Skill 生态

完整列表见 SkillMap 排行榜。

如何开始（约 5 分钟）

1. 安装一个 Skill

选一个你每天都会做的任务。写 Git 提交信息几乎人人都需要：

claude skill add --from-github anthropics/skills

2. 在真实任务里使用

打开项目，正常开发。准备提交时：

Commit these changes

Skill 会生成符合规范的提交说明。这就是你的第一个 Agent Skill。

3. 有真实需求再加更多

不要一次性批量安装。一次加一个，只在有明确场景时使用。

常见误解

「Skill 就是提示词。」 不完全是。Skill 有结构、可版本化、可发现，还能包含脚本、参考文档和条件逻辑。提示词是一段字符串，Skill 是一个模块。

「必须自己写 Skill 才有用。」 多数开发者从不写 Skill，用生态里现成的即可。只有项目有非常特殊的约定、公开 Skill 覆盖不到时，才需要自己写。

「Skill 让 AI 更聪明。」 Skill 不改变模型能力，而是为重复任务提供稳定指令。价值在于一致性，不是「变聪明」。

SkillMap 做什么

SkillMap 跟踪 Agent Skills 生态：维护排行榜、为热门 Skill 写实战教程、发布每周动态。想为工作流找到合适的 Skill，可以从这里开始。

刚接触 Agent Skills？先看安装教程，约 5 分钟即可上手。