Agent Skills 详解：从概念到实战，打造你的AI技能库

在AI工具百花齐放的今天，Agent Skills 作为一种能让AI更智能、更高效的技术，正逐渐成为开发者和AI爱好者的新宠。它起初是Claude中的一个小功能模块，凭借其出色的实用性，迅速得到Codex、Cursor、OpenCode等AI编程工具的支持，并于2025年12月18日由Anthropic正式发布为开放标准，朝着通用、跨平台的方向发展。本文将带你从概念、原理到实战，全面掌握Agent Skills。

一、Agent Skills 是什么？

一句话总结：Agent Skills 是一种带目录的“AI技能说明书”，采用渐进式披露提示词的机制，让AI能按需加载能力，大幅降低Token消耗和提示词复杂度。

它把提示词分为三层：

元数据（Metadata）：必定加载，类似“技能目录”，包含技能名称、描述等核心信息。

指令（Instruction）：按需加载，类似“技能正文”，详细定义AI的任务和规则。

资源（Resource）：按需加载，类似“技能附录”，可包含脚本、文档、图片等辅助文件。

 

二、技术原理：渐进式披露的智慧

 AI使用Agent Skills时，并非一次性加载所有内容，而是先加载“元数据”（目录），再根据需求决定是否加载“指令”（正文）和“资源”（附录）。这种设计有两大优势：

 降低Token消耗：每个Skill仅元数据会持续占用上下文，通常仅约100 Token。

简化提示词管理：把复杂的提示词拆分为“目录-正文-附录”，结构更清晰。

 三、实战：从0到1创建你的第一个Skill

1. 环境准备（以Claude Code为例）（强烈建议wx gzh 有机大橘子，0基础小白也能看懂下载教程）

安装Claude Code：访问Claude Code官网，复制安装命令，在终端执行即可。

配置模型（可选）：若没有Claude官网账户，可修改配置文件接入其他模型（如智谱GLM）

2. 目录结构与文件规范

Skill以文件夹形式组织，典型结构如下：

 plaintext

项目目录/

└── .claude/

    └── skills/

        ├── 字幕转markdown/ # Skill文件夹

        │ ├── SKILL.md # 元数据+指令

        │ └── scripts/ # 资源层（可选）

        │ └── screenshot.py # 截图脚本

        └── 来点选题/ # 另一个Skill文件夹

            └── SKILL.md

3. 编写SKILL.md（以“字幕转markdown”为例）

 markdown

---

name: 字幕转markdown笔记

description: 将srt字幕文件转换为带截图标记的markdown笔记

---

你是专业的字幕文本处理助手，任务是将srt字幕文件完整转换为Markdown笔记，要求：

1. **内容完整保留**：禁止删减、总结，必须保留所有文字。

2. **格式规范**：使用中文书体，保留必要的专有名词；每个段落用一级标题，不使用其他标题；每段内容不超过2个换行；为每句添加合适标点。

3. **截图占位标记**：当需要对某一帧画面截图时，用`Screenshot-[时戳]`格式标记，例如`Screenshot-[00:01:23]`。 

4. 测试Skill

将srt字幕文件拖入Claude Code终端，触发Skill调用。AI会先加载元数据判断是否匹配需求，确认后加载指令层完成转换，最终生成带截图标记的Markdown文件。

四、进阶：资源层与跨平台使用

1. 资源层的威力

在Skill文件夹中添加 scripts （脚本）、 references （参考文档）、 assets （资源文件）等子文件夹，可实现更复杂的功能。例如：

在“字幕转markdown”Skill中添加Python截图脚本，自动将 Screenshot-[时戳] 标记替换为实际视频截图。

2. 跨平台与社区资源

 Agent Skills是开放标准，可在Codex、Cursor等工具中通用。只需调整配置，就能将Skill从Claude Code迁移到其他工具。此外，GitHub上有大量开源Skill资源（如Awesome Claude Skills），直接拖拽即可使用。

五、与MCP的对比与协作

特性 Agent Skills MCP 

侧重点 提示词管理（渐进式披露） 工具调用（标准化工具箱） 

Token消耗 低（仅元数据常驻上下文） 高（提示词一次性加载） 

核心主体 Markdown文件 软件包（Node.js/Python） 

编写难度 低（只需写Markdown） 高（需搭建开发环境） 

 

协作场景：用Agent Skills管理提示词（定义AI“做什么”），用MCP负责具体工具调用（执行“怎么做”）。例如，在“帮我写作”Skill中，用Agent Skills定义写作风格和逻辑，再通过MCP将生成的文案自动上传到GitHub仓库。

六、总结

Agent Skills 以其低门槛、高灵活的特性，成为AI能力扩展的新范式。无论是自定义技能、复用社区资源，还是与MCP协作，它都能让你更高效地驾驭AI工具。