把文档变成 SKILL.md

转换工具会生成什么

技能是一个文件夹，其中必须有一个文件：SKILL.md。这个文件以一小段 YAML（前置信息）开头，后面是用 Markdown 写的说明。开放的 Agent Skills 格式要求这段内容里有两个字段：

• name：1 到 64 个字符，只用小写英文字母、数字和连字符，不能以连字符开头或结尾，也不能有两个连续的连字符。必须与文件夹名称一致。
• description：1 到 1,024 个字符，说明技能做什么、什么时候使用。

转换工具用文档的第一个标题生成名称，用第一句话起草描述，整理项目符号；文档没有标题时会补上一个。两个字段都可以修改，文件会随输入实时更新。Anthropic 自己的规则还多了两条：名称不能包含“anthropic”或“claude”，两个字段都不能含 XML 标签。转换工具会检查这两条。

文件放在哪里

• Claude（网页版和桌面版）：打开 Customize > Skills，点击 +，再选 Create skill > Upload a skill，然后选择这个 .zip。里面是装着 SKILL.md 的文件夹，正是 Claude 要求的结构。需要开启代码执行。
• Claude Code：自己用就解压到 ~/.claude/skills/；要让克隆仓库的每个人都能用，就解压到仓库里的 .claude/skills/。
• Codex、Cursor、OpenCode：各自从不同的位置读取技能文件夹，同步指南列出了这些位置。

每手动放一份副本，就意味着以后有人要手动更新它。AI Skill Pod 接手的正是这件事。

写一个能让 AI 用起来的描述

在找到符合请求的技能之前，AI 只看每个技能的名称和描述，所以描述决定了你的技能会不会被打开。有三个好习惯：

• 先写它做什么：“用我们客服的语气起草退款回复。”
• 再写什么时候用：“客户要求退款、退货或拒付时使用。”
• 写出大家会输入的词：产品名、文件类型、团队内部的说法。