检查你的 skill：一段提示词扫出 Claude 可能漏看的地方

01 · 提示词

先给你：你来拿的那一段

贴进 Claude Code

扫一遍 ~/.claude/skills 底下每一个 skill：
1. 列出超过 100 行、开头 40 行内没有目录（Contents）的附件档（问题 A）
2. 列出只能经由另一份附件才找得到的档（问题 B，套娃）
3. 列出超过 500 行的 SKILL.md
4. 列出有用到外部套件、但 SKILL.md 没写要装什么的 skill
只列清单、先不要改；我看完再说要改哪几份。

为什么最后一句要写「先不要改」：改哪几份留给你自己决定。不写这句，它可能一口气把你所有 skill 都改掉。

做得到，靠这三个前提

要用 Claude Code（它读得到你电脑里的档）。网页版的 Claude 看不到你的资料夹。
路径要对：个人的 skill 在 ~/.claude/skills；写在某个项目里的，在那个项目的 .claude/skills。红字那段换成你的。
它列的是「可能」有问题：开头有没有目录是看标题判断的，最后要不要改，你自己看过再定。

02 · 为什么要检查

Claude 怎么读你的 skill

skill 就是你写给 Claude 的说明书。它不是一次全部读进去，而是一步一步、用到才读1：

先只看名字和一句描述判断这次要不要用它

要用了，才打开总页（SKILL.md）总页写着步骤，和「细节去看哪一份附件」

做到那一步，才打开那份附件用不到的附件，它不会开

附件又叫它去看另一份这时它可能只先看开头 100 行，不读完整份2

所以有两种情况会出事：

说明书太长重点写在第 100 行之后，它可能只看开头就走了

说明书套娃一份叫它看下一份，越底下那份，越可能只看一半

03 · 自己玩一次

只看开头，它知道后面有什么吗？

下面是一份 160 行的示意附件，第 130 行写着重点。拉一拉「它看了几行」，再把目录开开关关。

它看了几行 100

它知道这几节存在吗？

示意档，不是真的 skill。行数与段落位置是为了示范编的。

04 · 怎么改

两个做法，各解一个

做法 1 · 解决 A

长的附件，最上面先放目录

超过 100 行的附件，开头列出每一节的名字。就算它只看开头，也知道后面有什么、该跳去哪3。

做法 2 · 解决 B

每一份附件，都从总页直接连

不要「附件里再叫它看另一份」。一层就到，它需要的时候会整份读完2。

同一份指南还讲了五条，一起放这里：

总页控制在 500 行内快到了就拆成附件1
分清楚哪一步能放手做法很多的给目标就好；容易出错的步骤给固定的脚本4
换不同模型测一遍小模型看引导够不够，大模型看有没有讲太多5
长流程给它一张清单让它复制下来，做一项勾一项6
做完叫它自己检查不过就改，改到过为止6
写明要装哪些套件别假设对方电脑已经装好；提示词第 4 项就是查这个7

05 · 老实说

我自己也中了

2026-10-07 我用同样的检查，扫了自己电脑上装的 31 个 skill：

16份长附件
开头没目录（A）

1处套娃（B）

0个总页
超过 500 行

我自己的 17 个 skill 里，6 份中了 A。超过 100 行的附件一共 20 份。
Anthropic 官方出的那几份长附件，也没有目录，包括 pdf skill 那份 611 行的。我说的是装在我电脑上的版本，不知道是不是在指南更新之前写的。
官方的原话是「可能」：不是每次都只看 100 行。加目录是让它就算只看开头，也不会漏掉。

06 · 常见问题

你可能会问

它会不会把我的 skill 改掉？

提示词最后一句写了「只列清单、先不要改」。它列完，你看过再跟它说要改哪几份。

不到 100 行的附件，也要放目录吗？

官方的建议是超过 100 行才放3。短的它通常会整份读，放了也没坏处，只是不必要。

我没有自己写 skill，只是装别人的，要检查吗？

可以扫，但改别人的 skill，下次更新可能会被盖回去。比较有用的是：知道哪几个装的 skill 有这个问题，用的时候多留意。

这是 Anthropic 的硬性规定吗？

不是规定，是官方写法指南里的建议1。照着做，skill 被读漏的机会比较小。

出处

Anthropic〈Skill authoring best practices〉：开机只载入名字和描述、用到才读 SKILL.md 与附件；SKILL.md 控制在 500 行内。platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices（2026-10-07 核）
同上「Avoid deeply nested references」：附件再指向另一份时，Claude 可能用 head -100 预览、不读完整份；所以附件只放一层。
同上「Structure longer reference files with table of contents」：超过 100 行的附件，开头放目录。
同上「Set appropriate degrees of freedom」。
同上「Test with all models you plan to use」：Haiku 看引导够不够，Sonnet 看清不清楚，Opus 看有没有讲太多。
同上「Workflows and feedback loops」：长流程给可复制的 checklist；跑检查 → 改 → 再跑。
同上「Package dependencies」：在 SKILL.md 写明要装的套件。