Claude 自定义 Skill 创建指南：从录制到打包测试

Claude 官方帮助中心讲清了自定义 Skill 的完整做法：既可以在 Mac 版 Cowork 里录屏让 Claude 自动生成，也可以手写 skill.md 目录包。文章给出必填元数据、资源与脚本的组织方式、ZIP 打包结构和上线前后的测试清单。

Skill 的定位与可用范围

• Free、Pro、Max、Ultra、Team、Enterprise 用户都能用 Skills，但需要开启代码执行；Claude Code 用户和通过代码执行工具调用 API 的用户目前是 beta。
• 好 Skill 的共同点：解决一个具体且可重复的任务、指令清晰、必要时带示例、写明何时该用、只聚焦一条工作流而不是什么都做。
• Skill 可以只是几行指令，也可以是多文件包加可执行代码。

录屏生成 Skill（仅 Mac 版 Cowork）

• 录制功能面向 Pro、Max、Ultra、Team 计划，在 Mac 版 Claude 的 Cowork 中可用；聊天界面、Windows 和 Free、Enterprise 计划不支持。
• 录制前更新到最新版 Claude for Mac，首次录制需授予 macOS 辅助功能（鼠标键盘追踪）和屏幕录制权限，可能要求重启。
• 关闭不想被拍到的文件、应用和对话；录制期间屏幕内容和语音都会被采集，不要输入密码或展示敏感信息。
• 入口有两个：输入框的「+」选 Record a skill，或 Customize > Skills 里 Add 后选 Record your screen。
• 单次录制约 10 分钟，剩一分钟时会有倒计时，归零后自动停止并发送已采集内容。边做边讲解能给 Claude 屏幕之外的上下文，比如为什么跳过某步。

录制之后会发生什么

• Claude 会开一个 Cowork 任务回看录像，然后给出提案：要么是标 NEW 的新 Skill，要么是对已有 Skill 的更新（当录制内容与现有 Skill 重叠时）。
• 在提案卡片上展开内容可以先读再决定，选 Save/Update 保留，或 Dismiss 丢弃。
• 录像和音频不会被保留，最终保存下来的是会话中的一组截图，可在任务的 Recorded demonstration 步骤里查看；删除该任务会一并删除截图。
• 保存后的 Skill 出现在 Customize > Skills，可像普通 Skill 一样编辑、分享、删除。

手写 skill.md：元数据是关键

• 每个 Skill 是一个目录，至少包含 skill.md，文件开头必须是 YAML frontmatter。
• 必填字段两个：name（人类可读名称，最多 64 字符）和 description（说明做什么、何时使用，最多 200 字符）。description 直接决定 Claude 何时调用，是最关键的一项。
• 可选字段 dependencies 声明依赖包，例如 python>=3.8、pandas>=1.5.0。
• 元数据属于渐进披露的第一层，只提供足够判断「该不该用」的信息，正文作为第二层在需要时才读取。
• 正文可写概览、规范细节和适用场景，例如品牌色值、字体、Logo 使用规则和触发条件。

资源、脚本与打包

• 信息太多时不要塞进单个 skill.md，可在目录里加 REFERENCE.md 等补充文件，并在 skill.md 中引用，帮助 Claude 判断何时读取。
• 进阶用法是附上可执行代码，官方文档类 Skill 用到 Python（pandas、numpy、matplotlib）、JavaScript/Node.js、文件编辑包和可视化工具。
• Claude 和 Claude Code 加载 Skill 时可从 PyPI、npm 安装包；API Skills 不能在运行时安装，所有依赖必须预装在容器里。
• 打包时文件夹名要与 Skill 名一致，压缩成 ZIP，且 ZIP 根目录就是该 Skill 文件夹，而不是把文件直接放在 ZIP 根下。

测试与迭代

• 上传前：检查 skill.md 是否清晰、description 是否准确描述触发时机、引用的文件是否都在正确位置，并用示例提示词试跑。
• 上传后：在 Customize > Skills 启用，换多个应当触发的提示词测试，查看 Claude 的思考过程确认它真的加载了 Skill。
• 如果 Claude 没在预期时使用，优先改 description 再试。
• 在聊天中迭代时，可直接在对话旁打开并编辑 Skill 文件。

今天就能做

• 先挑一个你每周重复做、步骤固定的任务，写一份 200 字符以内的 description，明确「做什么 + 何时用」。
• Mac 用户可先录一遍自己的操作流程，让 Claude 生成初稿，再手动改 description 和正文。
• 打包前按清单自查：文件夹名与 Skill 名一致、ZIP 根目录是 Skill 文件夹、所有引用文件存在，然后用多个提示词验证触发。