写 Skill 还在堆字数?这个 200 行上限逼你砍掉所有废话

你有没有这种感觉:装了 N 个 Skill,结果 Claude Code 一问三不知?

问题很可能不在 AI,在于你写的那个 SKILL.md 太啰嗦了。

最近我在 Smithery 上发现了一个巨实用的小工具——parcadei/skill-development,专门教你怎么写 Skill。安装量已经 3,500+,口碑相当硬。

核心只有三条规则,粗暴到让人怀疑是不是太简单了:

DO:
– SKILL.md 控制在 200 行以内
– 写清楚”什么时候用这个 Skill”
– 给出能直接复制粘贴的 Bash 命令

DON’T:
– 不要在 SKILL.md 里塞实现细节
– 不要在不同 Skill 之间重复同样的内容
– 不要创建没有触发词的 Skill(对应不上 skill-rules.json)

说实话,前两条我之前就踩过坑。早期写的 Skill,光背景介绍就占 80 行,读完都不知道这玩意儿能干啥。

第三条更关键——很多人以为丢个 SKILL.md 进去就完事了,结果 Claude 完全不知道什么时候该调用它。这个 Skill 专门强调了触发词机制,必须配合 skill-rules.json 使用,Claude 才能在合适的时机自动调起对应的 Skill。

关于 MCP 封装 Skill 的场景,它还给了个建议:用 allowed-tools: [Bash, Read] 限制工具权限,别让 Skill 拥有不该有的能力。这个思路很干净——Skill 应该只做它该做的事。

安装方式超简单,在 Smithery 直接搜 parcadei/skill-development,或者在支持的 Agent(Claude Code、Codex、Copilot 等 18 个平台)里用插件安装命令搞定。

说到底,写 Skill 和写代码一样——不是写得越详细越好,而是刚好够用就好。这个 200 行的隐形上限,逼着你砍掉所有废话,留下的才是真正的价值。

GitHub:https://github.com/parcadei/Continuous-Claude-v3/tree/main/.claude/skills/skill-development


GitHub: https://github.com/parcadei/Continuous-Claude-v3/tree/main/.claude/skills/skill-development

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 65 阅读