Create Agent Skills（PyTorch 官方）— Agent 技能编写规范与验证清单

技能简介

Create Agent Skills 是 PyTorch 官方仓库内嵌的技能编写规范，随 pytorch/pytorch 主仓库公开，面向 Claude、Codex 与 Claude Code 三类工具。它把写好一个 Agent Skill 的关键要素收敛为四件事：聚焦的范围、可被发现的描述、合法的结构、充分的验证。技能系统讲解 SKILL.md 的 frontmatter 要求与命名规则、个人技能与项目技能的存放位置选择、指令与示例的组织方式，以及发布前的验证、测试与排错清单。出自深度学习框架 PyTorch 官方工程实践，质量分 79、风险等级 safe，是平台少见的"大厂官方出品"技能编写指南。

核心能力

• 单一范围原则：指导作者为每个技能划定一个可复用的聚焦能力，防止技能范围失控。
• 存放位置决策：说明个人技能与项目技能各自的存放路径与选择标准，避免团队间不同步。
• frontmatter 与命名规范：列出元数据必填项与命名规则，保证技能能被 Agent 正确索引与激活。
• 多文件组织方法：给出指令、示例、支撑文件的拆分方式，主文件保持精简、细节按需加载。
• 验证与测试清单：提供结构、允许工具、依赖、测试步骤四个维度的发布前自检项。
• 故障排查指引：覆盖激活失败、描述模糊、依赖缺失等常见问题的定位方法。

安装配置

• Skillstore CLI 安装：运行 npx skillstore add pytorch/skill-writer 获取已审计版本。
• 从 PyTorch 仓库安装：克隆 pytorch/pytorch 仓库，取 .claude/skills/skill-writer 目录放入本地技能路径。
• 多工具路径适配：按 Claude Code、Codex 各自的技能目录约定放置，路径规范见技能正文说明。
• 前置条件：技能假设用户具备本地创建与编辑技能文件的能力，本身不依赖 Claude Code 安装或市场发布流程。

使用步骤

1. 确定范围：先想清楚这个技能只负责哪一件重复任务，用一句话写下它的能力边界。
2. 选择存放位置：按个人使用还是团队项目使用，决定技能放入个人目录还是项目仓库。
3. 编写 frontmatter 与描述：按命名规则写名称与 description，嵌入具体触发短语、文件类型与操作动词。
4. 组织正文与支撑文件：主 SKILL.md 只留核心指令，示例、参考、脚本拆分为独立支撑文件。
5. 运行验证清单：逐项核对结构完整性、允许工具、依赖声明与测试步骤是否齐备。
6. 真实请求测试：用贴近真实的用户请求测试激活，确认无误后再共享给团队或发布。

适用场景

• 创建首个个人技能：把个人重复任务第一次封装成规范的 Agent Skill。
• 统一团队技能结构：为团队多个技能建立一致的 frontmatter、文件布局与示例标准。
• 既有技能文档改造：排查存量技能描述模糊、示例缺失、依赖未声明与激活缺口。
• 技能发布前检查：共享或上架前用验证清单做最后一轮结构与激活体检。
• 技能文件存放治理：厘清哪些技能该进个人目录、哪些该随项目仓库版本管理。

适用人群

• PyTorch 生态开发者：已在使用 PyTorch 并希望沉淀编码技能的工程师。
• Claude Code / Codex 用户：需要编写与维护本地技能的 AI 辅助编程使用者。
• 团队工具链维护者：负责统一团队技能规范与评审标准的角色。
• 技能初次创作者：第一次接触 Agent Skill、需要权威规范打底的新手。

工作原理

该规范的核心逻辑是"范围 → 发现 → 结构 → 验证"闭环：范围决定技能能否被复用，单一职责的技能才不会在触发时带来无关上下文；发现层靠 description 中的具体触发短语（文件类型、操作、场景）让 Agent 在正确时机命中；结构层通过 frontmatter 规范与多文件拆分控制加载成本，主文件精简、支撑文件按需读取；验证层用发布前清单把结构错误、依赖缺失、激活歧义在共享前拦截。PyTorch 官方仓库的真实使用场景赋予了这套规范工程可信度。需要注意的是它只提供编写指导，不负责安装 Claude Code、不代跑外部 Schema 校验，也不替代领域专家内容。

官方链接

• Skillstore 页面：https://skillstore.io/skills/pytorch-skill-writer
• GitHub 仓库：https://github.com/pytorch/pytorch/tree/main/.claude/skills/skill-writer
• Manifest：https://skillstore.io/api/skills/pytorch-skill-writer/manifest
• 安装命令：npx skillstore add pytorch/skill-writer