文章目录
- 目录
- 引言
- 一、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 这套方案也为其他大模型的定制化开发提供了参考思路——让通用模型通过模块化技能，低成本适配垂直场景，这也是未来大模型落地的核心方向之一。
