What are Agent Skills? | Skillrz 学习中心

简短的回答

技能是一个带有 SKILL.md 里面的文件。该文件打开时带有一个短标题，其中包含姓名和一个描述，其后是指令。您的智能体仅记住名称和描述，直到请求匹配为止，然后读取其余部分。相同的文件夹适用于 Claude Code、Codex 和 Cursor。

跳转至：看一个真实的例子技能内部.md 代理商如何挑选

为什么存在技能

你可能已经这样做过

您为启动页面保留 40 行提示。它详细说明了布局、部分以及手机宽度的检查。你每次粘贴它，跳过一次行，页面就会不同。然后，一位队友要求“那个提示”，然后你向他们发送上个月的副本。

技能会将提示转入您的智能体自行找到的文件夹中。采取 Meridian Marketing Landing：一旦安装，代理就已经知道方格纸英雄、功能网格和定价切换。您只需携带产品信息即可。

大多数Claude技能示例都遵循相同的模式：一种输出的固定方法。 Notion Style OG Image 制作 16:9 的共享图像，Skillrz 上的其他技能可构建幻灯片、简历网站和短视频。

	粘贴提示	Skill
你解释什么	每次的布局、部分、样式和检查	只是您的内容
从跑到跑	每次都会有一点漂移	遵循相同的步骤
分享	从你的聊天记录中挖掘出来	安装同一个文件夹

SKILL.md 文件里面有什么？

一项技能需要一个文件， SKILL.md，并且可以携带用于参考文档、脚本和模板的可选文件夹。该文件有两部分：之间的短标头 --- 行，然后是为代理编写的简单说明。

技能文件夹

launch-page/
├── SKILL.md        required
├── references/     optional: docs read when needed
├── scripts/        optional: code the agent can run
└── assets/         optional: templates and files

SKILL.md

---
name: launch-page
description: Build a product launch page with a hero, a feature
  grid, and a pricing toggle. Use when asked for a launch page.
---

1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.

name

最多 64 个字符，使用小写字母、数字和连字符。它必须与文件夹名称匹配。

description

最多 1,024 个字符。说说技能的作用 以及何时使用它;代理人依靠下半场来选择它。

可选

license, compatibility, metadata, allowed-tools

这些限制来自公开代理技能规范。Claude·科德更轻松：可以省略 name 它会退回到文件夹名称。

代理如何决定使用哪种技能？

它将您的请求与每个技能的描述进行比较。为了保持便宜，它分三个阶段加载每个技能：

1启动时，它读取每个已安装技能的名称和描述。没有别的了。
2当您的请求符合时描述，或者您按名称调用技能，它会加载完整的 SKILL.md.
3虽然它有效，它打开文件 references/ 或运行 scripts/ 仅当指令要求时才执行。

这就是为什么您可以安装数十种技能而不会减慢智能体速度。在需要一项技能之前，它会占用大约一个句子的上下文。

代理	按名称呼叫技能
Claude Code	`/skill-name`
Codex	`$skill-name`，或从中选择 `/skills`
Cursor	`/skill-name`, or `@skill-name` 附加它

自动拣选的效果与描述一样好。触发展示如何编写被选中的内容。在那之前，称呼技能的名字总是有效的。

哪些特工可以使用技能？

您听说过的大多数代理商。 Anthropic 为 Claude 创建了该格式，并于 2025 年 12 月 18 日将其作为开放标准发布。agentskills.io 网站现在列出了数十种读取该格式的工具，包括 Claude Code、ChatGPT 和 Codex、Cursor、VS Code、GitHub Copilot 和 Gemini CLI。

代理	个人文件夹
Claude Code	`~/.claude/skills/`
Codex	`~/.agents/skills/` （也读较旧的 `~/.codex/skills/`)
Cursor	`~/.cursor/skills/` or `~/.agents/skills/`

您的个人文件夹中的技能可在您计算机上的每个项目中使用。项目文件夹和代理查看的所有其他位置都列在其中技能地点.

技能或提示：你应该使用哪一个？

当您重复执行任务并每次都希望获得相同的质量时，请将其作为一项技能。对于一次性的情况，提示就足够了。

让它成为一项技能

你会再做一次

它需要示例、脚本或清单
你每次都想要相同的结果
其他人也需要它

保持提示

这是一次性的

几句话就涵盖了
你还在努力做你想要的事
里面没有任何东西值得重用

大多数时候你都会使用两者。提示说你今天想要什么，技能说如何做好。 Skills vs prompts 更深入。

安装技能之前要检查什么

技能可以在您的计算机上运行脚本，因此请先快速阅读每个新技能。

五分钟检查

阅读 SKILL.md 并记下允许更改的内容。
阅读所有内容 scripts/。这些脚本在您的计算机上运行。
检查 Dependencies 和 Outside costs 在技能页面。
将密码和 API 密钥保留在技能文件和聊天之外。

完整列表位于安全。当您准备好尝试时， Getting started 引导您完成首次安装。

常见问题

Claude技能是什么？

这就是大多数人在Claude或Claude代码中使用时所说的代理技能。格式相同：一个带有 SKILL.md 文件。该文件夹也适用于 Codex 和 Cursor。

Claude怎么知道该使用哪个技能呢？

它将您的请求与每项技能的描述进行比较，并加载适合的技能。打字 /skill-name 跳过猜测。

我可以免费使用Claude技能吗？

技能只是文件，因此免费的技能不需要任何费用。无论产品需要什么计划，您仍然需要一个支持技能的代理，例如 Claude Code、Codex 或 Cursor。 Skillrz 也有免费技能，例如 Dot Avatar Maker.

技能与 MCP 服务器相同吗？

不会。技能会向代理传授一种方法，而 MCP 服务器将其连接到外部数据和工具。您会经常一起使用它们。参见技能 vs MCP.

来源

本指南有帮助吗？

下一步Getting started