Skill Writer：PyTorch 官方教你如何给 Claude Code 写 Skill

为什么你的 Claude Code 总是「听不懂」你？

因为你没有给它写一份像样的 Skill。

很多人用 Claude Code 就是开个聊天框，问一句答一句，跟用普通 ChatGPT 没什么区别。但 Claude Code 真正的玩法，是把重复的工作流封装成 Skill——下次遇到同类任务，Agent 自动调用，连脑子都不用动。

问题来了：Skill 怎么写？

PyTorch 官方出了一个 Skill Writer，专门教你如何创建一个合规的、能让 Claude Code 自动激活的 Skill。97k Stars，41 次安装——这个数字本身就说明问题了。

Skill 到底是什么？

简单说，Skill 就是一个 Markdown 文件（SKILL.md），放在特定目录下，Claude Code 读取后会在合适场景自动调用。它本质上是一段结构化的指令，格式如下：

• name：技能名（小写、中划线）
• description：触发条件描述（核心！写不好 Agent 就不会用你）
• Instructions：具体执行步骤
• Examples：使用示例

最关键的细节：Description 怎么写

Skill Writer 强调了一个很多新手会踩的坑：Description 太模糊，Agent 就不会激活你。

❌ 错误示范：Helps with documents

✅ 正确姿势：Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

要包含：做什么 + 什么时候用 + 触发词。Claude Code 的隐式调用就是靠这段文字匹配。

Skill 的两层存放结构

• 个人级（~/.claude/skills/）：所有项目都能用，适合自己沉淀的工作流
• 项目级（.claude/skills/）：只有本项目能用，适合团队规范和定制流程

进阶：多文件 Skill

Skill Writer 还教你怎么做复杂 Skill：

• SKILL.md：主入口
• reference.md：详细 API 文档
• examples.md：扩展用例
• scripts/：辅助脚本

这就是”渐进式披露”——主文件精简，细节按需展开。

为什么这个 Skill 值得学？

Skill 是 AI Agent 时代的”函数封装”。当你把重复的工作流写成 Skill，就等于给 Claude Code 装备了一个可组合的能力库。随着 Skill 积累，你的 Agent 会越来越懂你、越来越高效。

Skill Writer 本身就是一个教你如何构建这类能力资产的 Skill——元技能，绕但有效。

GitHub 地址（pytorch/skill-writer）

GitHub: https://github.com/pytorch/pytorch/tree/main/.claude/skills/skill-writer