Claude 发布 Skill 创建指南：步骤、局限与示例

这篇文章讲了什么

• Anthropic 系统介绍如何通过 SKILL.md 文件创建 Skill，把机构经验、输出规范、多步骤工作流编码进 Claude
• 给出从需求澄清到上线的五步流程：理解核心需求、命名、写 description、写 instructions、上传
• 强调 SKILL.md 里只有 name 和 description 影响触发，description 是决定 Skill 何时激活的关键字段
• 列出 Claude.ai、Claude Code、Claude Developer Platform 三个上传路径，并给出 Skills API 的 curl 调用片段
• 提出三类测试场景：normal operations、edge cases、out-of-scope，以及 triggering test 与 functional test
• 给出 docx、brand-guidelines、frontend-design 三个真实 Skill 示例并解析"为什么强"
• 讨论 Skill 触发机制、文件膨胀控制、组织内共享治理与常见调试问题

具体怎么实现

文章把 Skill 拆成三件可写的东西：name、description、instructions。name 用小写加连字符的形式标识，例如 pdf-editor、brand-guidelines；description 决定 Claude 是否会在某次请求里调用它，作者用一组对比把"弱描述"和"强描述"摆在一起，弱版本写"This skill helps with PDFs and documents"，强版本写一段包含 extract、create、merge 等具体动词，以及 form filling、batch operations 等用例，再加上"not for simple PDF viewing"这样的边界说明。Anthropic 把 description 视作 Claude 做语义匹配的输入，而非关键词匹配，所以模糊描述会同时带来"该触发没触发"和"不该触发也触发"两类问题。instructions 这一块要求 markdown 结构化呈现，包括 overview、prerequisites、execution steps、examples、error handling、limitations，并强调把成功标准写进 Skill 本身让 Claude 自检；为了控制 context window，作者推荐"menu"模式，SKILL.md 只描述菜单，把具体流程拆到独立文件里用相对路径引用，Claude 按任务现读现取。

上传环节给出三条具体路径：Claude.ai 在 Settings 里加 custom skill，要求 Pro/Max/Team/Enterprise 计划并开启 code execution，且当前 Skill 仅个人可见；Claude Code 在 plugin 或 project 根目录建 skills/ 目录，每个子目录放一份 SKILL.md，Claude 在 plugin 安装后自动发现；Claude Developer Platform 通过 /v1/skills 端点上传，文章给出 curl 调用，请求带 anthropic-beta: skills-2025-10-02 头、display_title 字段以及通过 -F files[] 上传的 SKILL.md。测试矩阵覆盖三类场景，normal operations 用典型请求验证基础逻辑，edge cases 用残缺或异常输入观察降级行为，out-of-scope 用相邻任务确认 Skill 不该越界激活，例如 NDA review skill 不应被 employment agreement 唤起；triggering test 同时跑显式调用和自然语言调用两种触发方式。三个示例里，docx skill 展示了 workflow decision tree、redlining workflow、ooxml.md 渐进式披露以及 tracked changes 的 good/bad XML 对比；brand-guidelines skill 提供 Claude 本身不知道的精确事实，如 #d97757 这类十六进制色值、Poppins/Lora 字体名、24pt 字号阈值；frontend-design skill 把"避免 generic AI aesthetic"写进 description，列出 typography、color、motion、spatial composition、background 五个美学维度的明确要求。文末还给出团队级治理建议：小团队用统一 specification 模板，中大型团队设 skill owner、维护中心 wiki、做版本化与季度复审。