Anthropic Skills 解析

Anthropic Skills 解析基于 anthropics/skills 仓库的完整技术文档概述什么是 SkillsSkills技能是包含指令、脚本和资源的文件夹Claude 可以动态加载这些内容以提升在特定任务上的表现。Skills 教会 Claude 如何以可重复的方式完成特定任务例如根据公司品牌指南创建文档使用组织特定工作流分析数据自动化个人任务处理各种文档格式PDF、Word、Excel、PowerPoint构建应用程序和测试仓库信息指标数值仓库地址https://github.com/anthropics/skillsStars109KForks12K许可证Apache 2.0大多数部分 source-available核心价值Skills 的设计理念是将专业化能力注入 Claude Agent实现可重复性- 确保任务执行的一致性可扩展性- 用户可创建自定义技能动态加载- 按需加载优化上下文使用标准化- 遵循 Agent Skills 规范核心概念三级渐进式加载系统Skills 使用三层加载机制优化上下文效率级别内容加载时机建议大小元数据层namedescription启动时始终加载~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 resultsFrontmatter 字段规范字段必需约束条件name是最大 64 字符仅小写字母、数字和连字符不能以连字符开头或结尾description是最大 1024 字符描述技能功能及触发时机license否许可证名称或引用捆绑的许可证文件compatibility否最大 500 字符环境需求说明metadata否任意键值映射用于额外元数据allowed-tools否空格分隔的预批准工具列表实验性name 字段命名规则必须 1-64 字符仅允许小写字母 (a-z)、数字和连字符 (-)不能以连字符开头或结尾不能包含连续连字符 (--)必须与父目录名称匹配有效示例name:pdf-processingname:data-analysisname:code-review无效示例name:PDF-Processing# 不允许大写name:-pdf# 不能以连字符开头name:pdf--processing# 不允许连续连字符description 字段最佳实践Description 是技能触发的主要机制需要描述技能做什么描述何时使用触发条件包含具体关键词帮助 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. docxWord 文档描述创建、读取、编辑或操作 Word 文档.docx 文件。触发关键词Word doc、word document、.docx、report、memo、letter、template核心功能使用docx-js创建新文档解压 → 编辑 XML → 重新打包来编辑现有文档支持追踪更改、评论、页眉/页脚、目录等主要工具docx-js创建、pandoc读取、XML 编辑修改2. pdfPDF 处理描述处理 PDF 文件的全方位工具。触发关键词.pdf file、PDF相关操作核心功能读取/提取文本和表格合并/拆分 PDF旋转页面、添加水印创建新 PDF、填写 PDF 表单加密/解密、OCR 扫描 PDF提取图片主要工具pypdf、pdfplumber、reportlab、qpdf、pdftotext3. pptxPowerPoint 演示文稿描述处理 PowerPoint 文件的全方位工具。触发关键词deck、slides、presentation、.pptx核心功能读取/分析内容从模板编辑从头创建设计指南选择大胆的、内容相关的颜色调色板每张幻灯片都需要视觉元素避免纯文本幻灯片使用有趣的字体配对10 个预设颜色主题Midnight Executive、Forest Moss、Coral Energy 等4. xlsxExcel 电子表格描述处理电子表格文件的全方位工具。触发关键词.xlsx、.xlsm、.csv、.tsv、spreadsheet核心功能打开/读取/编辑现有文件从头创建新电子表格转换表格文件格式清理混乱的表格数据财务模型颜色编码标准蓝色文字硬编码输入黑色文字公式和计算绿色文字同工作簿内的工作表链接红色文字外部文件链接黄色背景需要关注的关键假设主要工具pandas数据分析、openpyxl公式和格式化重要始终使用 Excel 公式而非硬编码值设计与艺术类5. algorithmic-art算法艺术描述使用 p5.js 创建算法艺术支持种子随机性和交互式参数探索。触发关键词generative art、algorithmic art、flow fields、particle systems、用代码创作艺术工作流程创建设计哲学.md 文件用 p5.js 实现生成算法输出格式.md设计哲学、.html交互式查看器、.js生成算法6. canvas-design画布设计描述使用设计哲学创建精美的视觉艺术PNG/PDF 格式。触发关键词poster、piece of art、design、static piece、视觉设计工作流程创建设计哲学.md 文件在画布上表达设计.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 个预设主题Ocean Depths - 专业平静的海洋主题Sunset Boulevard - 温暖活力的日落色彩Forest Canopy - 自然接地的大地色调Modern Minimalist - 干净当代的灰度风格Golden Hour - 丰富温暖的秋季调色板Arctic Frost - 冷酷清脆的冬季灵感主题Desert Rose - 柔和精致的尘土色调Tech Innovation - 大胆现代的科技美学Botanical Garden - 新鲜有机的花园色彩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-apiClaude 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.6claude-opus-4-6200K (1M beta)Claude Sonnet 4.6claude-sonnet-4-6200K (1M beta)Claude Haiku 4.5claude-haiku-4-5200K11. mcp-builderMCP 构建器描述创建高质量的 MCP模型上下文协议服务器使 LLM 能够与外部服务交互。触发场景构建 MCP 服务器以集成外部 API 或服务四阶段工作流深入研究和规划理解 MCP 设计、研究框架文档实现设置项目结构、实现核心基础设施和工具审查和测试代码质量检查、构建测试创建评估创建 10 个评估问题测试效果推荐技术栈语言TypeScript高质量 SDK 支持传输Streamable HTTP远程服务器、stdio本地服务器协作与沟通类12. doc-coauthoring文档协作描述引导用户完成结构化的文档协作工作流程。触发关键词write docs、draft a proposal、create a spec、PRD、design doc、decision doc、RFC三阶段工作流上下文收集用户提供相关背景信息精炼与结构化迭代构建每个章节读者测试使用新的 Claude 实例测试文档可读性适用文档类型技术规范、决策文档、提案、RFC 等13. internal-comms内部沟通描述帮助编写各类内部沟通文档使用公司常用格式。触发关键词status reports、leadership updates、3P updates、company newsletters、FAQs、incident reports、project updates支持的沟通类型3P 更新公司通讯FAQ 回答状态报告领导层更新项目更新事件报告测试与工具类14. webapp-testingWeb 应用测试描述使用 Playwright 测试本地 Web 应用的工具包。触发场景验证前端功能、调试 UI 行为、捕获浏览器截图、查看浏览器日志决策树静态 HTML→ 直接读取 HTML 文件识别选择器动态 Web 应用→ 使用scripts/with_server.py管理服务器生命周期最佳实践使用sync_playwright()编写同步脚本动态应用必须等待networkidle状态使用描述性选择器15. skill-creator技能创建器描述创建新技能、修改和改进现有技能、测量技能性能。触发场景创建新技能、编辑现有技能、优化技能、运行评估核心循环确定技能用途起草技能运行测试用例与用户评估结果定性 定量根据反馈改进重复直到满意媒体创建类16. slack-gif-creatorSlack GIF 创建器描述创建优化的 Slack 动画 GIF。触发关键词animated GIF、GIF for Slack、make me a GIFSlack 要求Emoji GIF128x128消息 GIF480x480FPS10-30时长Emoji GIF 保持在 3 秒以内动画概念抖动/振动、脉冲/心跳、弹跳、旋转、淡入/淡出、滑动、缩放、爆炸/粒子爆发17. web-artifacts-builderWeb 产物构建器描述使用现代前端技术创建复杂的多组件 HTML 产物。触发场景复杂产物需要状态管理、路由或 shadcn/ui 组件技术栈React 18 TypeScript Vite Parcel Tailwind CSS shadcn/ui工作流程使用scripts/init-artifact.sh初始化项目开发产物使用scripts/bundle-artifact.sh打包为单个 HTML 文件展示给用户注意避免AI slop - 过度居中布局、紫色渐变、统一圆角、Inter 字体技能分类总览类别技能名称文档处理docx、pdf、pptx、xlsx设计与艺术algorithmic-art、canvas-design、frontend-design、theme-factoryAPI 与开发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 marketplaceaddanthropics/skills# 安装技能包/plugininstalldocument-skillsanthropic-agent-skills /plugininstallexample-skillsanthropic-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 bug2. 通过斜杠命令/pdf /commit -m Fix bug /review-pr 1233. 通过关键词触发自动触发Skill 的description字段是主要的触发机制。Claude 根据描述决定是否激活技能。重要触发规则Claude 只在任务复杂到需要 Skill 时才会触发简单、单步查询如读取此 PDF可能不会触发 Skill复杂、多步骤、专业化查询会可靠触发触发优化建议为防止 Claude “under-trigger”不触发有用的 Skilldescription 应写得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 dont explicitly ask for a dashboard.技能创建最佳实践创建流程1. 意图捕获 - 理解用户想要什么 2. 研究访谈 - 确认细节、边界情况 3. 编写 SKILL.md - 草稿版本 4. 测试运行 - 用真实提示词测试 5. 用户评审 - qualitative quantitative 评估 6. 改进迭代 - 基于反馈修改 7. 重复直到满意 8. 描述优化 - 优化触发准确性 9. 打包交付 - 生成 .skill 文件编写风格指南核心原则使用祈使句指令使用命令式语气解释重要性解释为什么重要而非强制性必须通用化设计避免过于狭窄地绑定特定示例心智理论应用考虑模型如何理解和应用指令输出格式定义模式## 报告结构 始终使用此确切模板 # [标题] ## 执行摘要 ## 关键发现 ## 建议示例模式## 提交消息格式 **示例 1** 输入添加用户认证和 JWT 令牌 输出feat(auth): 实现 JWT 认证多领域组织模式当技能支持多个领域/框架时按变体组织cloud-deploy/ ├── SKILL.md (工作流 选择逻辑) └── references/ ├── aws.md ├── gcp.md └── azure.mdClaude 仅读取相关的参考文件避免加载全部内容。验证与测试验证工具skills-ref validate ./my-skill检查 SKILL.md frontmatter 是否有效是否遵循命名约定。测试案例要求独立性不依赖其他问题只读性仅需非破坏性操作复杂性需要多次工具调用和深入探索真实性基于真实使用场景可验证性单一明确答案可验证稳定性答案不会随时间变化附录常见模式总结模式用途示例决策树帮助选择实现路径webapp-testing 的静态/动态判断参考文件库按需加载详细文档mcp-builder 的语言指南分离辅助脚本复杂工作流的黑盒处理with_server.py示例模式展示输入/输出格式提交消息格式示例渐进披露上下文效率管理SKILL.md 500 行关键建议Description 是关键花费时间优化 description这是触发机制的核心保持简洁SKILL.md 正文控制在 500 行以内结构化组织使用 scripts/、references/、assets/ 分离不同类型内容编写可操作指令使用祈使句解释重要性而非强制测试验证创建测试案例并运行评估迭代考虑用户体验根据用户技术水平调整沟通方式官方资源资源URLAgent Skills Specificationhttps://agentskills.io/specificationAgent Skills 文档索引https://agentskills.io/llms.txtAnthropic Skills GitHubhttps://github.com/anthropics/skills什么是 Skillshttps://support.claude.com/en/articles/12512176-what-are-skills如何创建自定义技能https://support.claude.com/en/articles/12512198-creating-custom-skillsSkills 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 的能力边界。