@zeuuss_01: 本周阅读了 40 个 SKILL.md 文件。其中 33 个的描述永远无法触发……它们都有同样的错误。技能本身没问题。描述却是死代码。技能不是按文件名加载的，它们是在描述命中用户刚输入的关键词时加载的。宣传册文案——隐形。五个修复方案 1. 将描述写成触发映射表：停止描述技能做什么，开始列举用户会说的话 > 文件类型：docx、.docx、Word 文档 > 动词：创建、编辑、填写、遮盖、转换 > 交付物：备忘录、合同、报告、信函 > 否定词：不适用于 PDF，不适用于 Google 文档。如果真实用户请求中不包含这三个词中的三个，该技能就是不可见的 2. 针对真实提示词而非合成提示词进行测试：从你过去一周的 Claude 使用记录中提取 20 条消息。将每条消息粘贴到已安装该技能的空白聊天窗口中 > 0/20 - 从头重写 > 5/20 - 缺少动词或文件扩展名 > 15/20 - 可以发布 > 20/20 - 过度拟合，会抢走不相关的任务。测试你实际写过的文本，而不是为了让技能看起来好而写的提示词 3. 添加负向空间：大多数技能被禁用是因为错误触发，而不是因为没有触发 > 不要用于 PDF > 不要用于 Google 表格 > 仅在用户写作时触发，阅读时不要触发 > 如果交付物是 Notion 页面，不要触发。否定词占描述的一半 4. 精简正文：在 SKILL.md 中，任何不会改变 Claude 行为的內容都是累赘。删除：> 使命声明 > "这个技能帮助你..." > 通用的 AI 建议 > 任何 Claude 已经知道的内容 > 像 README 一样的引言段落。剩下的应该像给新员工的一页纸指南 5. 对描述进行版本控制，而不是对正文进行版本控制：描述是路由器唯一能看到的东西。在技能旁边保留一个 descriptions.md：> 你尝试过的每个变体 > 日期 > 0/20 - 20/20 的评分 > 改变了什么。你会迭代描述的频率是正文的 10 倍。追踪它……正文回答“我该如何做”，而描述回答“这甚至是不是我的工作”。

本周阅读了 40 个 SKILL.md 文件。其中 33 个的描述永远无法触发……它们都有同样的错误。技能本身没问题。描述却是死代码。 技能不是按文件名加载的，它们是在描述命中用户刚输入的关键词时加载的。宣传册文案——隐形。 五个修复方案 1. 将描述写成触发映射表： 停止描述技能做什么 开始列举用户会说的话 > 文件类型：docx、.docx、Word 文档 > 动词：创建、编辑、填写、遮盖、转换 > 交付物：备忘录、合同、报告、信函 > 否定词：不适用于 PDF，不适用于 Google 文档 如果真实用户请求中不包含这三个词中的三个，该技能就是不可见的 2. 针对真实提示词而非合成提示词进行测试： 从你过去一周的 Claude 使用记录中提取 20 条消息 将每条消息粘贴到已安装该技能的空白聊天窗口中 > 0/20 - 从头重写 > 5/20 - 缺少动词或文件扩展名 > 15/20 - 可以发布 > 20/20 - 过度拟合，会抢走不相关的任务 测试你实际写过的文本 而不是为了让技能看起来好而写的提示词 3. 添加负向空间： 大多数技能被禁用是因为错误触发，而不是因为没有触发 > 不要用于 PDF > 不要用于 Google 表格 > 仅在用户写作时触发，阅读时不要触发 > 如果交付物是 Notion 页面，不要触发 否定词占描述的一半 4. 精简正文： 在 SKILL.md 中，任何不会改变 Claude 行为的內容都是累赘 删除： > 使命声明 > "这个技能帮助你..." > 通用的 AI 建议 > 任何 Claude 已经知道的内容 > 像 README 一样的引言段落 剩下的应该像给新员工的一页纸指南 5. 对描述进行版本控制，而不是对正文进行版本控制： 描述是路由器唯一能看到的东西 在技能旁边保留一个 descriptions.md： > 你尝试过的每个变体 > 日期 > 0/20 - 20/20 的评分 > 改变了什么 你会迭代描述的频率是正文的 10 倍。 追踪它…… 正文回答“我该如何做”。 而描述回答“这甚至是不是我的工作”。