Anthropic Skills 解析

基于 anthropics/skills 仓库的完整技术文档

概述

什么是 Skills？

Skills（技能） 是包含指令、脚本和资源的文件夹，Claude 可以动态加载这些内容以提升在特定任务上的表现。Skills 教会 Claude 如何以可重复的方式完成特定任务，例如：

  • 根据公司品牌指南创建文档
  • 使用组织特定工作流分析数据
  • 自动化个人任务
  • 处理各种文档格式（PDF、Word、Excel、PowerPoint）
  • 构建应用程序和测试

仓库信息

指标 数值
仓库地址 https://github.com/anthropics/skills
Stars 109K+
Forks 12K+
许可证 Apache 2.0（大多数），部分 source-available

核心价值

Skills 的设计理念是将专业化能力注入 Claude Agent，实现：

  1. 可重复性 - 确保任务执行的一致性
  2. 可扩展性 - 用户可创建自定义技能
  3. 动态加载 - 按需加载，优化上下文使用
  4. 标准化 - 遵循 Agent Skills 规范

核心概念

三级渐进式加载系统

Skills 使用三层加载机制优化上下文效率：

级别 内容 加载时机 建议大小
元数据层 name + description 启动时始终加载 ~100 tokens
指令层 SKILL.md 正文内容 Skill 触发时加载 <500 行 / ~5000 tokens
资源层 scripts/、references/、assets/ 按需加载 无限制

关键设计原则：

  • 保持 SKILL.md 在 500 行以内
  • 详细参考材料放入 references/ 目录
  • 脚本可在不加载的情况下直接执行

目录结构

skill-name/
├── SKILL.md          # 必需：元数据 + 指令
├── scripts/          # 可选：可执行代码
├── references/       # 可选：文档参考资料
├── assets/           # 可选：模板、资源文件
├── agents/           # 可选：子代理指令
└── LICENSE.txt       # 可选：许可证文件

仓库整体结构

anthropics/skills/
├── README.md         # 项目说明
├── spec/             # 规范文档（指向 agentskills.io）
├── template/         # 技能模板
│   └── SKILL.md
└── skills/           # 示例技能集合（17个技能）
    ├── algorithmic-art/
    ├── brand-guidelines/
    ├── canvas-design/
    ├── claude-api/
    ├── doc-coauthoring/
    ├── docx/
    ├── frontend-design/
    ├── internal-comms/
    ├── mcp-builder/
    ├── pdf/
    ├── pptx/
    ├── skill-creator/
    ├── slack-gif-creator/
    ├── theme-factory/
    ├── web-artifacts-builder/
    ├── webapp-testing/
    └── xlsx/

技能格式规范

SKILL.md 文件格式

每个技能必须包含一个 SKILL.md 文件，由 YAML frontmatter 和 Markdown 正文 组成。

最小示例
---
name: template-skill
description: Replace with description of the skill and when Claude should use it.
---

# Insert instructions below
完整示例
---
name: pdf-processing
description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction.
license: Apache-2.0
compatibility: Requires Python 3.14+ and uv
metadata:
  author: example-org
  version: "1.0"
allowed-tools: Bash(git:*) Bash(jq:*) Read
---

# PDF Processing Skill

## Overview
This skill provides comprehensive PDF handling capabilities...

## Process
1. Identify the PDF operation needed
2. Select appropriate tool
3. Execute and validate results

Frontmatter 字段规范

字段 必需 约束条件
name 是 最大 64 字符，仅小写字母、数字和连字符，不能以连字符开头或结尾
description 是 最大 1024 字符，描述技能功能及触发时机
license 否 许可证名称或引用捆绑的许可证文件
compatibility 否 最大 500 字符，环境需求说明
metadata 否 任意键值映射，用于额外元数据
allowed-tools 否 空格分隔的预批准工具列表（实验性）
name 字段命名规则
  • 必须 1-64 字符
  • 仅允许小写字母 (a-z)、数字和连字符 (-)
  • 不能以连字符开头或结尾
  • 不能包含连续连字符 (--)
  • 必须与父目录名称匹配

有效示例：

name: pdf-processing
name: data-analysis
name: code-review

无效示例：

name: PDF-Processing  # 不允许大写
name: -pdf            # 不能以连字符开头
name: pdf--processing # 不允许连续连字符
description 字段最佳实践

Description 是技能触发的主要机制，需要：

  1. 描述技能做什么
  2. 描述何时使用（触发条件）
  3. 包含具体关键词帮助 Agent 识别相关任务

好的示例：

description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction.

差的示例：

description: Helps with PDFs.

重要提示：当前 Claude 有"欠触发"倾向——不会在有用的时刻使用技能。为解决此问题，建议让 description 略显"主动推送"风格。

技能目录

Anthropic Skills 仓库包含 17 个专业技能，涵盖文档处理、设计创作、API 集成、测试工具等多个领域。

文档处理类

1. docx（Word 文档）

描述：创建、读取、编辑或操作 Word 文档（.docx 文件）。

触发关键词：Word doc、word document、.docx、report、memo、letter、template

核心功能：

  • 使用 docx-js 创建新文档
  • 解压 → 编辑 XML → 重新打包来编辑现有文档
  • 支持追踪更改、评论、页眉/页脚、目录等

主要工具：docx-js（创建）、pandoc（读取）、XML 编辑（修改）

2. pdf（PDF 处理）

描述：处理 PDF 文件的全方位工具。

触发关键词：.pdf file、PDF 相关操作

核心功能：

  • 读取/提取文本和表格
  • 合并/拆分 PDF
  • 旋转页面、添加水印
  • 创建新 PDF、填写 PDF 表单
  • 加密/解密、OCR 扫描 PDF
  • 提取图片

主要工具：pypdf、pdfplumber、reportlab、qpdf、pdftotext

3. pptx（PowerPoint 演示文稿）

描述：处理 PowerPoint 文件的全方位工具。

触发关键词：deck、slides、presentation、.pptx

核心功能：

  • 读取/分析内容
  • 从模板编辑
  • 从头创建

设计指南：

  • 选择大胆的、内容相关的颜色调色板
  • 每张幻灯片都需要视觉元素
  • 避免纯文本幻灯片
  • 使用有趣的字体配对

10 个预设颜色主题：Midnight Executive、Forest & Moss、Coral Energy 等

4. xlsx（Excel 电子表格）

描述：处理电子表格文件的全方位工具。

触发关键词：.xlsx、.xlsm、.csv、.tsv、spreadsheet

核心功能：

  • 打开/读取/编辑现有文件
  • 从头创建新电子表格
  • 转换表格文件格式
  • 清理混乱的表格数据

财务模型颜色编码标准：

  • 蓝色文字：硬编码输入
  • 黑色文字：公式和计算
  • 绿色文字：同工作簿内的工作表链接
  • 红色文字：外部文件链接
  • 黄色背景：需要关注的关键假设

主要工具：pandas（数据分析）、openpyxl（公式和格式化）

重要：始终使用 Excel 公式而非硬编码值

设计与艺术类

5. algorithmic-art（算法艺术）

描述：使用 p5.js 创建算法艺术，支持种子随机性和交互式参数探索。

触发关键词：generative art、algorithmic art、flow fields、particle systems、用代码创作艺术

工作流程：

  1. 创建设计哲学（.md 文件）
  2. 用 p5.js 实现生成算法

输出格式：.md（设计哲学）、.html（交互式查看器）、.js（生成算法）

6. canvas-design（画布设计）

描述：使用设计哲学创建精美的视觉艺术（PNG/PDF 格式）。

触发关键词：poster、piece of art、design、static piece、视觉设计

工作流程：

  1. 创建设计哲学（.md 文件）
  2. 在画布上表达设计（.pdf/.png 文件）

特点：90% 视觉设计 + 10% 必要文字，创建博物馆级别的作品

7. frontend-design（前端设计）

描述：创建独特的、生产级前端界面，具有高设计质量。

触发关键词：web components、landing pages、dashboards、React components、HTML/CSS layouts、styling、beautifying

设计重点：

  • 排版：选择独特有趣的字体，避免 Arial、Inter 等通用字体
  • 颜色：使用 CSS 变量保持一致性
  • 动效：使用动画和微交互
  • 空间构图：非对称、重叠、对角线流动

避免：通用 AI 美学（Inter/Roboto 字体、紫色渐变、可预测的布局）

8. theme-factory（主题工厂）

描述：为产物应用主题样式的工具包。

触发场景：为幻灯片、文档、报告、HTML 落地页等应用一致的主题

10 个预设主题：

  1. Ocean Depths - 专业平静的海洋主题
  2. Sunset Boulevard - 温暖活力的日落色彩
  3. Forest Canopy - 自然接地的大地色调
  4. Modern Minimalist - 干净当代的灰度风格
  5. Golden Hour - 丰富温暖的秋季调色板
  6. Arctic Frost - 冷酷清脆的冬季灵感主题
  7. Desert Rose - 柔和精致的尘土色调
  8. Tech Innovation - 大胆现代的科技美学
  9. Botanical Garden - 新鲜有机的花园色彩
  10. Midnight Galaxy - 戏剧性的宇宙深色调
9. brand-guidelines（品牌指南）

描述：将 Anthropic 官方品牌颜色和排版应用到任何类型的产物中。

触发关键词：branding、corporate identity、visual identity、brand colors、Anthropic brand

品牌颜色：

  • 主色：Dark #141413、Light #faf9f5
  • 强调色：Orange #d97757、Blue #6a9bcc、Green #788c5d

字体：Poppins（标题）、Lora（正文）

API 与开发类

10. claude-api（Claude API）

描述：使用 Claude API 或 Anthropic SDK 构建 LLM 应用程序。

触发条件：

  • 代码导入 anthropic、@anthropic-ai/sdk、claude_agent_sdk
  • 用户询问使用 Claude API、Anthropic SDK 或 Agent SDK

支持语言：Python、TypeScript、Java、Go、Ruby、C#、PHP、cURL

核心功能：

  • 单次 API 调用
  • 工具调用/函数调用
  • 流式响应
  • Agent SDK（内置文件/网页/终端工具）

当前模型：

模型 模型 ID 上下文窗口
Claude Opus 4.6 claude-opus-4-6 200K (1M beta)
Claude Sonnet 4.6 claude-sonnet-4-6 200K (1M beta)
Claude Haiku 4.5 claude-haiku-4-5 200K
11. mcp-builder（MCP 构建器）

描述：创建高质量的 MCP（模型上下文协议）服务器，使 LLM 能够与外部服务交互。

触发场景：构建 MCP 服务器以集成外部 API 或服务

四阶段工作流：

  1. 深入研究和规划：理解 MCP 设计、研究框架文档
  2. 实现：设置项目结构、实现核心基础设施和工具
  3. 审查和测试：代码质量检查、构建测试
  4. 创建评估：创建 10 个评估问题测试效果

推荐技术栈：

  • 语言：TypeScript（高质量 SDK 支持）
  • 传输：Streamable HTTP（远程服务器）、stdio（本地服务器）

协作与沟通类

12. doc-coauthoring（文档协作）

描述：引导用户完成结构化的文档协作工作流程。

触发关键词：write docs、draft a proposal、create a spec、PRD、design doc、decision doc、RFC

三阶段工作流：

  1. 上下文收集：用户提供相关背景信息
  2. 精炼与结构化：迭代构建每个章节
  3. 读者测试：使用新的 Claude 实例测试文档可读性

适用文档类型：技术规范、决策文档、提案、RFC 等

13. internal-comms（内部沟通）

描述：帮助编写各类内部沟通文档，使用公司常用格式。

触发关键词：status reports、leadership updates、3P updates、company newsletters、FAQs、incident reports、project updates

支持的沟通类型：

  • 3P 更新
  • 公司通讯
  • FAQ 回答
  • 状态报告
  • 领导层更新
  • 项目更新
  • 事件报告

测试与工具类

14. webapp-testing（Web 应用测试）

描述：使用 Playwright 测试本地 Web 应用的工具包。

触发场景：验证前端功能、调试 UI 行为、捕获浏览器截图、查看浏览器日志

决策树：

  • 静态 HTML？→ 直接读取 HTML 文件识别选择器
  • 动态 Web 应用？→ 使用 scripts/with_server.py 管理服务器生命周期

最佳实践：

  • 使用 sync_playwright() 编写同步脚本
  • 动态应用必须等待 networkidle 状态
  • 使用描述性选择器
15. skill-creator（技能创建器）

描述：创建新技能、修改和改进现有技能、测量技能性能。

触发场景：创建新技能、编辑现有技能、优化技能、运行评估

核心循环：

  1. 确定技能用途
  2. 起草技能
  3. 运行测试用例
  4. 与用户评估结果（定性 + 定量）
  5. 根据反馈改进
  6. 重复直到满意

媒体创建类

16. slack-gif-creator（Slack GIF 创建器）

描述：创建优化的 Slack 动画 GIF。

触发关键词：animated GIF、GIF for Slack、make me a GIF

Slack 要求：

  • Emoji GIF：128x128
  • 消息 GIF：480x480
  • FPS：10-30
  • 时长：Emoji GIF 保持在 3 秒以内

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

17. web-artifacts-builder（Web 产物构建器）

描述：使用现代前端技术创建复杂的多组件 HTML 产物。

触发场景：复杂产物需要状态管理、路由或 shadcn/ui 组件

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

工作流程：

  1. 使用 scripts/init-artifact.sh 初始化项目
  2. 开发产物
  3. 使用 scripts/bundle-artifact.sh 打包为单个 HTML 文件
  4. 展示给用户

注意：避免"AI slop" - 过度居中布局、紫色渐变、统一圆角、Inter 字体

技能分类总览

类别 技能名称
文档处理 docx、pdf、pptx、xlsx
设计与艺术 algorithmic-art、canvas-design、frontend-design、theme-factory
API 与开发 claude-api、mcp-builder
协作与沟通 doc-coauthoring、internal-comms
测试与工具 webapp-testing、skill-creator
媒体创建 slack-gif-creator、web-artifacts-builder
品牌与样式 brand-guidelines

与 Claude Code 的集成

安装方式

通过 Plugin Marketplace
# 注册插件市场
/plugin marketplace add anthropics/skills

# 安装技能包
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
本地 Skills 目录

Skills 可以放置在本地目录：

  • ~/.claude/skills/ - 全局 Skills
  • 项目内的 .claude/skills/ - 项目特定 Skills

调用方法

1. 通过 Skill 工具调用
{
  "skill": "pdf",
  "args": "-m 'Fix bug'"
}

调用方式：

  • 简短名称：skill: "pdf"
  • 完整限定名：skill: "ms-office-suite:pdf"
  • 带参数：skill: "commit", args: "-m 'Fix bug'"
2. 通过斜杠命令
/pdf
/commit -m 'Fix bug'
/review-pr 123
3. 通过关键词触发（自动触发）

Skill 的 description 字段是主要的触发机制。Claude 根据描述决定是否激活技能。

重要触发规则：

  • Claude 只在任务复杂到需要 Skill 时才会触发
  • 简单、单步查询（如"读取此 PDF"）可能不会触发 Skill
  • 复杂、多步骤、专业化查询会可靠触发

触发优化建议

为防止 Claude “under-trigger”（不触发有用的 Skill），description 应写得"pushy"：

# 弱触发（不推荐）
description: "How to build a simple fast dashboard"

# 强触发（推荐）
description: "How to build a simple fast dashboard. Make sure to use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a 'dashboard.'"

技能创建最佳实践

创建流程

1. 意图捕获 - 理解用户想要什么
2. 研究访谈 - 确认细节、边界情况
3. 编写 SKILL.md - 草稿版本
4. 测试运行 - 用真实提示词测试
5. 用户评审 - qualitative + quantitative 评估
6. 改进迭代 - 基于反馈修改
7. 重复直到满意
8. 描述优化 - 优化触发准确性
9. 打包交付 - 生成 .skill 文件

编写风格指南

核心原则
  1. 使用祈使句：指令使用命令式语气
  2. 解释重要性：解释"为什么重要"而非强制性"必须"
  3. 通用化设计：避免过于狭窄地绑定特定示例
  4. 心智理论应用：考虑模型如何理解和应用指令
输出格式定义模式
## 报告结构
始终使用此确切模板：
# [标题]
## 执行摘要
## 关键发现
## 建议
示例模式
## 提交消息格式
**示例 1：**
输入：添加用户认证和 JWT 令牌
输出：feat(auth): 实现 JWT 认证

多领域组织模式

当技能支持多个领域/框架时，按变体组织：

cloud-deploy/
├── SKILL.md (工作流 + 选择逻辑)
└── references/
    ├── aws.md
    ├── gcp.md
    └── azure.md

Claude 仅读取相关的参考文件，避免加载全部内容。

验证与测试

验证工具
skills-ref validate ./my-skill

检查 SKILL.md frontmatter 是否有效，是否遵循命名约定。

测试案例要求
  1. 独立性：不依赖其他问题
  2. 只读性：仅需非破坏性操作
  3. 复杂性：需要多次工具调用和深入探索
  4. 真实性：基于真实使用场景
  5. 可验证性：单一明确答案可验证
  6. 稳定性：答案不会随时间变化

附录

常见模式总结

模式 用途 示例
决策树 帮助选择实现路径 webapp-testing 的静态/动态判断
参考文件库 按需加载详细文档 mcp-builder 的语言指南分离
辅助脚本 复杂工作流的黑盒处理 with_server.py
示例模式 展示输入/输出格式 提交消息格式示例
渐进披露 上下文效率管理 SKILL.md < 500 行

关键建议

  1. Description 是关键：花费时间优化 description，这是触发机制的核心
  2. 保持简洁：SKILL.md 正文控制在 500 行以内
  3. 结构化组织：使用 scripts/、references/、assets/ 分离不同类型内容
  4. 编写可操作指令：使用祈使句，解释重要性而非强制
  5. 测试验证：创建测试案例并运行评估迭代
  6. 考虑用户体验：根据用户技术水平调整沟通方式

官方资源

资源 URL
Agent Skills Specification https://agentskills.io/specification
Agent Skills 文档索引 https://agentskills.io/llms.txt
Anthropic Skills GitHub https://github.com/anthropics/skills
什么是 Skills？ https://support.claude.com/en/articles/12512176-what-are-skills
如何创建自定义技能 https://support.claude.com/en/articles/12512198-creating-custom-skills
Skills API 快速入门 https://docs.claude.com/en/api/skills-guide

许可证说明

类别 许可证
大多数示例技能 Apache 2.0 开源
docx, pdf, pptx, xlsx 源码可用，非开源

文档处理技能是 Claude 文档能力的底层实现，作为复杂技能的生产级参考分享给开发者。

总结

Anthropic Skills 是一个强大的技能系统，通过标准化的格式和渐进式加载机制，使 Claude 能够动态获得专业化能力。无论是处理文档、创建设计、构建应用还是进行测试，Skills 都提供了可重复、可扩展的解决方案。

关键要点：

  • 标准化格式：SKILL.md + YAML frontmatter + Markdown 正文
  • 渐进式加载：三级加载优化上下文效率
  • 丰富的技能库：17 个专业技能覆盖多种场景
  • 灵活的集成：支持 Plugin Marketplace 和本地目录
  • 可扩展设计：用户可创建自定义技能

通过遵循最佳实践和利用现有技能作为参考，开发者可以创建高质量的技能来扩展 Claude 的能力边界。

Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

一文读懂数据标注格式：AI“学知识”的“标准答案”规范

简单来说，数据标注格式，就是给原始数据（图像、文本、音频等）添加“标签”时，遵循的统一规则和存储形式。比如给一张包含猫咪的图片标注“猫”，我们不仅要标注“这是猫”，还要明确“猫在图片的哪个位置”“标签用什么格式记录”“相关信息如何存储”——这些约定俗成的规范，就是数据标注格式。举个生活化的例子：就像老师批改作业，给学生的答案打“√”或“×”时，会统一用红色笔、写在题号旁，这就是“批改格式”；如果有

avatar AtomGit开源社区
cover

本地电脑实现：千万级CSV清理与分析AI工作流：无需代码无需SQL，对话式搞定大数据

avatar AtomGit开源社区
cover

程序员，遭遇史上最大“危机”？

avatar AtomGit开源社区