Anthropic Skills 官方仓库学习笔记

基于 github.com/anthropics/skills 官方仓库内容整理
最后更新：2026-08-17

目录

  1. 仓库概览
  2. 仓库结构
  3. 17 个官方 Skill 详解
  4. SKILL.md 格式规范
  5. 安装与使用方式
  6. 渐进式加载机制
  7. 许可证说明
  8. 开放标准与生态
  9. Partner Skills
  10. 最佳实践与注意事项
  11. 常见问题 FAQ

1. 仓库概览

Anthropic Skills 是 Anthropic 官方维护的公共仓库，用于展示和分发 Claude 的 Agent Skills 系统。该仓库包含：

  • 17 个官方 Skill 示例，覆盖文档处理、创意设计、开发工程、企业沟通四大领域
  • Agent Skills 开放标准规范（agentskills.io）
  • Skill 创建模板
  • Claude Code 插件市场配置

仓库数据（截至 2026 年 6 月）：

  • ⭐ GitHub Stars：~170k
  • 🍴 Forks：~20k
  • 📅 创建时间：2025-09-22
  • 🔄 最后更新：2026-06-09（持续活跃维护）
  • 📄 许可证：Apache 2.0（示例 Skill）/ Source-available（文档 Skill）

核心理念： Skill 是包含 SKILL.md 文件（以及可选脚本、模板、参考文档）的文件夹。Claude 会动态加载这些 Skill，以可重复的方式完成特定任务——无论是创建符合公司品牌指南的文档、分析数据，还是自动化个人任务。

2. 仓库结构

anthropics/skills/
├── skills/                    # 17 个官方 Skill 示例
│   ├── docx/                  # Word 文档处理
│   ├── pdf/                   # PDF 处理
│   ├── pptx/                  # PowerPoint 演示文稿
│   ├── xlsx/                  # Excel 电子表格
│   ├── algorithmic-art/       # 生成艺术（p5.js）
│   ├── canvas-design/         # 视觉艺术设计
│   ├── frontend-design/       # 前端设计
│   ├── slack-gif-creator/     # Slack GIF 制作
│   ├── theme-factory/         # 主题工厂
│   ├── web-artifacts-builder/ # Web 工件构建
│   ├── mcp-builder/           # MCP 服务器构建
│   ├── webapp-testing/        # Web 应用测试
│   ├── claude-api/            # Claude API 开发
│   ├── brand-guidelines/      # Anthropic 品牌规范
│   ├── internal-comms/        # 内部沟通
│   ├── doc-coauthoring/       # 文档协作
│   └── skill-creator/         # Skill 创建器
├── spec/                      # Agent Skills 开放标准规范
├── template/                  # Skill 创建模板
├── .claude-plugin/            # Claude Code 插件配置
│   └── marketplace.json       # 插件市场定义
└── README.md                  # 仓库说明

3. 17 个官方 Skill 详解

3.1 Document Skills（文档处理）

⚠️ 注意： 这 4 个 Skill 是 source-available（非开源），但 Anthropic 将其共享给开发者作为生产级复杂 Skill 的参考。它们是 Claude.ai 文档功能的底层实现。

📄 PDF — PDF 处理

属性 内容
名称 pdf
许可证 Proprietary（专有）
类型 能力增强型（Capability Uplift）
触发条件 用户提及 .pdf 文件、PDF 表单、文档提取、合并/拆分 PDF、OCR 等

核心能力：

  • 读取/提取 PDF 中的文本和表格
  • 合并多个 PDF 为一个
  • 拆分 PDF（按页提取）
  • 旋转页面
  • 添加水印
  • 创建新 PDF
  • 填写 PDF 表单（见 FORMS.md）
  • 加密/解密 PDF
  • 提取图片
  • 对扫描 PDF 进行 OCR

关键技术栈：

库/工具 用途
pypdf 基础操作（合并、拆分、旋转、加密）
pdfplumber 文本和表格提取（含布局信息）
reportlab 创建新 PDF
pytesseract + pdf2image OCR 扫描 PDF
qpdf / pdftk 命令行 PDF 操作
pdftotext (poppler-utils) 快速文本提取

关键注意事项：

  • ReportLab 下标/上标： 永远不要用 Unicode 下标字符（如 H₂O），ReportLab 内置字体不包含这些字形，会渲染为黑色方块。应使用 XML 标记：<sub> 和 <super>
  • 创建 PDF 后验证： 使用 python scripts/office/soffice.py --headless --convert-to pdf output.docx 转换为 PDF 后通过 pdftoppm 渲染为图片检查

📝 DOCX — Word 文档处理

属性 内容
名称 docx
许可证 Proprietary（专有）
类型 能力增强型
触发条件 用户提及 .docx、.dotx、Word 文档、报告、备忘录、信函等

核心能力：

  • 创建新 Word 文档（含格式、目录、表格、图片）
  • 编辑现有文档（直接操作 XML）
  • 读取/提取内容（通过 pandoc）
  • 追踪修订（tracked changes）
  • 添加批注（comments）
  • 查找替换
  • 插入/替换图片

技术栈：

工具 用途
docx (npm) 创建新文档
pandoc 读取 .docx 为 Markdown
LibreOffice (soffice) 转换 .doc → .docx、渲染验证
自定义脚本 merge_runs.py（合并碎片化 runs）、comment.py（添加批注）、accept_changes.py（接受修订）

docx-js 关键陷阱：

陷阱 正确做法
页面默认 A4 US Letter 需设置 page: { size: { width: 12240, height: 15840 } }（DXA 单位，1440 = 1英寸）
表格需双重宽度 同时设置 columnWidths 和每个 cell 的 width，都用 WidthType.DXA
表格着色 用 ShadingType.CLEAR，永远不要用 SOLID（会渲染为黑色）
列表 用 numbering 配置 LevelFormat.BULLET，不要插入 • 字面量
ImageRun 必须包含 type 字段（"png"、"jpg" 等）
PageBreak 必须放在 Paragraph 内部
换行 永远不要使用 \n，用独立的 Paragraph 元素
目录 标题必须使用内置 HeadingLevel.*；自定义样式需设置 outlineLevel
点引导线 用 PositionalTab，不要用字面量 . 或空格填充

编辑现有文档流程：

# 1. 解压
unzip -q doc.docx -d unpacked/
find unpacked -type l -delete   # 移除符号链接（安全考虑）

# 2. 合并碎片化 runs（关键步骤）
python scripts/merge_runs.py unpacked/

# 3. 编辑 word/document.xml（不要格式化/美化 XML）
# ... 编辑内容 ...

# 4. 重新打包
cd unpacked && rm -f ../out.docx && zip -Xr ../out.docx .

# 5. 验证
python scripts/office/validate.py out.docx --original doc.docx

📊 PPTX — PowerPoint 演示文稿

属性 内容
名称 pptx
许可证 Proprietary（专有）
类型 能力增强型
触发条件 用户提及 .pptx、.potx、幻灯片、演示文稿、deck、slides 等

核心能力：

  • 创建新演示文稿（含图表、图片、动画、演讲者备注）
  • 编辑现有演示文稿/模板
  • 从模板构建
  • 合并/拆分幻灯片
  • 提取内容（通过 markitdown）

技术栈：

工具 用途
pptxgenjs (npm) 创建新演示文稿
markitdown 提取文本内容
python-pptx 编辑现有文件（有限支持）
自定义脚本 thumbnail.py（幻灯片缩略图）、add_slide.py（复制幻灯片）、clean.py（清理孤儿文件）、validate.py（验证）

pptxgenjs 关键陷阱：

陷阱 正确做法
画布尺寸 默认 LAYOUT_16x9 = 10" × 5.625"，不是 13.3"。LAYOUT_WIDE 才是 13.3" × 7.5"。先设置 pres.layout 再添加幻灯片
颜色格式 永远不要 # 前缀，永远不要 8 位十六进制。用 "FF0000"。"#FF0000" 和 "00000020" 会损坏文件
透明度 用 transparency: 0-100（填充/图片）或 opacity: 0.0-1.0（阴影），两者不可混用
对象变异 pptxgenjs 会原地修改选项对象。不要在两个 add* 调用之间共享同一个 shadow/options 对象
阴影方向 offset 必须 ≥ 0。向上投射阴影用 angle: 270 + 正 offset
字间距 letterSpacing 被静默忽略，真实选项是 charSpacing
列表 每个项目设 bullet: true，不要字面量 •（会双子弹）。最后一个数组项不设 breakLine: true。用 paraSpaceAfter 控制间距，不用 lineSpacing
圆角 rectRadius 只对 ROUNDED_RECTANGLE 有效，对 RECTANGLE 无效
渐变填充 不支持。用渐变图片作为背景替代
文本框内边距 文本框有默认内边距。需要对齐时设 margin: 0
演讲者备注 用 slide.addNotes("...")，不要放在文本框里
图表 用原生 addChart()。只有 PowerPoint 不支持的图表类型（Sankey、network、chord）才用图片
组合图表 使用 secondaryValAxis/secondaryCatAxis 时，chart options 中必须同时提供 valAxes 和 catAxes，各两个条目
堆叠柱状图 dataLabelPosition 必须是 ctr、inEnd 或 inBase。outEnd 会损坏文件
图标 渲染 react-icons 为 SVG → sharp 栅格化 ≥256px → addImage({ data: "image/png;base64," + buf.toString("base64") })

设计指南：

  • 不要创建无聊的幻灯片——纯文本+白底不会给人留下印象
  • 每个幻灯片都需要视觉元素——图片、图表、图标或形状
  • 主导色占 60-70%，1-2 个辅助色，1 个强调色
  • 永远不要使用标题下的装饰线——这是 AI 生成幻灯片的标志
  • 永远不要添加装饰色条或强调条纹——包括横跨幻灯片的页眉/页脚条、垂直侧边条纹、卡片边缘的细线
  • 安全字体（QA 和 Office 都可靠）：Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook

📈 XLSX — Excel 电子表格

属性 内容
名称 xlsx
许可证 Proprietary（专有）
类型 能力增强型
触发条件 用户提及 .xlsx、.xlsm、.xltx、.csv、.tsv、电子表格、表格、数据文件等

核心能力：

  • 创建/编辑含公式和格式的电子表格
  • 批量数据导入/导出（通过 pandas）
  • 快速查看（通过 markitdown）
  • 财务模型构建
  • 数据清洗和重构

技术栈：

工具 用途
openpyxl 创建/编辑含公式和格式
pandas 批量数据读写
markitdown 快速查看内容
自定义脚本 recalc.py（强制重新计算公式）

关键要求：

  • 零公式错误：recalc.py 报告 errors_found 时绝不出货
  • 使用公式，不要硬编码结果：写 sheet['B10'] = '=SUM(B2:B9)'，不是 Python 计算的总和
  • 专业字体：默认 Arial 或 Times New Roman
  • 文档每个假设和硬编码数字

openpyxl 陷阱：

陷阱 说明
读取模型需要两次加载 data_only=True 返回缓存值但公式丢失；默认返回公式字符串但没有值。一次加载无法同时获得两者
data_only=True 保存是破坏性的 保存后所有公式被替换为字面量，永久丢失
openpyxl 刚写入的文件用 data_only=True 读取全为 None 必须先运行 recalc.py
合并单元格 只写左上角锚点，其他单元格是只读的 MergedCell
.xlsm 宏 必须传 keep_vba=True 给 load_workbook，否则宏丢失
跨表引用含空格 必须用引号：='Assumptions Inputs'!$B$5

公式兼容性（LibreOffice 限制）：

  • 优先使用 Excel 2007 时代函数：SUMIFS、INDEX、MATCH、IFERROR、SUMPRODUCT
  • 6 个后 2007 函数可用，但需 _xlfn. 前缀：_xlfn.TEXTJOIN、_xlfn.CONCAT、_xlfn.IFS、_xlfn.SWITCH、_xlfn.MAXIFS、_xlfn.MINIFS
  • 永远不要使用：XLOOKUP、XMATCH、SORT、FILTER、UNIQUE、SEQUENCE——LibreOffice 无法评估，无论加什么前缀

财务模型规范：

元素 规范
颜色 蓝色文本（0,0,255）= 硬编码输入 · 黑色 = 公式 · 绿色（0,128,0）= 跨表链接 · 红色（255,0,0）= 跨文件链接 · 黄色填充（255,255,0）= 关键假设
数字格式 货币 $#,##0 · 零渲染为 - · 负数括号 · 百分比 0.0%（存储为分数 0.15）· 估值倍数 0.0x · 年份为文本 "2024"
结构 每个假设在独立标注单元格，公式引用（=B5*(1+$B$6)，不是 =B5*1.05）· 公式跨预测期一致 · 保护可能为零的分母

3.2 Creative & Design（创意与设计）

🎨 Algorithmic Art — 生成艺术

属性 内容
名称 algorithmic-art
许可证 Apache 2.0
类型 能力增强型
触发条件 用户请求生成艺术、算法艺术、p5.js 创作等

使用 p5.js 和种子随机性创建生成艺术。适合创建独特的视觉作品、背景图案、抽象艺术等。

🖼️ Canvas Design — 视觉艺术设计

属性 内容
名称 canvas-design
许可证 Apache 2.0
类型 能力增强型
触发条件 用户需要设计 PNG 或 PDF 格式的视觉艺术作品

在 PNG 和 PDF 格式中设计视觉艺术。可用于创建海报、插图、图形设计等。

🌐 Frontend Design — 前端设计

属性 内容
名称 frontend-design
许可证 Source-available
类型 偏好编码型（Encoded Preference）
触发条件 构建新 UI 或重塑现有 UI 时的美学方向、排版和视觉设计

核心理念： 像一个小型设计工作室的设计主管一样工作——每个客户都应该得到无法被误认为是其他人的视觉识别。拒绝模板化，做出有主见的选择。

设计原则：

  1. Hero 是论点——用主题世界中最具特征的元素开场（标题、图片、动画、实时演示）
  2. 排版承载个性——刻意搭配展示字体和正文字体，设置清晰的字号层级
  3. 结构即信息——编号标记（01/02/03）只有在内容确实是序列时才合适
  4. 有目的地运用动效——编排性的时刻通常比分散的效果更有冲击力
  5. 复杂度与愿景匹配——极简方向需要精确的间距和细节
  6. 内容写作同样重要——避免模板化的文案

AI 设计三大默认陷阱（避免）：

  1. 暖奶油色背景（~#F4F1EA）+ 高对比度衬线展示字体 + 赤陶色强调
  2. 近黑背景 + 单一明亮酸绿或朱红色强调
  3. 宽幅报纸式布局 + 细线分隔 + 零圆角 + 密集报纸式栏

工作流：

  1. 头脑风暴设计计划——创建紧凑的 token 系统（颜色、字体、布局、标志性元素）
  2. 对照简报审查——如果任何部分读起来像通用默认，修改它并说明原因
  3. 编写代码——严格按照修订后的计划，每个颜色和字体决策都源自计划
  4. 自我批评——"出门前照照镜子，去掉一件配饰"（Chanel 法则）

🎬 Slack GIF Creator — Slack GIF 制作

属性 内容
名称 slack-gif-creator
许可证 Apache 2.0
类型 能力增强型
触发条件 用户需要创建针对 Slack 尺寸限制优化的动画 GIF

创建针对 Slack 尺寸约束优化的动画 GIF。适合制作表情包、演示动画、状态指示器等。

🎨 Theme Factory — 主题工厂

属性 内容
名称 theme-factory
许可证 Apache 2.0
类型 偏好编码型
触发条件 用户需要为工件应用专业主题或生成自定义主题

使用专业主题样式化工件或生成自定义主题。可用于统一视觉风格、创建品牌主题等。

🏗️ Web Artifacts Builder — Web 工件构建

属性 内容
名称 web-artifacts-builder
许可证 Apache 2.0
类型 能力增强型
触发条件 用户需要构建复杂的 claude.ai HTML 工件，使用 React 和 Tailwind

构建复杂的多组件 HTML 工件，使用 React 和 Tailwind CSS。适合创建交互式仪表板、数据可视化、复杂 UI 组件等。

3.3 Development & Technical（开发与工程）

🔌 MCP Builder — MCP 服务器构建

属性 内容
名称 mcp-builder
许可证 Source-available
类型 能力增强型
触发条件 构建 MCP 服务器以集成外部 API 或服务，支持 Python（FastMCP）或 Node/TypeScript（MCP SDK）

四阶段工作流：

Phase 1: 深度研究与规划

  • 理解现代 MCP 设计（API 覆盖 vs 工作流工具的平衡）
  • 学习 MCP 协议规范（从 modelcontextprotocol.io/sitemap.xml 开始）
  • 研究框架文档（TypeScript SDK / Python SDK）
  • 规划实现（理解 API、选择工具、设计输入/输出 schema）

Phase 2: 实现

  • 设置项目结构
  • 实现核心基础设施（API 客户端、错误处理、响应格式化、分页）
  • 实现工具（输入 schema 用 Zod/Pydantic、输出 schema 用 outputSchema/structuredContent、添加 annotations）

Phase 3: 审查与测试

  • 代码质量审查（DRY、一致错误处理、完整类型覆盖、清晰工具描述）
  • 构建和测试（TypeScript: npm run build + MCP Inspector；Python: python -m py_compile + MCP Inspector）

Phase 4: 创建评估

  • 创建 10 个复杂、现实、可验证的评估问题
  • 输出为 XML 格式 <evaluation><qa_pair><question>...</question><answer>...</answer></qa_pair></evaluation>
  • 要求：独立、只读、复杂、现实、可验证、稳定

推荐技术栈：

  • 语言：TypeScript（高质量 SDK 支持、广泛兼容性、AI 模型擅长生成）
  • 传输：远程服务器用 Streamable HTTP（无状态 JSON），本地服务器用 stdio

🧪 Webapp Testing — Web 应用测试

属性 内容
名称 webapp-testing
许可证 Source-available
类型 能力增强型
触发条件 使用 Playwright 与本地 Web 应用交互和测试

决策树：

用户任务 → 是静态 HTML?
    ├─ 是 → 直接读取 HTML 文件识别选择器
    │         ├─ 成功 → 用选择器写 Playwright 脚本
    │         └─ 失败/不完整 → 按动态处理
    └─ 否 (动态 Web 应用) → 服务器已在运行?
        ├─ 否 → 运行: python scripts/with_server.py --help
        │        然后用 helper + 简化 Playwright 脚本
        └─ 是 → 侦察-然后-行动:
            1. 导航并等待 networkidle
            2. 截图或检查 DOM
            3. 从渲染状态识别选择器
            4. 用发现的选择器执行操作

关键脚本：

脚本 功能
scripts/with_server.py 管理服务器生命周期（支持多服务器）

最佳实践：

  • 将捆绑脚本视为黑盒——先运行 --help 查看用法，直接调用，不要读取源代码（可能很大，会污染上下文窗口）
  • 动态应用检查 DOM 前必须等待 networkidle
  • 使用描述性选择器：text=、role=、CSS 选择器、ID
  • 始终关闭浏览器

🤖 Claude API — Claude API 开发

属性 内容
名称 claude-api
许可证 Apache 2.0
类型 能力增强型
触发条件 用户使用 Claude API 构建应用

提供 Claude API 的参考和最佳实践，帮助开发者构建基于 Claude API 的应用程序。

3.4 Enterprise & Communication（企业与沟通）

🎨 Brand Guidelines — Anthropic 品牌规范

属性 内容
名称 brand-guidelines
许可证 Source-available
类型 偏好编码型
触发条件 应用 Anthropic 品牌颜色、排版、视觉格式到公司工件

品牌颜色：

颜色 色值 用途
Dark #141413 主文本和深色背景
Light #faf9f5 浅色背景和深色上的文本
Mid Gray #b0aea5 次要元素
Light Gray #e8e6dc 微妙背景
Orange #d97757 主强调色
Blue #6a9bcc 次强调色
Green #788c5d 第三强调色

排版：

  • 标题：Poppins（Arial 后备）
  • 正文：Lora（Georgia 后备）

功能：

  • 智能字体应用（24pt+ 用 Poppins，正文用 Lora）
  • 基于背景的智能颜色选择
  • 非文本形状循环使用强调色

📢 Internal Comms — 内部沟通

属性 内容
名称 internal-comms
许可证 Apache 2.0
类型 偏好编码型
触发条件 撰写状态报告、新闻通讯、FAQ 等内部沟通内容

帮助撰写结构化的内部沟通文档，包括状态报告、团队新闻通讯、常见问题解答等。

📝 Doc Coauthoring — 文档协作

属性 内容
名称 doc-coauthoring
许可证 Apache 2.0
类型 偏好编码型
触发条件 用户想要撰写文档、提案、技术规格、决策文档等结构化内容

三阶段结构化工作流：

Stage 1: 上下文收集（Context Gathering）

  • 询问文档类型、受众、期望影响、模板/格式约束
  • 鼓励用户倾倒所有相关信息（项目背景、团队讨论、替代方案、组织上下文、时间线压力、技术架构、利益相关者关切）
  • 生成 5-10 个澄清问题填补信息空白
  • 退出条件：能够理解边缘情况和权衡，无需解释基础知识

Stage 2: 精炼与结构（Refinement & Structure）

  • 逐节构建文档：澄清问题 → 头脑风暴 5-20 个选项 → 用户筛选 → 差距检查 → 起草 → 迭代精炼
  • 从最多未知数的部分开始（决策文档通常是核心提案，规格文档通常是技术方案）
  • 使用 str_replace 进行所有编辑，从不重印整个文档
  • 质量检查：连续 3 次迭代无实质性变化时，询问是否可以删减

Stage 3: 读者测试（Reader Testing）

  • 有子代理时（Claude Code）：直接调用子代理测试
    1. 预测读者可能问的问题（5-10 个）
    2. 用全新 Claude 实例（无上下文泄露）测试每个问题
    3. 检查歧义、错误假设、矛盾
    4. 报告并修复问题
  • 无子代理时（Claude.ai）：指导用户手动测试
    1. 打开全新 Claude 对话
    2. 粘贴文档内容
    3. 用生成的问题测试

退出条件： Reader Claude 能一致正确回答问题，且不发现新的差距或歧义。

🛠️ Skill Creator — Skill 创建器

属性 内容
名称 skill-creator
许可证 Apache 2.0
类型 元 Skill（Meta Skill）
触发条件 用户想从零创建 Skill、编辑/优化现有 Skill、运行评估测试、基准测试性能、优化描述以提高触发准确性

Skill 创建流程：

  1. 决定 Skill 要做什么以及大致如何做
  2. 编写 Skill 草稿
  3. 创建测试提示并运行评估
  4. 帮助用户定性和定量评估结果
  5. 根据反馈重写 Skill
  6. 重复直到满意
  7. 扩展测试集并大规模重试

核心能力：

  • 确定用户在流程中的位置并帮助推进
  • 编写 Skill 草稿
  • 编写测试用例
  • 运行所有提示并收集结果
  • 使用 eval-viewer/generate_review.py 展示结果
  • 优化描述以提高触发准确性

3.5 Template（模板）

📋 Template — Skill 创建模板

属性 内容
名称 template-skill
许可证 Apache 2.0
类型 模板
用途 作为创建新 Skill 的起点

最小 SKILL.md 结构：

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

Frontmatter 必需字段：

  • name：Skill 的唯一标识符（小写，连字符代替空格）
  • description：Skill 的完整描述，包括做什么和何时使用

4. SKILL.md 格式规范

4.1 文件结构

每个 Skill 文件夹必须包含一个 SKILL.md 文件（文件名大小写敏感，必须是全大写 SKILL.md，skill.md 会导致静默失败）。

skill-name/
├── SKILL.md              # 必需：元数据和指令
├── scripts/              # 可选：辅助脚本
├── templates/            # 可选：代码/文档模板
├── references/           # 可选：参考文档
└── examples/             # 可选：示例文件

4.2 Frontmatter 字段

---
name: skill-name                    # 必需：1-64 字符，小写/数字/连字符
description: What this skill does   # 必需：1-1024 字符，触发匹配的关键
license: Apache-2.0                 # 可选：许可证
compatibility: Python 3.14+         # 可选：环境要求
metadata:                           # 可选：额外元数据
  author: Anthropic
  version: "1.0.0"
---

4.3 Markdown 内容

Frontmatter 下方是标准 Markdown，包含 Claude 激活 Skill 时遵循的指令。建议结构：

# Skill Title

## Overview
简要概述 Skill 的目的和范围。

## Process / Steps
1. 步骤一
2. 步骤二
3. 步骤三

## Conventions
- 约定一
- 约定二

## Examples
- 示例用法

## Guidelines
- 指导原则

5. 安装与使用方式

5.1 Claude Code 插件安装

注册市场：

/plugin marketplace add anthropics/skills

安装 Skill 集合：

# 文档处理技能（docx, pdf, pptx, xlsx）
/plugin install document-skills@anthropic-agent-skills

# 示例技能（所有 17 个开源示例）
/plugin install example-skills@anthropic-agent-skills

# 或直接安装单个技能
/plugin install frontend-design@anthropic-agent-skills

使用已安装的 Skill：

# 自动触发——只需自然语言描述任务
"Use the PDF skill to extract the form fields from path/to/some-file.pdf"

# 手动触发
/skill pdf extract text from report.pdf

注意： 截至 2026 年 5 月，有一个已知问题：document-skills 插件会加载仓库中所有 17 个 Skill，而不仅是 marketplace.json 中声明的 4 个文档 Skill。

5.2 手动安装

# 个人级（所有项目可用）
cp -r skills/pdf ~/.claude/skills/

# 项目级（随仓库共享）
cp -r skills/pdf .claude/skills/

热重载（Claude Code 2.1.0+）：

/reload-skills

5.3 Claude.ai 内置使用

所有示例 Skill 已内置在 Claude.ai 付费计划中。用户可以直接上传自定义 Skill 或使用内置 Skill。

5.4 Claude API 使用

通过 Skills API 端点上传预构建 Skill 或自定义 Skill。详见 Skills API Quickstart。

6. 渐进式加载机制

Skill 的核心创新是渐进式披露（Progressive Disclosure），确保上下文窗口保持精简：

阶段 加载内容 时机 大小
启动时 Frontmatter 中的 name + description 每次会话开始 ~50-100 tokens/Skill
匹配时 完整的 SKILL.md Markdown 内容 任务描述匹配时 视内容而定
执行时 引用的辅助脚本、模板文件 指令需要时 按需加载

这意味着可以安装几十个 Skill 而不会膨胀上下文窗口——Claude 只在需要时才加载完整内容。

7. 许可证说明

Skill 类别 许可证 说明
Document Skills (docx, pdf, pptx, xlsx) Source-available（非开源） 这些是 Claude.ai 文档功能的底层实现，Anthropic 共享给开发者作为生产级复杂 Skill 的参考
其他 13 个 Skill Apache 2.0 完全开源，可自由使用、修改和分发
Template Apache 2.0 开源模板
Spec 开放标准 agentskills.io

仓库根目录没有 LICENSE 文件——许可证是按文件夹的，不是整个仓库统一的。安装前务必阅读每个 Skill 文件夹中的 LICENSE.txt。

8. 开放标准与生态

8.1 Agent Skills 开放标准

Anthropic 于 2025 年 12 月 18 日 将 Skill 格式发布为开放标准（agentskills.io）。

规范治理：

8.2 跨平台兼容性

截至 2026 年 6 月，约 40 个平台支持 Agent Skills 标准：

平台 类型
Claude Code, Claude.ai, Claude API Anthropic 官方
OpenAI Codex CLI OpenAI
Gemini CLI Google
GitHub Copilot, VS Code Microsoft
Cursor, JetBrains Junie, Kiro, Trae, Roo Code 编辑器/IDE
OpenCode, Amp, Goose, OpenHands, Factory, Mistral Vibe 开源工具
Snowflake Cortex Code, Databricks Genie Code 数据平台
Pulumi Neo, Tabnine 其他平台

8.3 各平台目录约定

平台 个人级路径 项目级路径
Claude Code ~/.claude/skills/ .claude/skills/
Codex CLI ~/.codex/skills/ .codex/skills/ 或 .agents/skills/
GitHub Copilot - .github/skills/
Cursor - .cursor/skills/

9. Partner Skills

Anthropic 建立了 Partner Skills 目录，与以下厂商合作：

合作伙伴 Skill 领域
Notion Notion Skills for Claude
Atlassian 团队协作
Canva 设计工具
Cloudflare 基础设施
Figma 设计协作
Ramp 财务管理
Sentry 错误监控

10. 最佳实践与注意事项

10.1 编写 SKILL.md 的原则

✅ 好的做法 ❌ 避免的做法
描述像路由规则一样具体，包含关键词 模糊描述如 "Helps with documents"
代码做确定性工作，模型做决策 让模型做排序、解析、验证
精简 SKILL.md，详细内容放参考文件 4000 token 的巨型 SKILL.md
一个 Skill 只做一件事 一个 Skill 试图做五件事
用示例代替规则 20 条抽象约束
正文控制在 1500 词以内 冗长的散文式说明
使用明确的编号步骤 模糊的段落描述
通过相对路径引用辅助文件 内联巨大的 schema

10.2 安全注意事项

  • Skill 供应链风险：Skill 会在你的机器上执行代码。2026 年 2 月 Snyk 审计发现 36.82% 的公开 Skill 存在安全漏洞，13.4% 存在严重问题
  • 36% 的测试 Skill 存在提示注入风险
  • 审查再安装：像审查开源依赖一样审查 Skill，阅读完整的 SKILL.md 和每个捆绑脚本
  • 固定版本：通过 Git tag 或 commit SHA 安装，不要跟踪 main 分支
  • 使用可信来源：优先使用 anthropics/skills 等官方/知名仓库

10.3 已知问题

问题 状态 说明
SKILL.md 大小写敏感 已知 使用 skill.md（小写）会导致静默失败，无错误消息
document-skills 插件加载全部 Skill 已知（Issue #1087） 安装 document-skills 会加载全部 17 个 Skill，而非仅 4 个文档 Skill
不同分发路径 Schema 差异 已知 Claude Code 插件路径支持 argument-hint 等扩展字段，标准路径不支持

11. 常见问题 FAQ

Q1: 这个仓库的 Skill 和 Claude Code 内置的 Bundled Skills 有什么区别？

A: 内置 Bundled Skills（/doctor、/code-review、/verify、/run 等）是 Claude Code 自带的，无需安装。仓库中的 Skill 是可选扩展，需要通过插件市场或手动安装。

Q2: Document Skills 为什么是 source-available 而不是开源？

A: 这 4 个 Skill（docx, pdf, pptx, xlsx）是 Claude.ai 文档功能的底层生产实现。Anthropic 将其共享给开发者作为参考，但保留专有权利。其他 13 个 Skill 是 Apache 2.0 完全开源的。

Q3: 如何为团队共享自定义 Skill？

A: 将 Skill 放在项目级的 .claude/skills/ 目录中并提交到 Git。团队成员克隆仓库后即可自动使用。也可以放在 ~/.claude/skills/ 作为个人 Skill。

Q4: Skill 可以跨 AI 工具使用吗？

A: 是的。Agent Skills 是开放标准（agentskills.io），截至 2026 年中已有约 40 个平台支持，包括 Claude Code、Codex CLI、Gemini CLI、Cursor、GitHub Copilot 等。

Q5: 如何调试 Skill 不触发的问题？

A:

  1. 检查 description 是否足够具体，包含用户可能使用的关键词
  2. 确认文件名是 SKILL.md（全大写）
  3. 用 /reload-skills 确认 Skill 已被加载
  4. 尝试用不同措辞描述任务
  5. 检查是否有 disable-model-invocation: true

Q6: 如何创建自己的 Skill？

A: 三种方式：

  1. 手动：复制 template/ 文件夹，修改 SKILL.md
  2. 使用 skill-creator：安装后让 Claude 引导你完成
  3. 交互式生成器：/plugin install skill-creator 后使用

Q7: 这个仓库有多少个 Skill？

A: 仓库包含 17 个 Skill（截至 2026 年）：4 个文档 Skill + 6 个创意设计 Skill + 3 个开发工程 Skill + 3 个企业沟通 Skill + 1 个模板。

Q8: 安装 Skill 后需要重启 Claude Code 吗？

A: Claude Code 2.1.0（2026 年 1 月）起支持热重载，使用 /reload-skills 即可，无需重启会话。

Q9: 可以同时激活多个 Skill 吗？

A: 可以。Claude Code 支持多个 Skill 同时激活，Skill 是模块化设计的，可以协同工作。

Q10: 旧版的 .claude/commands/ 还能用吗？

A: 可以。.claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都会创建 /deploy 命令且行为相同。但 Skill 格式是推荐方式，支持更多功能（辅助文件、前置元数据等）。

参考资源

本文档基于 Anthropic 官方 Skills 仓库（github.com/anthropics/skills）内容整理，持续更新中。

posted @ 2026-09-15 12:46  RK5123153  阅读(61)  评论(0)    收藏  举报