如果你已经在用 Claude Code 写业务代码,却还在每次对话里重复「按我们團隊的 PR 规范」「先跑 lint 再提交」,那 2026 年最值得补的一层就是 Agent Skills:把流程写进可版本化的 SKILL.md,让 Agent 按需加载,而不是把整本手册塞进上下文。上半年我们做过一份Skills 倉庫總覽;到了 10 月,GitHub 上的官方插件、社群清單和配套 CLI 又多了不少「装好就能省时间」的选项。本文按好用程度 × 维护活跃度重新整理,并补上 Cursor 互通、MCP 分工与 Mac / 雲端開發機上的安裝習慣。
Skills 是什么,和 Prompt / Rules 差在哪?
一个 Skill 是带 YAML frontmatter 的目錄,核心是 SKILL.md。Claude Code 在發現阶段只读 name/description,确认相关后再读正文——这叫渐进式披露,比把 200 行规范写进 CLAUDE.md 更省 token,也更稳定。
| 机制 | 适合写什么 | 典型路径 |
|---|---|---|
| CLAUDE.md / AGENTS.md | 倉庫级事实:构建命令、目錄约定 | 倉庫根目錄 |
| Skills | 可复用工作流:發版、稽核、写部落格、拆 PR | ~/.claude/skills 或 .claude/skills |
| MCP | 外部系统工具面:Issue、DB、浏览器 | 客户端 MCP 配置 |
| Hooks | 确定性自动化:保存后跑 formatter | .claude/settings.json |
和 Graphify + OpenCode 的结构记忆 不同,Skills 解决的是「怎么做对」,不是「代码在哪」。两者可以同时装:先 query 图谱定位模块,再 invoke「iOS 發版检查」skill 跑清單。
2026 分層推荐:必装、按角色、觀望
下面默认你使用 Claude Code 终端(或 IDE 集成),且能访问 GitHub。星级会变动,以倉庫最近提交与 issue 活跃度为准。
官方与市场插件
1. anthropics/skills — 仍然的第一站
Apache 2.0 / 部分 document 类为 source-available。通过插件市场安裝,而不是盲目 clone 整庫:
# 在 Claude Code 內
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
好用在哪:document-skills 覆盖 PDF/Office 解析等企业常见需求;example-skills 是学 frontmatter 与目錄结构的范本。需要处理合同、說明书、发票的 iOS / 全栈團隊,几乎都应先装 document 包。
2. anthropics/claude-plugins-official — skill-creator
用对话生成、对比、打包自定义 skill,适合把「Flutter 国际化审查」「App Store 截图检查」写成團隊标准件。2026 年社群里大量高质量 skill 都来自「creator 起草 + 人工删冗余」这条路径。
3. anthropics/claude-code 內 plugins/plugin-dev/skills
面向要写 slash command、插件 manifest 的高级用户。若你在 CI 里封装「自动 bump + tag + 通知」,这里的模式比从零写 prompt 可靠。
GitHub 社群清單与专题倉庫
4. travisvn/awesome-claude-skills — 發現入口,不整庫安裝
按类别收录教程与第三方 skill 链接。建议每周扫一次,只 star + 按需複製单目錄,避免把 awesome 列表里每一个都丢进 ~/.claude/skills。
5. developmentseed/skills — 多 IDE 目錄范例
文档同时列出 Claude Code、Codex CLI、Gemini CLI、Cursor 的安裝路径,适合「一份 skill、多人多客户端」的團隊。GIS 业务不一定相关,但倉庫布局值得抄。
6. agentskills/agentskills — 规范源
关注 allowed-tools、互操作表与 frontmatter 变更。写跨 Cursor / Copilot 的 skill 前先看一眼,能减少「在 Claude 能用、在 Cursor 被忽略字段」的返工。
按角色可加的单体 skill(从官方 example 或社群 fork)
- 安全 / 合规:依赖稽核、密钥扫描类 skill(invoke 前约束「只读 diff」)
- 协作:拆 PR、写 changelog、对齐 conventional commits
- 內容:技术部落格/HTML 發布检查(与静态站倉庫约定结合)
- Apple 栈:把 scheme、
xcodebuild、Fastlane lane 写进 project-level skill,配合Claude Code 訂閱与长上下文控制成本
不只 Skills:值得裝的 GitHub 配套工具
Skills 管流程,下面这些管可观测性、自动化与分发:
anthropics/claude-code-action:在 GitHub Actions 里跑 Claude Code,适合「PR 上自动审查 / 修 lint」——skill 定义审查步骤,Action 提供运行环境。- 用量与成本 CLI(社群):例如跟踪 token / 会话成本的
ccusage一类工具,长会话 + 多 skill 时用来發現「哪个 workflow 最烧额度」。 - 團隊 skill 倉庫:独立 git 仓或 monorepo 子目錄 + submodule;比每人手动 scp 到雲端 Mac 可维护。
若你还在对比终端 Agent 选型,可结合Claude Code 替代工具 2026;IDE 侧则可把同一套 skill 同步到 ~/.cursor/skills(见下节)。
安裝清單(macOS / 雲端 Mac)
- 确认 Claude Code ≥ 2.1(skill 熱重載、插件市场)。
- 安裝官方
document-skills+example-skills(见上文命令)。 - 在目标倉庫添加
.claude/skills/<your-skill>/SKILL.md,把构建/發版參數写进正文。 - 驗證:在倉庫根运行
claude,询问「列出可用 skills」或对文档样例执行一次 document skill。 - 雲端 Mac:持久化
~/.claude;或在 post-checkout hook 里rsync團隊 skill 仓。避免無狀態实例每次丟失全局 skill。
iOS / Flutter 團隊提示
把「真机调试、签名、上传 TestFlight」写成 project skill,并注明 Xcode 版本与 scheme。Agent 在 Zilmac 一类雲端 Mac 上与 Xcode 同机时,比 SSH 来回传文件更少误判。跨平台记忆层(Mem0 等)与 Skills 分工见Agent Memory 橫向評測。
与 Cursor Skills、MCP 怎么搭配
二者都遵循 Agent Skills 标准:Claude Code 读 ~/.claude/skills 与 .claude/skills;Cursor 读 ~/.cursor/skills 与 .cursor/skills。同一目錄可複製两份,或用符號連結(注意 Claude 独有 frontmatter 擴充在 Cursor 会被忽略)。
MCP 则连接 Linear、Sentry、浏览器等。推荐约定:skill 正文写「开 PR 前必须跑 npm test」;MCP 负责「创建 PR / 拉取 issue」。不要把 MCP 服务器描述写成第二份 skill 百科全书。
治理:别装成「技能垃圾場」
- 命名:一个 skill 一个动词短语(
ios-release-check),description 写清触发条件。 - 权限:善用
allowed-tools,限制高危 shell。 - 评审:團隊 skill 走 PR,和代码同权。
- 退役:季度清理未 invoke 的 skill;awesome 里「收藏」不等於「安裝」。
做好这四条,比再装十个 GitHub 倉庫更能提升 Agent 稳定性。
常见问题
Claude Code 一次应该装多少个 Skills?
全局 5–8 个高频即可,项目级再加 2–3 个。过多 skill 会拉长發現阶段;先官方包,再按角色增补。
GitHub 倉庫可以直接 clone 到 ~/.claude/skills 吗?
可以,但只複製需要的子目錄更安全;官方市场包优先于整庫 clone。
Skills 和 MCP 如何分工?
Skills = 流程与清單;MCP = 外部 API/工具。长文档放 skill,动态数据走 MCP。
远程 Mac 上改 skill 要重启吗?
2.1+ 通常支持熱重載;确保 skill 目錄在持久化卷或倉庫內。
小結:2026 年 GitHub 上「值得裝」的,首先是 anthropics/skills 官方插件包 + skill-creator,其次是用 awesome 列表做發現、用独立仓做團隊流程;配套 claude-code-action 与成本 CLI 把 skill 落到 CI 与账单上。装得少而精,比追逐每一个新倉庫更接近「好用的 AI 程式技能」。