规范要求至少有 name 和 description。name 短、稳定、能当目录名。description 写它做什么、在什么任务触发、明确排除什么。不要写「处理任何文档」。
允许的工具、兼容的主机、许可如果字段存在，就写能核对的值。主机可能只预加载元数据；正文里的隐藏指令，用户在装之前看不到。
装之前打开 SKILL.md 看前置信息和它引用的 scripts。对照本站「怎么写 SKILL.md」和「怎么读技能详情页」。描述和正文打架时，先改描述。
一个仓库里多条技能时，每条的触发条件要能分开。两条都写「帮你写更好的代码」，模型会随便挑一条，或者两条都加载。