Claude Code Skills

姝然_9527
242 阅读16分钟

Claude Code Skills 项目文档

本文档是对 Anthropic 官方 Skills 示例集合的详细中文介绍和使用指南 github.com/anthropics/…

项目简介

skills 项目是 Anthropic 官方的 Claude Agent Skills 示例集合，展示了如何用「Skill（技能）」给 Claude 注入可复用的专业能力，包括：

  • 创意与设计：生成算法艺术、平面海报、前端界面等
  • 文档与文件处理：批量、可编程地处理 DOCX / PPTX / PDF / XLSX
  • 企业与协作工作流：文档共创、内部沟通模板、品牌规范等
  • 开发与集成：MCP Server 构建指南、高级 Web 前端 Artifact 构建与 Web 应用测试等

每个 Skill 都是一个独立文件夹，核心是 SKILL.md：里面有 YAML 元数据 + 操作说明，Claude 加载后就能按其中的流程和约束来工作。

仓库结构概览

skills/
├── skills/                    # 所有具体技能
│   ├── algorithmic-art/       # 算法艺术（p5.js 生成艺术）
│   ├── brand-guidelines/      # Anthropic 品牌规范应用
│   ├── canvas-design/         # 高水准平面视觉作品（PDF/PNG）
│   ├── doc-coauthoring/       # 文档共创工作流
│   ├── docx/                  # Word（DOCX）创建、编辑、红线审阅
│   ├── frontend-design/       # 高质量前端 UI/页面设计与实现
│   ├── internal-comms/        # 公司内部沟通写作模板
│   ├── mcp-builder/           # MCP Server 构建指南
│   ├── pdf/                   # PDF 读取、合并、表格抽取、表单填充等
│   ├── pptx/                  # PPT 创建、模板复用、文字批量替换
│   ├── skill-creator/         # 如何设计和编写一个高质量 Skill
│   ├── slack-gif-creator/     # 为 Slack 优化的 GIF 动图生成
│   ├── theme-factory/         # 统一主题（字体/配色）应用到各类制品
│   ├── web-artifacts-builder/ # 构建复杂 React + Tailwind + shadcn UI 的 HTML Artifact
│   ├── webapp-testing/        # 用 Playwright 测试 Web 应用
│   └── xlsx/                  # Excel 工作簿的创建、编辑、财务模型规范等
├── spec/                      # Agent Skills 规范
│   └── agent-skills-spec.md   # 规范文档（详见 https://agentskills.io/specification）
├── template/                  # 创建自定义 Skill 的最小模版
│   └── SKILL.md
└── README.md                   # 英文总览与在 Claude 中安装使用说明

在 Claude 中如何使用这些 Skills

你可以把整个仓库当作一个「插件集合」：

在 Claude Code 中

  1. 注册为插件市场源：

    /plugin marketplace add anthropics/skills

  2. 安装示例/文档技能集：

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

  3. 使用技能： 安装后，只要在对话中提到「用 PDF skill…」「用 DOCX skill…」等，Claude 就会按相应技能的流程操作文件。

在 Claude.ai / API 中

  • Claude.ai 的付费计划内置了这些示例技能，也支持上传自定义 .skill 包。
  • API 通过 Skills API 绑定、上传自定义技能（详见官方文档中的 Skills API 指南）。

各 Skill 详解

algorithmic-art（算法艺术）

作用与用途：

  • 使用 p5.js + 种子随机数 创作原创生成艺术（flow field、粒子系统等），并输出可交互的 HTML Artifact。
  • 先写一份「算法美学哲学（Algorithmic Philosophy）」，再用代码把这个哲学转译为算法。

核心能力：

  • 输出：
    • .md：生成艺术流派的哲学宣言（算法思想、粒子/噪声/力场等）
    • 单文件 .html：基于模板 templates/viewer.html 的交互页面，内嵌 p5.js、参数滑条、seed 控制、重置/下载等。
  • 强制使用种子随机：randomSeed(seed) / noiseSeed(seed)，保证同一 seed 可复现。
  • 保持模板 UI/品牌不变，仅替换算法与参数控制部分。

使用示例：

  • 「用 algorithmic-art skill，基于'量子和声'这个概念，为我设计一套生成艺术并给我一个可交互 HTML。」
  • 「请用 algorithmic-art skill，生成一个可调参数的流场艺术，要求可通过 seed 探索不同变体。」

brand-guidelines（Anthropic 品牌规范）

作用与用途：

  • 把 Anthropic 官方品牌颜色与字体体系 应用于 PPT、文档、网页等制品，让内容具有统一的品牌识别度。

核心能力：

  • 颜色：
    • 主色：深色 #141413、浅色 #faf9f5、中灰 #b0aea5、浅灰 #e8e6dc
    • 点缀：橙 #d97757、蓝 #6a9bcc、绿 #788c5d
  • 字体：
    • 标题：Poppins（fallback: Arial）
    • 正文：Lora（fallback: Georgia）
  • 可在 PPTX（配合 pptx skill）、网页（配合 frontend-design）中，有意识地选用上述色彩及字体组合。

使用示例：

  • 「请把这份 PPT 统一改成 Anthropic 的品牌视觉（颜色、字体等），用 brand-guidelines skill。」

canvas-design（静态平面设计 / 海报）

作用与用途：

  • 针对「静态、单页（或少页）视觉作品」：海报、杂志页、艺术印刷品等，生成高水准 PDF/PNG。

核心能力：

  • 两阶段：
    1. 设计哲学（Design Philosophy，输出 .md）
      • 命名设计流派（如 "Geometric Silence / Brutalist Joy"），用 4–6 段描述空间、形态、色彩、层级、秩序等。
    2. 画布实现（Canvas Creation，输出 .pdf 或 .png）
      • 严格控制留白、图形、色彩与少量文字，将哲学转化为画面。
  • 文本是「视觉元素」，而非主体内容：只用作 labels 或短语。
  • 强调「看起来像是人类顶级设计师花了很久时间打磨」的工艺感，使用 canvas-fonts/ 中的多款专业字体。

使用示例：

  • 「用 canvas-design skill 帮我做一张 A3 海报，主题是'城市噪音与宁静'，输出设计哲学 + PDF。」

doc-coauthoring（文档共创工作流）

作用与用途：

  • 协作编写 结构化文档：技术设计文档、决策记录、PRD、提案、RFC 等，通过系统化流程而非一次性大段生成。

工作流结构：

  1. Context Gathering（上下文收集）：
    • 问清文档类型、读者、目标效果、有无模板；
    • 鼓励用户信息倾倒（背景、限制、利益相关者等）；
    • Claude 用 5–10 个澄清问题补齐上下文。
  2. Refinement & Structure（结构与精修）：
    • 先确定整体结构，再逐节细化：问需求 → 头脑风暴要点 → 用户筛选 → 起草 → 微调。
  3. Reader Testing（读者视角测试）：
    • 用「新 Claude」模拟读者，提出问题评估文档是否清晰、自洽和完整；
    • 如有问题，再返回第二阶段修改。

使用示例：

  • 「我想写一个微服务系统设计文档，请用 doc-coauthoring skill 按阶段带着我一起写。」

docx（Word 文档技能）

作用与用途：

  • .docx 的 创建、编辑、红线审阅、批注、格式保持、文本抽取。

核心能力：

  • 新建文档（docx-js）：
    • 使用 docx JS/TS 库，通过 Document/Paragraph/TextRun 创建结构化 Word 文档；
    • 通过 Packer.toBuffer() 导出 .docx。
  • 编辑现有文档（OOXML + Python Document library）：
    • 把 .docx 当作压缩包，读取/修改 XML：
      • word/document.xml、word/comments.xml、word/media/ 等；
      • 插入 <w:ins> / <w:del> 标记实现红线。
    • 使用 ooxml/scripts/unpack.py / pack.py 解包、打包。
  • 红线（Redlining）工作流：
    • 先用 pandoc --track-changes=all 转成 markdown；
    • 将所有改动按批次规划，再在 XML 中精确标注变化片段；
    • 最后用 pandoc 和 grep 检查改动是否完全落地。

使用示例：

  • 「用 docx skill 为我新建一份项目投标书模版，分章节、带占位符。」
  • 「请用红线工作流对这份合同比较版本，改动全部以 tracked changes 展示。」

frontend-design（前端界面与组件设计）

作用与用途：

  • 输出 高设计水准、可上线的前端界面：网站、Dashboard、Landing Page、组件库 Demo 等。

核心能力：

  • 从设计思维开始：
    • 明确目的与目标用户；
    • 选定强烈的视觉风格（极简、残酷主义、复古未来、杂志排版等）；
    • 决定字体搭配（避免 Arial/Inter 等俗套选择）、色板、动效策略、空间布局。
  • 输出：
    • 完整的 HTML/CSS/JS 或 React/Vue 组件代码；
    • 使用 CSS 变量和系统化样式；
    • 兼顾可访问性和生产环境可用性。

使用示例：

  • 「用 frontend-design skill 帮我设计并实现一个 SaaS 仪表盘首页，用 React + Tailwind，风格偏 editorial 杂志排版。」

internal-comms（公司内部沟通）

作用与用途：

  • 快速生成各种 内部沟通文案，结构规范、语气得体：

覆盖类型：

  • 3P 更新（Progress, Plans, Problems）
  • 公司 Newsletter
  • FAQ 答复
  • 项目周报 / 状态更新
  • 领导层更新邮件
  • 事件 / 故障通报等

实现方式：

  • 基于 examples/ 中模板/示例：
    • 3p-updates.md
    • company-newsletter.md
    • faq-answers.md
    • general-comms.md
  • 引导你提供必要信息（对象、关键信息、时间线），再按模板生成文案。

使用示例：

  • 「用 internal-comms skill 帮我写一封面向全公司的季度 3P 更新邮件。」

mcp-builder（MCP Server 构建指南）

作用与用途：

  • 帮助你编写高质量的 MCP（Model Context Protocol）服务器，让 Claude 能以安全、有结构的方式访问外部服务/API。

核心能力：

  • 四个阶段：
    1. 调研与规划：理解 MCP 协议、API 覆盖 vs 工作流工具、错误信息设计。
    2. 实现：使用 TypeScript（推荐）或 Python 搭建 server，封装 API 客户端、错误处理、分页等。
    3. Review & 测试：代码质量检查、类型完整性、用 MCP Inspector 手动/自动测试。
    4. 评估（Evaluation）：设计 10 个复杂的、可验证的问题，写成 XML 用于自动评估。
  • 附带多份参考文档：最佳实践、TS/Python 实现指南、评估指南。

使用示例：

  • 「我想写一个 Jira MCP server，请用 mcp-builder skill 帮我从工具列表、输入输出 schema 到 TS 代码一步步规划。」

pdf（PDF 处理）

作用与用途：

  • 程序化处理 PDF：文本/表格抽取、合并拆分、旋转、加水印、加密/解密、OCR 以及表单填充。

核心能力：

  • Python 库：
    • pypdf：读取/写入/合并/拆分/旋转/修改元数据/加密/加水印。
    • pdfplumber：高质量文本抽取、表格提取，可转为 pandas DataFrame。
    • reportlab：从零生成带文本和图形的 PDF 报告。
  • 命令行工具：
    • pdftotext：快速抽取文本；
    • qpdf、pdftk：合并拆分、旋转、解密等；
    • OCR：pdf2image + pytesseract 组合。
  • 特殊需求（表单）：详见同目录下 forms.md。

使用示例：

  • 「用 pdf skill 帮我从这份 PDF 抽出所有表格并导出为 Excel。」
  • 「合并这 5 份 PDF 成一个文件，顺序不变，并在每页右下角加水印。」

pptx（PPT 技能）

作用与用途：

  • 管理 .pptx 演示文稿的 创建、编辑、基于模板的重排、批量文本替换、缩略图生成。

核心能力：

  • 从 HTML 新建 PPT（html2pptx）
    • 用 HTML + CSS 描述每一页布局；
    • 使用 scripts/html2pptx.js 将 HTML 渲染为 PPT（基于 pptxgenjs + Playwright）；
    • 详见 html2pptx.md。
  • 基于模板生成新 deck
    • 用 scripts/thumbnail.py 生成模板缩略图，分析布局；
    • 用 scripts/rearrange.py 选择/复制/重排幻灯片；
    • 用 scripts/inventory.py 导出所有文字位置和格式；
    • 用 replacement-text.json + scripts/replace.py 批量、安全、带格式地替换文字。
  • 原始 OOXML 编辑
    • 通过 ooxml/scripts/unpack.py / validate.py / pack.py，直接修改 XML。

使用示例：

  • 「用 pptx skill + html2pptx 帮我从这组 HTML 文件生成一个 10 页路演 PPT。」
  • 「基于这份模板 PPT，选出 5 页适合我内容的布局，复制并替换成我的文字。」

skill-creator（Skill 创建指南）

作用与用途：

  • 系统性指导你 从零设计并打包一个新的 Skill，或迭代已有 Skill。

核心能力：

  • 解释 Skill 的结构与原则：
    • SKILL.md 前置 YAML 中的 name/description 决定触发逻辑；
    • scripts/ 做确定性的重复任务；
    • references/ 存放大体量、按需加载的文档；
    • assets/ 存放模板、图标、字体等输出资源。
  • 完整流程：
    1. 通过具体使用场景理解 skill 的边界和职责；
    2. 规划可复用的脚本、参考文档和资源；
    3. 用 scripts/init_skill.py 初始化目录；
    4. 编写 SKILL.md 和资源文件；
    5. 用 scripts/package_skill.py 验证并打包；
    6. 依据实际使用情况迭代改进。

使用示例：

  • 「我要做一个公司内部数据仓库 BI 查询 skill，请用 skill-creator skill 帮我定义 SKILL.md、目录结构和脚本清单。」

slack-gif-creator（Slack GIF 动图）

作用与用途：

  • 通过 Python + PIL 生成适配 Slack 的 GIF 动图（表情和消息 GIF）。

核心能力：

  • Slack 约束：
    • Emoji：建议 128×128，时长 < 3s；
    • 消息 GIF：如 480×480；
    • 帧率 10–30，颜色 48–128。
  • 工具：
    • GIFBuilder：添加帧、优化颜色、去重、保存；
    • validators：检查 GIF 尺寸、帧数、文件大小是否符合 Slack 要求；
    • easing：多种缓动函数，制作顺滑动画；
    • frame_composer：创建底色、渐变背景、圆形/星形、文字等基础图形。
  • 强调美术质量：较粗线条、渐变、组合形状与配色对比，而不是简陋占位框。

使用示例：

  • 「用 slack-gif-creator skill 帮我写段 Python 代码，做一个循环鼓掌的 128×128 表情 GIF，颜色活泼，适合 Slack。」

theme-factory（主题工厂）

作用与用途：

  • 提供 10 套预设颜色+字体主题，可应用于 PPT、文档、报告、网页等；也能按需求生成定制主题。

核心能力：

  • 预设主题：
    • Ocean Depths / Sunset Boulevard / Forest Canopy / Modern Minimalist / Golden Hour / Arctic Frost / Desert Rose / Tech Innovation / Botanical Garden / Midnight Galaxy
  • 每个主题在 themes/ 中有详细说明，包括色板 HEX、标题/正文字体搭配。

典型流程：

  1. 展示 theme-showcase.pdf 给用户（只展示，不修改）。
  2. 让用户选定某个主题或描述偏好。
  3. 读取对应主题文件，将主题的颜色和字体应用到目标 Artifact。
  4. 如预设主题都不合适，则生成自定义主题文件并再次应用。

使用示例：

  • 「用 theme-factory skill，把这套 PPT 应用'Tech Innovation'主题（颜色+字体）。」

web-artifacts-builder（复杂 Web Artifact 构建）

作用与用途：

  • 当你需要的是 复杂、多组件、多路由、带状态管理的前端 Artifact（而非简单单页 HTML）时使用，用于在 Claude 中嵌入一个完整的小 Web App。

核心能力：

  • 技术栈：
    • React 18 + TypeScript + Vite
    • Tailwind CSS + shadcn/ui
    • Parcel + html-inline 打成单一 bundle.html
  • 流程：
    1. bash scripts/init-artifact.sh <project-name> 初始化项目；
    2. 在项目中按需开发组件、路由、状态逻辑；
    3. bash scripts/bundle-artifact.sh 打包成 bundle.html；
    4. 在 Claude 中展示该 HTML Artifact。
  • 设计提醒：刻意避免「AI slop」风格（中心卡片 + 紫色渐变 + Inter + 统一圆角）。

使用示例：

  • 「用 web-artifacts-builder skill 帮我搭一个任务管理小应用，有列表/详情/筛选，以 artifact 形式嵌入 Claude。」

webapp-testing（Web 应用测试）

作用与用途：

  • 用 Playwright + Python 自动化测试本地 Web 应用，包括验证前端流程、抓取截图和 console 日志等。

核心能力：

  • scripts/with_server.py：
    • 自动启动/关闭一个或多个 server（前后端）；
    • 统一在 server 就绪后执行 Playwright 脚本。
  • 测试模式：
    • 静态 HTML：直接读取 HTML，识别选择器后编写 Playwright 脚本；
    • 动态 Web 应用：
      • 启动 server；
      • 使用 page.wait_for_load_state('networkidle') 等待 JS 加载；
      • 截图 / 抓取 DOM / 查找元素 / 执行动作。
  • examples/ 提供了常见脚本示例。

使用示例：

  • 「用 webapp-testing skill 写一个 Playwright 脚本，自动登录本地 5173 端口的应用，验证登录后页面上是否出现用户名。」

xlsx（Excel / 表格技能）

作用与用途：

  • 针对 Excel / CSV / TSV 的 创建、编辑、分析、可视化与公式处理，特别针对 财务模型 提供严格规范。

核心能力：

  • 所有 Excel 输出：
    • 必须保证 零公式错误（无 #REF!、#DIV/0! 等）；
    • 修改现有模板时必须 100% 遵循原格式和风格。
  • 财务模型规范：
    • 颜色约定（蓝=输入，黑=公式，绿=内部链接，红=外部链接，黄=关键假设等）；
    • 数字格式（年份文本化、货币格式、负数括号化、百分比和倍数格式等）；
    • 使用 Excel 公式而非在 Python 中写死结果（如 =SUM(), =AVERAGE() 等）。
  • 工具体系：
    • pandas：读写/分析数据；
    • openpyxl：保留并编辑公式、格式，插入行列和工作表；
    • recalc.py：用 LibreOffice 重新计算所有公式，输出 JSON 错误汇总，直到无错误为止。

使用示例：

  • 「用 xlsx skill 帮我新建一个三张表的 DCF 财务模型，按行业标准颜色标记输入/公式，确保无任何公式错误。」
  • 「修改这份 Excel 增加一列销售预测，并重新计算所有相关公式。」

推荐的其他 Skills / 资源网站

除了本仓库（Anthropic 官方示例集）之外，如果你想继续探索 Skills 生态和相关实践，可以参考下面这些网站和资源：

1. Agent Skills 标准与规范

  • Agent Skills 官方站点
    • 地址：https://agentskills.io
    • 内容与用途：
      • 给出 Agent Skills 的整体标准、设计理念和规范；
      • 包含完整的 Specification（规范文档）：https://agentskills.io/specification；
      • 适合：
        • 想系统了解 Skill 格式和触发机制；
        • 规划自己的一套技能体系；
        • 对接不同 Agent 平台时作为通用标准参考。

2. Anthropic 官方 Skills 示例仓库

你当前正在使用的 skills 项目，原始仓库就是 Anthropic 官方的公开示例。

  • Anthropic Agent Skills GitHub 仓库
    • 仓库名（示例）：anthropic-agent-skills（常作为 Claude Code Marketplace 的来源）
    • 内容与用途：
      • 提供完整的示例技能集（创意、办公、企业、开发等），与你当前项目类似；
      • README 中有详细说明如何在 Claude Code / Claude.ai / API 中安装和使用；
      • 是学习 Skill 设计模式 / 目录结构 / 配套脚本 的最佳参考之一。

3. Notion Skills for Claude

  • Notion 官方「Notion Skills for Claude」页面
    • 文档链接示例：
    • 内容与用途：
      • 展示 Notion 为 Claude 提供的一组技能，用于访问和操作 Notion 工作区内容；
      • 你可以从中学习：
        • 如何围绕具体 SaaS 产品（如 Notion）设计技能；
        • 技能描述中如何写清「什么时候触发、可做什么」；
        • 如何把外部系统（数据库、文档、任务）抽象为可供 LLM 使用的工具。

4. MCP（Model Context Protocol）相关资源

  • Model Context Protocol 官方站点
    • 地址：https://modelcontextprotocol.io
    • 内容与用途：
      • 不是传统意义上的「skills 网站」，但与 skills 思路高度接近；
      • 提供 MCP 协议规范、Typescript/Python SDK 文档；
      • 对于基于 MCP 构建「工具服务器」并和 Skills 结合使用非常关键。

5. Claude 官方文档中的 Skills 指南

  • Claude Skills 使用与创建指南（英文文档）
    • 常见入口（示例）：
      • 「What are skills?」
      • 「Using skills in Claude」
      • 「Creating custom skills」
    • 你可以在 Claude 官方文档站点（例如 https://docs.claude.com 或 https://support.claude.com）中搜索关键词 skills、Agent Skills 来访问这些页面。
    • 内容与用途：
      • 解释 Skills 在 Claude 生态中的角色；
      • 演示如何在 Claude.ai / Claude Code / API 中启用和调试 Skills；
      • 给出实践建议和常见问题解答。

总结与建议

如何选择适合的 Skill

  • 学习如何写自己的 Skill：重点看 skill-creator + template/SKILL.md。
  • 文档办公自动化：组合使用 docx / pptx / pdf / xlsx / brand-guidelines / theme-factory。
  • 创意视觉与前端：考虑 algorithmic-art、canvas-design、frontend-design、web-artifacts-builder、slack-gif-creator。
  • 工程集成与质量：使用 mcp-builder、webapp-testing。

技能组合使用示例

  • 品牌化文档：docx + brand-guidelines + theme-factory
  • 高质量演示文稿：pptx + theme-factory + brand-guidelines
  • 前端应用开发：frontend-design + web-artifacts-builder + webapp-testing
  • 企业文档协作：doc-coauthoring + internal-comms + docx

贡献与反馈

本项目是 Anthropic 官方的示例集合，如果你在使用过程中发现问题或有改进建议，可以：

  1. 查看原始仓库的 Issues 和 Pull Requests
  2. 参考 skill-creator skill 创建自己的自定义 Skill
  3. 在 Claude 社区中分享你的 Skill 使用经验

文档版本：基于 Anthropic Skills 仓库整理

avatar
文章
阅读
粉丝