1 项目概述

Skills（技能）是由指令、脚本和资源组成的文件夹，Claude 可以动态加载它们以提高在特定任务上的表现。技能教会 Claude 如何以可重复的方式完成特定任务，无论是使用公司品牌指南创建文档、使用组织特定的工作流程分析数据，还是自动化个人任务。

可以把技能想象成 Claude 的"入职培训指南"——它们将 Claude 从通用智能体转变为具备特定领域程序性知识的专业智能体。

专业工作流程

针对特定领域的多步骤处理流程

工具集成

处理特定文件格式或 API 的指令

领域专业知识

公司特定知识、模式、业务逻辑

资源打包

脚本、参考资料和资产，用于复杂且重复的任务

2 什么是技能

技能是模块化、自包含的软件包，通过提供专业知识、工作流程和工具来扩展 Claude 的能力。它们就像特定领域或任务的"入职培训指南"——将 Claude 从通用智能体转变为配备程序性知识的专业智能体。

技能提供的能力

1

专业工作流程

针对特定领域的多步骤处理流程

2

工具集成

处理特定文件格式或 API 的指令

3

领域专业知识

公司特定知识、模式、业务逻辑

4

资源打包

脚本、参考资料和资产，用于复杂且重复的任务

渐进式披露设计

技能采用三级加载系统以高效管理上下文：

1
元数据 (~100 tokens) - 始终在上下文中
2
SKILL.md 主体 (<5000 tokens) - 技能激活时加载
3
捆绑资源 (按需) - 无限制

3 技能规范

目录结构

一个技能是一个至少包含 SKILL.md 文件的目录：

skill-name/
├── SKILL.md          # 必需
├── scripts/          # 可选 - 可执行脚本
├── references/       # 可选 - 参考文档
└── assets/           # 可选 - 静态资源

SKILL.md 格式

SKILL.md 文件必须包含 YAML 前置元数据，后跟 Markdown 内容：

---
name: skill-name
description: 技能的描述及使用场景
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

# 技能标题

[在此添加 Claude 激活此技能时将遵循的指令]

## 示例
- 示例用法 1
- 示例用法 2

## 指南
- 指南 1
- 指南 2

前置元数据字段

字段 必需 约束
name 是 最多 64 字符。仅小写字母、数字和连字符。不能以连字符开头或结尾
description 是 最多 1024 字符。描述技能的功能和使用场景
license 否 许可证名称或捆绑许可证文件的引用
compatibility 否 最多 500 字符。表示环境要求
metadata 否 用于附加元数据的任意键值映射
allowed-tools 否 预批准工具的空格分隔列表（实验性）

可选目录

scripts/

包含智能体可以运行的可执行代码。脚本应该是自包含的，或清楚地记录依赖项。支持的语言取决于智能体实现，常见选项包括 Python、Bash 和 JavaScript。

references/

包含智能体在需要时可以读取的附加文档。保持单个参考文件简洁。智能体按需加载这些文件，因此文件越小，上下文使用越少。

assets/

包含静态资源：模板（文档模板、配置模板）、图像（图表、示例）、数据文件（查找表、模式）。

4 安装使用

Claude Code

在 Claude Code 中注册此仓库作为插件市场：

/plugin marketplace add anthropics/skills

然后安装特定的技能集：

  1. 选择 Browse and install plugins
  2. 选择 anthropic-agent-skills
  3. 选择 document-skills 或 example-skills
  4. 选择 Install now

或者直接安装：

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Claude.ai

这些示例技能已经在 Claude.ai 的付费计划中可用。要使用此仓库中的任何技能或上传自定义技能，请按照官方文档中的说明操作。

Claude API

可以通过 Claude API 使用 Anthropic 的预构建技能并上传自定义技能。请参阅 Skills API 快速入门指南了解更多信息。

5 创建技能

技能创建很简单——只需一个包含 SKILL.md 文件的文件夹，其中包含 YAML 前置元数据和指令。

---
name: my-skill-name
description: 清楚描述此技能的功能和使用场景
---

# 我的技能名称

[在此添加 Claude 在此技能激活时将遵循的指令]

## 示例
- 示例用法 1
- 示例用法 2

## 指南
- 指南 1
- 指南 2

技能创建流程

1

理解技能与具体示例

通过具体示例理解技能将如何使用

2

规划可复用技能内容

确定要包含的脚本、参考资料和资产

3

初始化技能

运行 init_skill.py 创建技能模板

4

编辑技能

实现资源并编写 SKILL.md

5

打包技能

运行 package_skill.py 创建可分发的 .skill 文件

6

根据实际使用迭代

在真实任务中使用技能，发现不足并改进

核心原则：简洁为王

上下文窗口是公共资源。技能与系统提示、对话历史、其他技能的元数据共享上下文窗口。默认假设：Claude 已经非常聪明。只添加 Claude 还不知道的上下文。

6 文档技能

这些技能支持 Claude 的文档创建和编辑能力：

全面的 PDF 操作工具包，用于提取文本和表格、创建新 PDF、合并/分割文档和处理表单。

Python 库：pypdf（基本操作）、pdfplumber（文本和表格提取）、reportlab（创建 PDF）

命令行工具：pdftotext、qpdf、pdftk

全面的文档创建、编辑和分析，支持修订跟踪、批注、格式保留和文本提取。

创建新文档：使用 docx-js（JavaScript/TypeScript）

编辑现有文档：使用 Document 库（Python OOXML 操作）

修订工作流：支持专业文档审阅的修订跟踪

演示文稿创建、编辑和分析。支持布局、批注、演讲者备注等。

无模板创建：使用 html2pptx 工作流将 HTML 幻灯片转换为 PowerPoint

使用模板创建：分析模板、重排幻灯片、替换占位符内容

设计原则：18 种配色方案、丰富的视觉细节选项

全面的电子表格创建、编辑和分析，支持公式、格式、数据分析和可视化。

关键要求：零公式错误、保留现有模板格式

财务模型标准：颜色编码（蓝色=输入，黑色=公式，绿色=内部链接，红色=外部链接）

始终使用公式：不要硬编码计算值，让 Excel 计算

7 创意设计技能

创建独特、生产级的前端界面，具有高设计质量，避免通用"AI 风格"美学。

设计思考：理解目的、选择极端的美学方向、考虑技术约束

关键要点：独特字体、大胆配色、动效微交互、不对称布局、背景纹理

避免：Inter/Roboto/Arial 字体、紫色渐变白色背景、可预测的布局

使用 p5.js 创建算法艺术，具有种子随机性和交互式参数探索。

两步流程：1) 创建算法哲学 (.md)，2) 通过 p5.js 生成艺术表达 (.html + .js)

算法表达：流场、粒子系统、噪声函数、涌现行为

交互功能：种子导航、参数控制、实时预览

使用设计哲学在 .png 和 .pdf 文档中创建美丽的视觉艺术。

流程：1) 设计哲学创建，2) 画布表达

哲学示例：混凝土诗歌、色彩语言、模拟冥想、有机系统、几何沉默

质量要求：博物馆或杂志级别，精心打磨每个细节

使用主题为工件添加样式的工具包。这些工件可以是幻灯片、文档、报告、HTML 落地页等。

10 个预设主题：Ocean Depths、Sunset Boulevard、Forest Canopy、Modern Minimalist、Golden Hour、Arctic Frost、Desert Rose、Tech Innovation、Botanical Garden、Midnight Galaxy

自定义主题：可以根据需求即时生成新主题

创建针对 Slack 优化的动画 GIF 的工具包。

Slack 要求：表情 GIF 128x128，消息 GIF 480x480

动画概念：抖动/振动、脉冲/心跳、弹跳、旋转、淡入淡出、滑动、缩放、爆炸/粒子爆发

可用工具：GIFBuilder、验证器、缓动函数、帧辅助函数

8 开发技术技能

创建高质量 MCP（Model Context Protocol）服务器的指南，使 LLM 能够通过精心设计的工具与外部服务交互。

四阶段流程：深度研究和规划 → 实现 → 审查和测试 → 创建评估

推荐技术栈：TypeScript + 可流式 HTTP

工具设计原则：清晰的命名、简洁的描述、可操作的错误消息、分页支持

使用 Playwright 与本地 Web 应用程序交互和测试的工具包。

决策树：静态 HTML → 直接读取 | 动态应用 → 使用 with_server.py

侦察后行动模式：导航并等待 networkidle → 截图或检查 DOM → 识别选择器 → 执行操作

最佳实践：使用 sync_playwright()，始终关闭浏览器，使用描述性选择器

使用现代前端 Web 技术创建精美的多组件 claude.ai HTML artifacts 的工具套件。

技术栈：React 18 + TypeScript + Vite + Parcel + Tailwind CSS + shadcn/ui

工作流程：初始化项目 → 开发 → 打包为单个 HTML 文件 → 展示给用户

设计指南：避免过度居中布局、紫色渐变、统一圆角和 Inter 字体

创建有效技能的指南。当用户想要创建新技能或更新现有技能时使用此技能。

核心原则：简洁为王、设置适当的自由度、渐进式披露

技能结构：SKILL.md（必需）+ scripts/（可选）+ references/（可选）+ assets/（可选）

不要包含：README.md、INSTALLATION_GUIDE.md、CHANGELOG.md 等额外文档

9 企业沟通技能

帮助编写各种内部沟通的资源集，使用公司喜欢的格式。

支持的类型：3P 更新（进展/计划/问题）、公司简报、FAQ 回复、状态报告、领导层更新、项目更新、事故报告

使用方法：识别沟通类型 → 加载相应指南文件 → 遵循特定指令

通过结构化工作流程引导用户协作撰写文档。用于编写文档、提案、技术规格或决策文档。

三个阶段：

  • 上下文收集：用户提供所有相关上下文，Claude 询问澄清问题
  • 精炼和结构化：通过头脑风暴和编辑迭代构建每个部分
  • 读者测试：用全新的 Claude（无上下文）测试文档以发现盲点

将 Anthropic 的官方品牌颜色和排版应用于任何可能受益于 Anthropic 外观的工件。

主要颜色：Dark #141413、Light #faf9f5、Mid Gray #b0aea5、Light Gray #e8e6dc

强调颜色：Orange #d97757、Blue #6a9bcc、Green #788c5d

排版：标题 Poppins、正文 Lora

10 最佳实践

简洁为王

上下文窗口是公共资源。默认假设 Claude 已经非常聪明，只添加 Claude 还不知道的上下文。优先使用简洁的示例而不是冗长的解释。

设置适当的自由度

根据任务的脆弱性和可变性匹配具体程度：

  • 高自由度：当多种方法有效，决策取决于上下文
  • 中等自由度：当存在首选模式，但允许一些变化
  • 低自由度：当操作脆弱易出错，一致性至关重要

渐进式披露

将 SKILL.md 主体保持在 500 行以内。当接近此限制时，将内容拆分到单独的文件中。当拆分内容时，从 SKILL.md 引用它们并清楚地描述何时读取它们。

编写有效的描述

description 字段是技能的主要触发机制。应该包括：

  • 技能的功能
  • 何时使用的具体触发条件/上下文
  • 帮助智能体识别相关任务的特定关键词

避免深层嵌套引用

保持引用从 SKILL.md 开始只有一层深度。所有参考文件应直接从 SKILL.md 链接。对于超过 100 行的较长参考文件，在顶部包含目录。

免责声明

这些技能仅供演示和教育目的。虽然这些功能中的一些可能在 Claude 中可用，但您从 Claude 获得的实现和行为可能与这些技能中显示的不同。在依赖它们执行关键任务之前，请在您自己的环境中彻底测试技能。