文章目录
- 目录
- 引言
- 一、Claude Skills 核心概念
- 二、Anthropic Skills 仓库核心信息
- 2.1 仓库定位与许可证说明
- 2.2 仓库核心目录与分类
- 三、Claude Skill 的核心架构(必学)
- 3.1 必选文件:SKILL.md
- (1)YAML 前置元数据(关键)
- (2)Markdown 主体
- 3.2 可选资源(Bundled Resources)
- 关键最佳实践(来自仓库 `skill-creator`):
- 3.3 渐进式披露设计原则(核心优化思路)
- 四、如何使用仓库中的技能?
- 4.1 Claude.ai(付费计划)
- 4.2 Claude Code(插件形式)
- 4.3 Claude API
- 五、从零创建自定义 Skill(基于仓库模板)
- 步骤1:初始化技能目录
- 步骤2:编写 SKILL.md
- 步骤3:补充可选资源(如需)
- 步骤4:测试与迭代
- 六、总结与展望
目录
引言
若对您有帮助的话,请点赞收藏加关注哦,您的关注是我持续创作的动力!
随着大模型应用的深化,通用大模型在垂直场景下的“定制化”需求愈发强烈。Anthropic 作为 Claude 大模型的研发方,推出了Skills(技能)系统——这是一套能让 Claude 动态加载指令、脚本和资源,从而提升特定任务表现的模块化方案。而 anthropics/skills 仓库则是 Anthropic 官方开源的技能示例集合,涵盖从创意设计到企业级文档处理的全场景技能模板。本文将深度解析该仓库的核心内容、技能架构设计,以及如何基于仓库快速构建自定义技能。
一、Claude Skills 核心概念
在解析仓库前,先明确「Claude Skills」的本质:
Skills 是包含指令、脚本、资源的文件夹,Claude 可动态加载这些内容,将自身从“通用大模型”转化为“垂直领域专家”。其核心价值在于:
- 让 Claude 掌握可重复执行的特定任务流程(如企业品牌规范落地、PDF 结构化解析);
- 封装领域知识、API 文档、公司流程等私有/专属信息;
- 支持工具集成、文件格式处理等复杂场景的标准化执行。
仓库中对 Skills 的定位是:“给 Claude 的专属入职指南”,通过标准化的文件结构,让模型稳定复现特定任务的执行能力。
二、Anthropic Skills 仓库核心信息
2.1 仓库定位与许可证说明
该仓库是 Claude Skills 的官方示例集合,核心属性如下:
- 示例覆盖范围:从创意类(算法艺术、GIF 制作)、技术类(MCP 服务器开发、Web 应用测试)到企业级(品牌规范、内部沟通文案)、文档处理类(Word/Excel/PDF 全生命周期操作);
- 许可证:
- 普通示例技能遵循 Apache 2.0 开源协议;
document-skills/目录下的文档处理技能为“源码可用(source-available)”,非开源(但可作为开发参考);
- 重要声明:所有示例仅用于演示和学习,Claude 生产环境中的技能表现可能与示例存在差异,正式使用前需充分测试。
2.2 仓库核心目录与分类
仓库的技能示例按场景分为五大类,覆盖绝大多数开发者/企业的定制化需求:
| 技能分类 | 典型示例 | 核心能力 |
|---|---|---|
| 元技能(Meta Skills) | skill-creator、template-skill | 技能创建指南、基础技能模板(入门必备) |
| 创意与设计 | algorithmic-art、canvas-design | p5.js 生成艺术、多格式视觉设计、Slack 专属 GIF 制作 |
| 开发与技术 | artifacts-builder、mcp-server、webapp-testing | React/Tailwind 构建 HTML 工件、MCP 服务器开发、Playwright 测试 Web 应用 |
| 企业与通信 | brand-guidelines、internal-comms | 品牌规范落地、内部沟通文案(周报/FAQ)、专业主题生成 |
| 文档技能 | docx、pdf、pptx、xlsx | 文档创建/编辑/解析(支持修订记录、公式、表单等复杂场景) |
三、Claude Skill 的核心架构(必学)
一个完整的 Skill 由必选核心文件和可选资源构成,仓库中skill-creator技能详细定义了其标准结构,也是我们自定义技能的核心参考。
3.1 必选文件:SKILL.md
这是 Skill 的入口文件,也是唯一强制要求的文件,结构分为两部分:
(1)YAML 前置元数据(关键)
元数据决定了 Claude何时触发该技能,仅包含两个必填字段:
--- name: my-custom-skill # 唯一标识,小写+连字符命名 description: 清晰描述技能用途和触发场景(例:处理Excel文件的公式计算与数据可视化,适用于用户要求分析表格数据时) ---⚠️ 核心原则:description要精准——Claude 会基于该字段判断是否启用技能,建议用第三人称表述(如“该技能用于XXX场景”)。
(2)Markdown 主体
包含技能的执行指令、示例、指南,仅在技能触发后加载。核心写作规范:
- 使用命令式/不定式(动词开头),而非第二人称(如“要完成X,执行Y”而非“你应该做X”);
- 仅保留核心流程,详细参考内容拆分到
references/目录(避免上下文冗余)。
3.2 可选资源(Bundled Resources)
复杂技能可扩展三类资源,均放在 Skill 目录下:
my-custom-skill/ ├── SKILL.md # 必选 ├── scripts/ # 可执行脚本(Python/Bash等,例:rotate_pdf.py处理PDF旋转) ├── references/ # 按需加载的参考文档(API文档、数据库schema、公司政策等) └── assets/ # 输出用资源(模板、图标、字体等,例:HTML工件模板)关键最佳实践(来自仓库skill-creator):
references/用于存放大文件(>10k字),需添加 grep 搜索模式,避免全量加载;- 信息不重复:SKILL.md 仅保留核心流程,详细内容放
references/; - 避免深层嵌套:参考文件仅一级目录,所有文件直接从 SKILL.md 链接。
3.3 渐进式披露设计原则(核心优化思路)
仓库强调 Skills 需遵循“渐进式披露”,目的是最小化上下文占用,分为三级加载:
- 元数据(name+description):始终在上下文(约100词);
- SKILL.md 主体:技能触发后加载(<5k词);
- 捆绑资源:Claude 按需加载(无字数限制,脚本可直接执行无需加载全文)。
典型拆分示例(如多云部署技能):
cloud-deploy/ ├── SKILL.md # 核心流程+云厂商选择逻辑 └── references/ ├── aws.md # AWS部署细节(仅用户选AWS时加载) ├── gcp.md # GCP部署细节 └── azure.md # Azure部署细节四、如何使用仓库中的技能?
仓库提供三种使用方式,覆盖 Claude 全平台:
4.1 Claude.ai(付费计划)
仓库中的示例技能已内置到 Claude.ai 付费版,自定义技能上传流程参考官方文档:Using skills in Claude。
4.2 Claude Code(插件形式)
- 注册插件市场:
/plugin marketplace add anthropics/skills - 安装指定技能(如文档技能):
/plugin install document-skills@anthropic-agent-skills - 使用:直接在对话中提及技能名,例:“使用PDF技能提取xxx.pdf中的表单字段”。
4.3 Claude API
通过 API 调用预置技能或上传自定义技能,参考官方文档:Skills API Quickstart。
五、从零创建自定义 Skill(基于仓库模板)
仓库提供template-skill作为入门模板,核心步骤如下:
步骤1:初始化技能目录
基于template-skill复制,目录结构:
my-skill/ └── SKILL.md步骤2:编写 SKILL.md
填充元数据和主体,基础模板:
--- name: excel-data-analysis description: 分析Excel表格数据,支持公式计算、数据可视化和异常值检测,适用于用户要求处理.xlsx文件时 --- # Excel 数据分析技能 ## 核心流程 1. 提取Excel文件中的数据,识别表头和数据类型; 2. 根据用户需求执行公式计算(求和/平均值/方差等); 3. 生成可视化图表(柱状图/折线图); 4. 检测异常值并标注原因。 ## 参考资源 - 公式规范:见 [references/formulas.md](references/formulas.md) - 可视化模板:见 [assets/chart-template.html](assets/chart-template.html)步骤3:补充可选资源(如需)
scripts/:添加excel_analysis.py脚本封装计算逻辑;references/:添加formulas.md记录Excel公式规范;assets/:添加可视化模板文件。
步骤4:测试与迭代
在 Claude 中测试技能触发逻辑和执行效果,重点验证:
description是否精准触发;- 参考资源是否按需加载;
- 执行流程是否无冗余。
六、总结与展望
Anthropic Skills 仓库的核心价值,是为开发者提供了一套标准化、可复用的 Claude 定制化方案——从技能架构设计(SKILL.md 规范)到工程实践(渐进式披露、资源拆分),均给出了可落地的参考。
对于开发者/企业而言:
- 入门:基于
template-skill和skill-creator快速搭建基础技能; - 进阶:参考
document-skills学习复杂文件处理、二进制数据交互; - 落地:结合企业私有知识(如API文档、品牌规范),打造专属技能库。
随着大模型“插件化/技能化”成为趋势,Anthropic 这套方案也为其他大模型的定制化开发提供了参考思路——让通用模型通过模块化技能,低成本适配垂直场景,这也是未来大模型落地的核心方向之一。