为什么你的 Claude Code Skill 从不触发？ extensibility 实战指南

Claude Code 的 extensibility（可扩展性）是它区别于普通 AI 助手的关键——但很多人装了一堆 skill，激活率却低得可怜。这个 claude-extensibility skill 就是来解决这个问题的。

痛点：为什么你的 skill 没人用？

我见过太多人装 skill 的方式是这样的：看到别人推荐 → npx skills add → 丢进 ~/.claude/skills/ → 期待 Claude 自己发现。

结果呢？Claude 完全不触发。

问题不在 skill 装得不对，而在于激活关键词没写好。claude-extensibility 里的有一句话很扎心：

Brilliant skill + poor keywords = dead skill

系统只读 frontmatter 的 description 字段来决定是否加载你的 skill。你写得模棱两可，Claude 就当它不存在。

这个 skill 教什么？

claude-extensibility 不是什么”skill 大全”，它专注在一件事上：如何写出能被激活的 extension（agents / skills / output styles）。

它提炼出了几条决策启发式：

• 3-File 规则：任务涉及 3 个以上文件 → 用 agent；增强你个人工作流 → 用 skill
• 委托测试：任务能独立跑而你去做别的 → agent；需要你来驱动 → skill
• Expert Test：专家做这件事和新手做法一样吗？差异大 → skill
• Activation Breadth：触发词覆盖 80% 相关请求就够了，别贪多

最后一条很多人踩坑——以为关键词塞得越多触发越准，结果 over-broad 导致 false activation，Claude 乱触发几次之后就无视这个 skill 了。

激活关键词怎么写？

skill 里给了一个很好用的模板：

description: "Extract text and tables from PDF files, fill forms, merge documents.
  Formats: .pdf. Tools: pypdf, pdfplumber. Actions: extract, fill, merge PDFs.
  Keywords: PDF, form, document. Use when: working with PDF files, extracting data."

核心是 WHAT + WHEN + Keywords 三段式，而且要包含同义词和口语化表达——用户不会说”我想用 chain-of-thought prompting”，他们会说”让 AI 一步一步想清楚”。

安装方式

npx skills add https://github.com/brixtonpham/claude-config --skill claude-extensibility

skill 来自 brixtonpham/claude-config 仓库，里面还有 22 个其他 skill（ui-ux-pro-max、planning、prompt-architect 等），按需取用。

适用场景

• 想给团队定制 Claude Code workflow 但 skill 触发不稳定
• 写了很多 skill 但 Claude 从不主动调用
• 想构建可复用的 agent/skill 体系但不知道从哪里入手

说实话，claude-extensibility 本身 star 数不高（0），但内容质量很扎实。它不是教你”有哪些 skill 可用”，而是教你怎么让 skill 真正被用起来——这个角度在同类 skill 里不多见。

GitHub：https://github.com/brixtonpham/claude-config

GitHub: https://github.com/brixtonpham/claude-config