返回博客

AI 入门指南

什么是代理技能（SKILL.md），以及如何审查它

技能是一个包含 SKILL.md 文件的文件夹，代理只在需要时加载它。它与提示词有何不同、在 token 上消耗多少、如何审查一个技能。

作者：CheapTokens Team发布于 6 分钟阅读

SKILL.md 文件的头部，包含名称和描述字段
本页内容
  1. 什么是技能，它与提示词有何不同
  2. 技能如何进入上下文窗口
  3. 两分钟写一个最小技能
  4. 技能、AGENTS.md、MCP：各是什么
  5. 安装前审查第三方技能

技能是一个文件夹，里面有一个 SKILL.md 文件，放在你的编码代理会查找的位置。代理只在你的请求与它匹配时才会读取该文件。在此之前，技能只消耗大约一百个 token，而提示词会随着你粘贴它的每条消息一起传输。

你可能在 README 里见过这个词：“安装技能，然后让代理……”。这没什么神秘的。下面介绍：里面有什么、它何时进入上下文窗口，以及在你把它放到自己机器上之前如何检查它。

什么是技能，它与提示词有何不同#

Anthropic 的 Agent Skills 文档（2026 年 10 月 30 日查阅）将技能描述为一种可复用的、基于文件系统的资源：一个包含 SKILL.md 文件的目录，外加可选的脚本、模板和参考文件。SKILL.md 以一个简短的 YAML 头部（名称和描述）开头，后面是纯文本指令。

把它想成一位新同事。提示词是你站在他们椅子后面，每天早上重复规则。技能是书架上的一本活页夹，书脊上贴着标签：“提交信息风格。有人让你提交时读它。”他们只在需要时才把它取下来。

闪卡

每个技能 README 里都会遇到的词

有两个头部字段是必需的，而且格式有规则。在 Claude 的技能格式中，name 最多 64 个字符：小写字母、数字和连字符，且不能包含“anthropic”或“claude”这两个词。description 不能为空，上限为 1,024 个字符，并且必须同时说明技能做什么以及何时使用。

一个技能文件夹：SKILL.md 加上可选的模板和脚本
技能的结构：一个必需文件，其余都是可选的。

技能如何进入上下文窗口#

文档称之为渐进式披露：代理分三个阶段读取技能，每个阶段只有在到达时才需要付费。

  • 第 1 级，始终加载。 每个已安装技能的名称和描述，每个技能约 100 个 token。
  • 第 2 级，触发时加载。 SKILL.md 的正文，少于 5,000 个 token。
  • 第 3 级，仅在需要时加载。 捆绑文件和脚本。当代理运行脚本时，脚本的代码不会进入上下文，只有其输出会进入。

token 数字是文档中的近似值，不是精确计数。

排序

按代理遇到它们的顺序排列三个阶段

  1. 代理启动并读取每个已安装技能的名称和描述
  2. 你的请求匹配某个描述，于是读取 SKILL.md 正文
  3. 指令提到某个脚本或模板，于是使用该文件
三个加载级别：名称和描述、SKILL.md 正文、捆绑文件
每个级别只有在上一级决定需要它时才被读取。

这就是为什么这对你的账单很重要。假设你安装了 20 个技能。20 × 100 = 2,000 个 token 从第一条消息起就一路随行。代理在每一步都会重新发送其上下文（20 步示例说明了原因），所以一个 50 步的会话会携带 50 × 2,000 = 100,000 个输入 token 的技能标签。在 DeepSeek-V4-Flash 上，按当前价格计算就是 $0.0015。

现在反过来看。如果那二十个技能被粘贴成一个大提示词，每个正文都会出现在每个请求中：每个请求最多 20 × 5,000 = 100,000 个 token，而不是每个会话。这个差距就是按需加载的全部意义。如果“上下文窗口”这个术语对你来说仍然模糊，这篇解释介绍了什么会填充它。

技能存在于上下文中，所以代理背后的模型需要为它们留出空间。CheapTokens 上的 DeepSeek-V4-Flash（id deepseek-ai/DeepSeek-V4-Flash-0731）拥有 380K 上下文窗口，每次回答最多 32,768 个输出 token，全天统一价格，并提供兼容 OpenAI 和 Anthropic 的 API。对于终端代理，请遵循如何将 Claude Code 连接到 CheapTokens；对于任何其他工具，请从文档开始。模型自己的页面在这里。

两分钟写一个最小技能#

写过一个之后读起来会更容易。这个技能让代理以固定格式编写提交信息。在 Claude Code 中，个人技能位于 ~/.claude/skills/，项目技能位于 .claude/skills/，所以项目技能可以随仓库一起走。

bash
mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

把这段粘贴到文件中：

markdown
---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

现在在一个有已暂存更改的仓库中打开代理，然后问：“为我已经暂存的内容写一条提交信息”。代理看到描述，判断它匹配，读取四条规则并遵循它们。如果它忽略了技能，先看 description：它必须用你实际会使用的词来指明场景，这里是“commit”。

一个注意点：技能不会在 claude.ai、API 和 Claude Code 之间同步。你在一个地方创建的技能必须单独添加到其他地方。

技能、AGENTS.md、MCP：各是什么#

这三者经常被混淆。像 AGENTS.md 或 CLAUDE.md 这样的规则文件会在会话开始时被读取，保存关于项目的事实（那个文件在 Downloads 文件夹中如何出错）。MCP 服务器为代理提供新的工具和可访问的数据（通俗解释 MCP）。技能是一种流程：如何完成某一类工作，在该工作出现时加载。

快速检查

你安装了 20 个技能，今天一个都没用。它们在上下文中消耗你多少？

显示答案

答案: 每个约 100 个 token，用于名称和描述

名称和描述始终加载（根据文档，每个技能约 100 个 token）。正文只在技能触发时加载，脚本代码从不进入上下文，只有其输出会进入。

安装前审查第三方技能#

技能是代理遵循的文本，有时也是代理运行的代码。文档建议只使用来自可信来源的技能，审计每个捆绑文件（SKILL.md、脚本、资源），并查找意外的网络调用或文件访问。获取外部 URL 的技能风险更高。在 Claude Code 中，技能与你计算机上的任何程序拥有相同的网络访问权限，所以要把安装当作安装软件来对待。

一个很好的样本是 universal-modder，一个游戏模组工具包。它的 README（2026 年 10 月 30 日查阅）描述了一组采用 Agent Skills 格式的 MIT 许可技能、一个名为 um 的 Python CLI、一个通过 fal 进行资产生成的 MCP 服务器，以及一个共享的现场笔记知识库。主技能 mod-any-game 涵盖侦察、逆向工程、资产生成、游戏内测试和打包。README 将 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 和 OpenCode 列为支持的工具，并表示该工具包拒绝绕过反作弊或 DRM。在 Claude Code 中，它通过 /plugin marketplace add rehan-remade/universal-modder 安装，资产生成需要单独的 fal API 密钥。

注意那个列表包含什么：技能、一个命令行程序和一个服务器。只读一个 SKILL.md 只能覆盖你所安装内容的一小部分。所以要逐一检查各部分：

清单

在你安装别人的技能之前

关键规则在如何安全存储 API 密钥中。仓库页面没有显示最后提交日期，所以在依赖它之前，请检查项目最近更新的时间。

标签: