本文要点
- Skills ≠ MCP:Skills 是程序性记忆(SOP),MCP 是实时工具手;二者互补,不能互相替代。
- P0 零安装:bundled 的
/code-review、/debug、/loop、/run、/verify每个会话自带,很多人却从没用过。 - P1 官方必装:
skill-creator(自写技能)+ Document Skills(PDF/DOCX/XLSX 真文件处理)。 - P2 工作流三板斧:
grill-me(开工前对齐)、handoff(跨会话/跨 Agent 交接)、superpowers(多步 TDD 编排)。 - 两类技能:Capability Uplift(教会新能力)vs Encoded Preference(固化团队偏好)——装错类型等于白装。
- 7×24 长跑:Skills 与
~/.claude/skills/同机常驻时,笔记本合盖会断链;见文末 Cloud Mac 落地步骤。
1. 为什么 Skills 比堆 CLAUDE.md 更值得投入
很多人把团队规范全塞进 CLAUDE.md,结果每次会话开头就烧掉几千 token,且 Claude 未必按顺序执行。Skills 的核心优势是渐进式披露:启动时 Claude 只读每个技能的 name 与 description(约 100 token/技能),任务匹配时才加载完整 SKILL.md 正文。无关技能不占上下文,这是 2026 年 Agent 工程化的基本盘。
官方文档把 Skills 定义为遵循 Agent Skills 开放标准 的目录结构,Claude Code 在其上扩展了动态上下文注入(!`git diff HEAD`)、context: fork 子代理执行、disable-model-invocation 等能力。同一份 SKILL.md 还可被 Cursor、Codex CLI、GitHub Copilot 读取——真正分水岭是「工作流是否可路由」,而不是模型智商。
若你已在考虑把 Claude Code 迁到常驻主机,可先读站内 为什么越来越多人把 Claude Code 跑在云 Mac 上;本文默认你已在本地或远程 Mac 上跑通 claude CLI。
模型能力不是分水岭,可路由的工作流入口才是分水岭。
2. 四层来源:bundled / 官方插件 / 项目级 / 社区
安装前必须先分清技能从哪来——信任级别与更新方式完全不同:
| 层级 | 路径 | 作用域 | 典型代表 |
|---|---|---|---|
| Bundled(内置) | 随 Claude Code 发行 | 每会话默认可用 | /code-review、/debug、/loop、/run、/verify |
| 官方 Plugin | /plugin marketplace add 或 claude.com/plugins |
个人或组织 | skill-creator、Document Skills、claude-api |
| 项目级 | .claude/skills/ 或 monorepo 嵌套目录 |
克隆仓库者共享 | 团队 deploy 流程、API 规范、/run-skill-generator 产物 |
| 社区 | ~/.claude/skills/ 或 npx skills add |
个人跨项目 | handoff、grill-me、Vercel 套件、Firecrawl |
2.1 Capability Uplift vs Encoded Preference
选型时用这个二分法过滤 80% 无效安装:
- Capability Uplift(能力抬升):没装之前 Claude reliably 做不了——例如 Playwright 真浏览器测试、PDF 表单解析、CodeQL 安全扫描。装的是新工具链。
- Encoded Preference(偏好编码):Claude 本来就会,但你要它按团队方式做——例如 Karpathy 四条编码原则、Vercel 57 条 React 性能规则、你们的 PR 描述模板。
反复出现「输出太泛、不像我们团队写的」→ 缺 Encoded Preference;反复出现「根本做不了这个任务」→ 缺 Capability Uplift。
3. 五维对比:入口、执行、上下文、成本、权限
下表用统一表头对比 Skills 与其他扩展方式,避免「Skills vs Rules vs MCP」混谈:
| 方案 | 入口 | 执行能力 | 上下文 | 成本 | 权限边界 | 适合人群 |
|---|---|---|---|---|---|---|
| CLAUDE.md | 每会话自动加载 | 提示级,无脚本 | 全量常驻 | 高 token 固定开销 | 随项目文件 | 短事实、目录说明 |
| Skills | /skill-name 或自动路由 |
SOP + 可选 scripts/ | 渐进式,按需加载 | 低索引 + 命中时展开 | 个人/项目/企业分级 | 重复工作流、团队规范 |
| MCP Server | 工具调用 | 实时 API / DB / Git | 工具结果回注 | API + 往返延迟 | 需显式配置与审批 | 外部系统集成 |
| ECC 全量套具 | Plugin + Hooks | 246+ Skills + 记忆 Hooks | Hooks 跨会话摘要 | 安装与 Hook 配置成本 | 团队需统一 profile | 大团队工程化 |
ECC(Everything Claude Code)属于「套具级」方案,适合想一次到位的企业团队;个人用户更建议本文的 P0–P4 渐进安装。详见 ECC 值不值得用。
4. P0–P4 安装优先级排行榜(决策核心)
这是全文最重要的表——按优先级而非流行度排序:
| 优先级 | 技能 / 组合 | 类型 | 安装方式 | 为什么排这里 |
|---|---|---|---|---|
| P0 | /code-review、/debug、/loop |
bundled | 零安装,直接 /code-review |
覆盖「审代码 → 排错 → 批量重复任务」主链路 |
| P0+ | /run、/verify、/run-skill-generator |
bundled(v2.1.145+) | 复杂项目先跑 /run-skill-generator 录启动配方 |
让 Agent 对着真跑起来的应用验证,而非只看测试绿灯 |
| P1 | skill-creator |
官方 Capability | /plugin marketplace add anthropics/skills |
会装不会写,清单永远停在别人的 GitHub |
| P1 | Document Skills(pdf/docx/xlsx/pptx) | 官方 Capability | 同上 anthropics/skills 仓库 | 真文件读写,不是「假装生成 PDF」 |
| P2 | grill-me、handoff |
社区工作流 | npx skills add mattpocock/skills -y -g |
开工前对齐 + 跨会话/跨 Agent 交接,防上下文腐烂 |
| P2 | superpowers、Karpathy Guidelines |
Encoded Preference | skills.sh 或 GitHub clone 到 ~/.claude/skills/ |
多步 TDD 编排 + 「先想再写」纪律 |
| P3 | Vercel 三件套(React / UX / Composition) | 栈专项 | vercel-labs 官方仓库 | React/Next 团队 ROI 最高 |
| P3 | frontend-design、webapp-testing |
Capability | anthropics/skills + Playwright | UI 质量 + 真浏览器回归 |
| P3 | Trail of Bits Security | Capability | 官方 partner 插件 | CodeQL / Semgrep 漏洞扫描 |
| P4 | Firecrawl、Remotion、Caveman、Context Mode | 场景特化 | 各官方 CLI / skills add | 爬虫、视频代码、省 token、会话恢复——有明确需求再装 |
5. 18 个值得装的技能逐条点评
以下按我们工单与内测中的实际调用频率排序,附一句话决策理由。官方文档入口:Extend Claude with skills。
5.1 P0:bundled 内置(很多人不知道的存在)
/code-review— 结构化审查 diff,比随口问「帮我看看」多一层检查清单。适合每次 PR 前。/debug— 引导系统化排错,避免 Agent 乱改一气。与systematic-debugging社区技能理念一致,但零安装。/loop— 对重复性任务(批量重命名、多文件迁移)做受控循环,比手写 bash for 更安全。/run+/verify— 2026 年 bundled 里最有「产品感」的组合:启动应用并对运行态做验证。复杂 monorepo 先跑/run-skill-generator把数据库、env、多步构建录进.claude/skills/run-*/。/batch— 大批量文件操作的编排入口,适合 codegen 后的机械性收尾。
5.2 P1:官方必装
skill-creator— 交互式生成SKILL.md,降低自写门槛。2026 年最值得装的「元技能」:会创建技能,清单才能随团队进化。- Document Skills — PDF 表单提取、DOCX 批注、XLSX 表格解析。属于 Capability Uplift:没装前 Claude 只能「描述」文档,装后能操作真文件。
5.3 P2:工作流三板斧
grill-me(Matt Pocock)— 开工前「拷问式」对齐计划,逐条消解设计依赖。专治 Agent 带着错误假设猛冲。handoff(Matt Pocock)— 把会话压成结构化 markdown,供新会话或 Codex worktree 接力。上下文到 120k 附近质量下降时,比/compact更适合「换线程继续」。superpowers— 多步子代理 + TDD 纪律,适合中大型功能开发。- Andrej Karpathy Guidelines — 四条规则:先想再写、保持简单、手术式修改、目标驱动。Encoded Preference 典范。
5.4 P3:按技术栈选配
- Vercel Web Design Guidelines — 100+ 条无障碍与 UX 审计规则,适合设计系统团队。
- Vercel React Best Practices — 57 条 React/Next 性能规则,减少「能跑但慢」的 AI 代码。
- Vercel Composition Patterns — 用复合组件替代 boolean prop 地狱。
frontend-design(Anthropic)— 把 UI 从「AI slop」拉到可上线水准。webapp-testing— Playwright 驱动本地应用,E2E 回归自动化。- Trail of Bits Security — CodeQL + Semgrep,安全敏感仓库建议默认启用。
5.5 P4:有明确场景再装
- Firecrawl — 可靠网页抓取与搜索,Agent 需要外网数据时的 Capability Uplift。需 API key。
- Remotion Best Practices — 程序化视频(React)深度知识,仅视频工程团队。
- Caveman — 剥离叙述性废话,平均省约 65% 输出 token;适合长会话省额度。
- Context Mode — 过滤 shell 噪声、会话重置时恢复状态。
code-simplifier— 只改可读性、不动逻辑,适合 PR 合并前收尾。
6. 场景矩阵:你是谁、该装哪一组
| 角色 | P0–P1 | P2 工作流 | P3 栈专项 | 不建议 |
|---|---|---|---|---|
| 独立全栈 | bundled 全套 + skill-creator | grill-me + handoff + Karpathy | frontend-design + webapp-testing | 一次装 ECC full profile |
| React/Next 团队 | 同上 + Document Skills | superpowers | Vercel 三件套 | Remotion(除非做视频) |
| iOS / macOS 工程师 | bundled + /run-skill-generator 录 xcodebuild 配方 |
handoff(长会话必备) | Trail of Bits(若含 C/ObjC 混合代码) | 在 Linux 上装 iOS 相关社区技能 |
| 技术负责人 / 架构师 | skill-creator + 项目级 .claude/skills/ |
grill-me 作为设计评审门禁 | ECC minimal(可选) | 未审计的匿名 Hub 技能 |
| 7×24 Agent 主机 | bundled + handoff 持久化交接文档 | Context Mode | Firecrawl(监控外网变更) | 笔记本合盖当生产机 |
iOS 团队若要把 Skills 与 CI 同机构图,可对照 iOS 18 CI/CD 全链路实践;多 worktree 并行布局见 远程 Mac worktree 短租。
7. 推荐组合(Stack)
三套可直接复制的技能栈——复制到团队 Wiki 即可:
【个人开发者 · 最小栈】
P0: /code-review /debug /run /verify
P1: skill-creator
P2: grill-me → 开工前 | handoff → 会话切换前
安装: npx skills add mattpocock/skills skill=grill-me,handoff -y -g
【React 产品团队栈】
最小栈 +
P3: vercel-react-best-practices vercel-web-design-guidelines
frontend-design webapp-testing
项目级: .claude/skills/deploy/SKILL.md(团队发布 SOP)
【安全敏感后端栈】
最小栈 +
P3: trail-of-bits-security(CodeQL + Semgrep)
P2: Karpathy Guidelines(手术式改动纪律)
禁止: 未审计 scripts/ 的社区技能
8. 六个常见误区
- 误区 1:「Skills 越多越好」 — 索引虽轻,但 description 模糊会导致路由混乱。先固化 P0–P2,再扩展。
- 误区 2:「bundled 不用学,装社区就行」 —
/run、/verify是 2026 年官方主推能力,很多人从未触发过。 - 误区 3:「Skills 可以替代 MCP」 — Skills 教流程;MCP 连实时系统。写代码场景通常二者都要。
- 误区 4:「description 写宽泛一点更容易触发」 — 反效果。应写清「Use when user asks to X」式路由句。
- 误区 5:「装 ECC full 就不用挑了」 — 246 个技能 + Hooks 有学习与冲突成本;个人用 minimal,团队先 PoC。
- 误区 6:「笔记本合盖不影响 Skills」 —
~/.claude/skills/在本地,但长会话、/loop批处理依赖主机在线;生产级 Agent 应放 Cloud Mac。
9. 7 步落地与 48 小时验收
- 确认版本:
claude --version≥ 2.1.145(/run系列需要)。 - 跑通 P0:在真实仓库执行
/code-review与/debug,确认 slash 命令有响应。 - 复杂项目录配方:
/run-skill-generator,把启动命令写入.claude/skills/run-*/并提交 Git。 - 安装 P1:
/plugin marketplace add anthropics/skills,启用skill-creator与 Document Skills。 - 安装 P2:
npx skills add mattpocock/skills skill=grill-me,handoff -y -g;用真实需求走一遍 grill → 实现 → handoff。 - 按栈加 P3:React 团队加 Vercel 三件套;安全团队加 Trail of Bits——每加一个,用一次再留。
- 48h 验收:笔记本合盖 8 小时,从 SSH 重连 Claude Code,确认项目级技能与 handoff 文档仍可访问;若断链,评估 云 Mac 租期选型 迁到 7×24 节点。
10. FAQ
Q:Claude Code Skills 和 Cursor Skills 通用吗?
A:格式上均遵循 Agent Skills 标准,同目录可 symlink 到 ~/.claude/skills/ 与 ~/.cursor/skills/;但 Claude Code 独有的 context: fork、动态 !`command` 注入等扩展在 Cursor 侧行为可能不同,迁移后需实测。
Q:bundled skills 需要安装吗?
A:不需要。除非设置 disableBundledSkills,否则 /code-review、/debug、/loop、/run、/verify 等每会话可用。
Q:.claude/commands/ 和 Skills 什么关系?
A:2026 年已合并——.claude/commands/deploy.md 与 .claude/skills/deploy/SKILL.md 都生成 /deploy,但 Skills 支持附属文件与更丰富 frontmatter,新工作流请用 Skills。
Q:社区 Skills 安全吗?
A:安装前必读完整 SKILL.md 并审计 scripts/ 里的网络调用。优先 anthropics、vercel-labs、trailofbits 等署名源;匿名 skills.sh 条目默认不可信。
Q:项目级技能会进 Git 吗?
A:.claude/skills/ 应纳入版本控制,团队克隆即共享;个人偏好放 ~/.claude/skills/。monorepo 可在子包放嵌套技能(如 apps/web:deploy)。
11. 总结
2026 年 Claude Code Skills 排行榜的本质,是一张「工作流缺口 → 安装顺序」地图,而不是 GitHub Star 榜单。 P0 bundled 零成本却常被忽视;P1 的 skill-creator 决定你能不能自建技能;P2 的 grill-me 与 handoff 解决 Agent 工程里最难的「对齐」与「交接」;P3 以后才按 React、安全、爬虫等栈叠加。记住那句非对称结论:模型能力不是分水岭,可路由的工作流入口才是。
在 Cloud Mac 上常驻 Claude Code + Skills
Claude Code Skills 的价值在「重复触发」——~/.claude/skills/、项目级 .claude/skills/ 与 MCP 配置都需要一台7×24 在线、路径稳定的 macOS 主机。笔记本合盖会断连长会话;M4 统一内存让本地模型推断与多 worktree 并行更从容;macOS 原生 Unix 环境也让 /run-skill-generator 录下的启动配方在 CI 与同机构图里可直接复用。
如果你正在把 Agent 工作流从「本机偶发」迁到「团队常驻」,kvmboot 云端 Mac mini M4 支持 48 小时日租验收—— 立即了解套餐方案, 先跑通 P0–P2 技能栈,满意再升月租锁基线。