Appearance
write-a-skill 解决的是“把经验写成 Skill，但 Agent 不知道什么时候用”的问题。Skill 的 description 比正文更关键，因为 Agent 先看到 description 再决定是否加载。正文要短，复杂内容拆到参考文件，确定性操作交给脚本。
怎么写一个能被 Agent 正确触发的 Skill：write-a-skill 怎么用
下载 write-a-skill 中文版 Skill ZIP
很多人写 Skill，会把重点放在正文。
其实第一关是 description。
Agent 不是先读完整 SKILL.md 再决定用不用。它通常先看 description，判断这个 skill 是否匹配当前任务。
write-a-skill 的价值，就是让你把技能写成 Agent 能正确触发、能稳定执行的形式。
description 要写触发条件
坏的 description 是：
md
Helps with documents.Agent 看完不知道它和 PDF、Markdown、PRD、合同有什么关系。
更好的写法是：
md
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.它说明了能力，也说明了触发场景。
SKILL.md 不要太长
Skill 主文件越长，越不容易稳定使用。
更好的结构是：
SKILL.md：核心流程和触发规则。REFERENCE.md：不常用的详细规则。EXAMPLES.md：示例。scripts/：确定性操作。
如果所有内容都塞进 SKILL.md，Agent 每次加载都会背一大堆不一定用得上的信息。
什么时候加脚本
脚本适合处理确定性任务：
- 验证格式。
- 批量改名。
- 提取数据。
- 生成固定结构。
- 检查文件是否齐全。
不要把需要判断的事情硬写进脚本。判断交给 Agent，重复且确定的步骤交给脚本。
给 AI 的 write-a-skill Prompt
md
请按 write-a-skill 的方式帮我设计一个 Skill。
先问清：任务领域、触发场景、是否需要脚本、是否需要参考材料。
然后给出 SKILL.md 的结构草稿。
重点检查 description 是否能让 Agent 正确判断什么时候加载。这比直接说“帮我写一个 Skill”稳定得多。
你可能还需要
同类技能：
如果某个工作你已经重复 prompt 很多次，就可以考虑把它沉淀成 Skill。