跳转到主要内容

Claude Code Skills 推荐:先用哪个、怎么安装与确认生效

查代码 bug 先用 /code-review,整理代码用 /simplify;界面设计、浏览器测试和文档处理再按需选择官方技能。安装后先确认名称与作用范围,再用一个小任务检查结果。

LaoZhang AI Team发布于更新于 21 分钟阅读
文章目录
Claude Code 技能起步示意:先用内置技能,再按浏览器测试、文档处理或团队流程选择

Claude Code 最值得先用的 Skills,取决于你今天要完成什么。查当前代码变更里的 bug,先用内置 /code-review;整理重复、复杂或低效代码,用 /simplify;要做界面设计、浏览器测试或办公文件处理,再补对应的官方技能。 如果同一套团队流程已经反复使用,才值得做成仓库自定义 skill。

不必先装一份“必装排行榜”。一个技能是否值得保留,要看它能不能让你完成具体任务:找出可复现的问题、验证页面交互、产出可打开的文件,或者按团队约定完成检查。安装量与 GitHub 星数可以帮你发现候选,却不能代替这些结果。

以下功能与安装方式按 2026 年 10 月 12 日的 Claude Code 官方文档及 Anthropic Skills 仓库说明整理。命令和任务示例供读者使用,本文没有在 Claude Code 中实际安装或运行这些技能,也不把文档能力当成效果实测。

先用内置技能,把任务和入口对上

内置技能已经随 Claude Code 提供,不需要先添加 marketplace。它们给 Claude 一套处理任务的方法,由 Claude 结合可用工具执行;与直接切换设置的内置命令不同。当前官方文档包含更多技能,旧清单里的“只有五个”已不适合作为选择依据。实际可见入口仍受版本、平台、套餐和环境影响,先在自己的会话输入 / 查看。官方命令参考

眼前的任务可以先用什么调用前要分清什么
检查当前 diff、某个路径或 PR 有没有正确性 bug/code-review默认做审查;加 --fix 会应用修复,--comment 会把结果发到 PR 或合并请求
刚完成修改,想减少重复、简化实现/simplify会审查并应用整理,不负责查正确性 bug
看见应用修改后的实际行为/run,需要确认变更时用 /verify会启动、操作应用;测试通过并不等于页面行为已确认
排查 Claude Code 会话运行异常/debug若此前未开启调试日志,从调用时开始记录,不能补回过去的日志
在会话里定期重复一条提示/loop会话必须保持打开;不是退出后仍永久运行的后台定时器
实现或排查 Anthropic API、SDK 代码/claude-api提供相应参考;代码导入 anthropic 或 @anthropic-ai/sdk 时也可自动触发
一项大规模改造能拆成互不依赖的工作/batch会规划并行工作、使用隔离 worktree,随后执行和发布变更;先明确允许修改与发布的范围

这张表是按任务挑入口,不是所有内置技能的目录;各项行为见当前官方命令说明。例如,你只想检查一次提交是否引入 bug,就从 /code-review 开始,而不要用会直接修改代码的 /simplify 来代替审查。

/run 和 /verify 也值得先尝试。它们会从项目内容推断启动方式;如果应用依赖数据库、环境配置或多步构建,可以考虑 /run-skill-generator 记录项目启动方法。它会写入并提交项目技能,因此适合已经明确允许保存该配置的场景。/verify 在需要摸索启动步骤时也可能写下自己的方法,项目根目录中同名技能会替代内置 /verify。运行与验证应用的说明

需要补技能时,按工作流选官方候选

Anthropic 的 anthropics/skills 仓库提供技能示例和文档技能。README 给出 example-skills 与 document-skills 两套安装入口;这不等于整个市场只有两个包,也不需要把包总数当成选型标准。仓库明确说明这些内容用于演示和学习,实际环境仍需验证。

按浏览器测试、Anthropic API、文档处理和团队重复流程选择技能的示意图

写界面:选 frontend-design;验交互:选 webapp-testing

如果你缺的是视觉方向、字体层次、布局和符合产品内容的界面表达,可以先看 frontend-design。它要求围绕真实主题与设计需求制定方案,再构建和检查界面。给它“做一个好看的首页”仍然太宽;说明产品、受众、主要动作、已有组件和设计限制,会更容易判断产物是否满足需求。

如果页面已经做出来,缺的是“按钮点下去到底有没有用”,则 webapp-testing 更对题。它提供基于 Python Playwright 的本地 Web 应用测试方法,涉及渲染后的页面、交互、截图与浏览器日志,也有管理服务启动的辅助脚本。

两者不能相互替代:设计技能帮助决定页面怎么表达,测试技能帮助检查页面实际怎么运行。测试技能安装成功,也不会自动准备好项目依赖、浏览器运行环境、测试账户或数据库。

可以把第一次任务缩小为:在本地测试页面提交一次空表单,确认错误提示出现,而且没有跳到成功页。 给出测试 URL、启动方式与预期提示,让结果包含实际操作、观察到的行为,以及必要的截图或日志。这样,“没有发现问题”和“根本没跑起来”就不会混在一起。这个任务是使用建议,并非本文已完成的测试。

处理文件:选 document-skills,并检查输出文件

主要任务是 PDF、Word、PowerPoint 或 Excel 文件时,先选 document-skills。官方仓库包含 pdf、docx、pptx 和 xlsx,README 也直接展示了让 Claude 使用 PDF 技能提取表单字段的请求方式。官方仓库说明

第一项工作可以选一个不含敏感信息的小文件,例如提取 PDF 表单字段并列出字段名称。确认处理的是你指定的文件,输出能与原件对照;生成或编辑办公文件时,还应实际打开结果,检查内容和文件可用性。Claude 说“已完成”不能代替这些检查。

这些文档技能的许可与仓库里许多 Apache 2.0 示例不同:README 将它们标为 source-available,非开源。需要复制、修改或分发时,查看对应许可,而不要把“官方公开仓库”理解成所有文件采用同一种许可证。许可说明

要开发 MCP 服务:选 mcp-builder;已有服务接入是另一件事

mcp-builder 面向开发 MCP 服务:理解目标 API 和协议、设计工具参数与返回内容、处理认证、分页和错误,再构建、测试与评估。它适合你正在写一个服务,需要把外部系统能力提供给模型的场景。

如果只是希望 Claude 读取已经存在的数据库或工单系统,你需要先具备相应连接、凭据与权限。技能可以指导如何使用工具,不能凭空产生已认证的 MCP 连接。不要因装了 mcp-builder 就期待私有数据自动变得可读。

团队流程反复出现:再用 skill-creator 做自己的技能

skill-creator 用来创建和改进技能,包含明确任务、编写说明、设计真实请求和比较输出的方法。它适合“每次审查迁移都要重新贴同一套步骤”这样的稳定流程。

自定义 skill 的基本资产是一个目录中的 SKILL.md;需要时再附带 scripts/、references/ 和 assets/。个人目录适合自己在多个本地项目复用,仓库目录适合团队共同维护。描述写清“做什么、什么时候用”,正文写步骤、输入、输出和停止条件,比给它起一个很厉害的名字更有用。官方技能创建与加载说明

如果还在反复改变流程,先把一次任务做清楚,再抽取重复部分。不要把尚未稳定的判断写成一套永远自动触发的规则。需要最小配置示例和机制选择时,可继续看Claude Code Hooks、Skills 与斜杠命令的区别和配置。

官方技能怎么安装:先添加市场,再选择作用范围

下面以 Anthropic README 中的示例包为例。前提是 Claude Code 本身可正常启动、能够访问仓库,且组织策略允许使用该插件来源。命令输入在 Claude Code 交互会话中,不是在普通终端直接输入带 / 的命令。README 安装入口

先添加市场:

/plugin marketplace add anthropics/skills

添加成功会显示市场名称;此仓库文档使用的是 anthropic-agent-skills。然后按任务选择其中一个包,例如:

/plugin install example-skills@anthropic-agent-skills

处理文档则使用:

/plugin install document-skills@anthropic-agent-skills

当前交互式 /plugin install 会先打开插件详情面板,让你查看组件并选择作用范围;输入命令并不表示已经安装完成。 面板可能列出 skills、agents、hooks、MCP 或 LSP 服务,也可能说明组件将在安装时发现。看清实际内容后再选范围。当前插件安装流程

面板选项影响范围适合怎样的起步
Install for you(user)本机上的个人项目你确实需要跨项目复用
Install for all collaborators on this repository(project)仓库共享配置团队已同意共同使用
Install for you, in this repo only(local)自己在当前仓库使用先在一个项目试用

范围规则见官方 scope 说明。提交 project 配置会为协作者启用插件,但不会自动把插件下载到每个人的电脑;其他协作者仍需要安装。

如果你在普通终端使用 shell 命令,形式不同,且 install 默认是 user 范围。只想在本仓库个人试用时,要明确指定 local,例如:

bash
claude plugin marketplace add anthropics/skills
claude plugin install example-skills@anthropic-agent-skills --scope local

这是官方 shell 安装形式的示例,不是本文执行记录。shell 安装与加载时间

安装摘要才是下一步判断依据:显示 Plugin is now active 可继续确认;提示服务需要配置,先补齐相应配置;提示 Run /reload-plugins to apply,说明当前会话仍有待加载变更;加载失败则到 /plugin 的 Errors 页查看原因。需要 --force 时先读提示,它可能使提示缓存失效,产生一次未缓存请求,没必要把强制重载作为固定步骤。安装状态说明

怎么确认技能生效,而不只看“已安装”

先确认 Claude 能找到正确技能,再确认 任务确实完成。两件事分开查,会比不断重新安装更有效。

  1. 打开 /plugin 的 Installed 页,核对插件名称、启用状态与安装范围。普通终端的 claude plugin list 也会列出 Version、Scope 和 Status。
  2. 在会话输入 /,查实际技能入口;插件技能通常带命名空间,形式是 /插件名:技能名。例如示例包里的测试技能应按菜单中显示的完整名称调用,而不是只凭短名猜来源。
  3. 指定一个输入清楚、范围有限的任务,明确要求使用该技能。可以使用菜单里的完整调用名,也可用 README 展示的方式,在请求里点明技能名称。
  4. 检查结果:读取了哪个文件、操作了哪个页面、生成了什么产物、是否满足预期。若工具或依赖不足,先处理具体缺项,不把它记作技能已完成工作。

插件名称、命名空间与确认入口见官方安装确认步骤。本地自定义技能则可用 /skills 查看名称、描述与来源;手动调用能正常运行后,再判断自然语言请求是否会触发它。技能调用说明

例如,团队把变更审查做成自定义技能,第一次不必审整个仓库。挑一处已知的小改动,要求输出变更摘要、影响文件和待验证项;对照实际 diff。任务结果符合要求后,再换一句自然说法测试触发描述。这样能区分“技能未被发现”“描述没有匹配”和“方法本身不合适”。

技能不显示、不触发或用错了,按症状排查

插件已安装,但 / 菜单里找不到

先看 /plugin 的 Installed 和 Errors 页:它是否启用,是否仍等待加载,是否安装在当前项目会使用的范围。插件更新后,磁盘上的新版本不代表当前会话已加载,按提示使用 /reload-plugins。插件管理与更新

接着按完整命名空间查找。插件 skill 可以与个人或项目里的同名 skill 并存;短名不一定指向你想用的那个。对于个人和项目自定义技能,同名时的优先级是 enterprise、personal、project;自定义技能还可能替代内置同名入口。因此“调用了同一个名字”不等于“用了同一份说明”。名称冲突规则

自定义 skill 能手动调用,却不会自动触发

先看 description 是否清楚写了任务和适用情境。disable-model-invocation: true 本来就禁止 Claude 自主调用;user-invocable: false 则是相反方向,会隐藏手动入口。不要只为了让它出现就删掉有意设置的调用限制。调用控制

还要检查 YAML:文件第一行应为 ---,字段名使用官方定义的拼写。YAML 解析失败时,正文仍可能加载,但描述等元数据为空,这会造成“手动能用、自动不匹配”。官方提供 claude plugin validate 检查技能目录,要求 Claude Code v2.1.233 或以上。官方排障说明

刚新建目录,或改了文件,却没有变化

当前 Claude Code 通常会在会话中检测 SKILL.md 的更改,不必每次重启;bare mode 是例外。如果启动时顶层 skills 目录不存在,后来才建立,需要 /reload-skills 重新扫描。插件中 hooks、MCP、agents 等组件的更改,则需要 /reload-plugins,不能用技能正文的实时检测代替。会话中修改技能

还有目录范围问题:从仓库上层启动时,嵌套目录中的技能不一定立即加载,要等 Claude 在该子目录工作后才出现。个人本机目录的技能也不会自动出现在 Cowork 或云端会话中;项目技能与账户同步是不同的来源。加载位置说明

技能加载了,但任务仍然做不了

检查缺的是工具、项目依赖、文件访问、连接还是凭据。webapp-testing 不能代替可运行的浏览器环境,文档技能不能代替输入文件,MCP 方法说明也不能代替外部系统权限。先补实际依赖,再重做同一个小任务,结果才具有可比性。

不要把 allowed-tools 当成工具白名单或隔离保证:在当前原生 Claude Code 中,它为列出的工具提供调用该技能这一轮的免询问授权,其他工具仍受权限设置控制;下一条用户消息会清除这项临时授权。组织的受管权限策略还可能忽略该字段。官方工具授权说明

什么时候该停止加 skill

项目长期上下文、事件检查、技能方法、代理分工和外部工具访问的分工示意

如果你总要重新解释项目结构和长期约定,把简洁、持续适用的背景放在 CLAUDE.md 更合适。若某个事件发生时必须执行检查,用 hooks;如果需要独立上下文和专门分工,用 subagents;如果缺的是外部系统访问,先解决工具或 MCP 连接。技能适合复用方法,但不会自动替代这些机制。具体配置关系见Hooks、Skills 与斜杠命令指南。

对于已经不用的插件,先从 /plugin 的 Installed 页停用,再按原安装范围决定是否卸载。尤其是仓库共享插件,卸载面板会区分仅为自己停用和为所有协作者卸载;普通终端的 uninstall 默认 user 范围,不能想当然地撤销 project 安装。停用或卸载也不会撤销它之前改过的文件、发出的消息或其他操作。插件管理与卸载规则

常见问题

Claude Code 有哪些必装 Skills?

没有对所有工作都成立的必装名单。查 bug、整理代码、运行应用和 Anthropic API 开发,可以先用相应内置技能;需要界面设计或本地浏览器测试,再看 example-skills 中的候选;文件处理看 document-skills。这些选择依据是官方声明的用途,不是本文测出的名次。

Skills 和斜杠命令有什么区别?

Skills 可以通过 /技能名 手动调用,也可以在相关任务中由 Claude 加载。官方已经将自定义 commands 合并到 skills,旧 .claude/commands/ 文件仍可用;但 /help 等内置命令并不因此变成技能。“命令只能手动、技能只能自动”并不准确。官方 Skills 说明

装更多 Skills 会不会占用上下文?

会有成本。技能正文按需加载,但名称和描述用于发现技能;调用后的正文会进入上下文,并在后续轮次保留。技能很多时,描述可能因预算而被删减,影响自动匹配。可以查看 /context,支持相应功能的版本也可用 /skill-doctor;不要用“只加载一次”推断可以无限安装。技能内容与排障说明

中文使用需要专门的中文 skill 吗?

不一定。先说明你希望输出中文,以及项目术语、格式和读者对象,再判断现有技能是否完成了任务。只有中文审查、文案或文档规范已经成为稳定的重复流程,才有理由把它整理为自己的技能;“名称写中文”本身不能证明更适合你的代码库。

同一个 SKILL.md 能直接用于 Claude.ai 或其他工具吗?

通用 Agent Skills 字段和 Claude Code 扩展字段要分开看。Claude Code 接受的调用控制、子代理和动态上下文功能,不会自动在 Claude.ai 上传或 API 使用中获得同样行为;不受支持的 frontmatter 字段还可能导致上传或打包失败。跨工具复用前,核对目标入口的规范。官方跨产品 frontmatter 说明

参考来源8

本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月12日。

  1. 1.Claude Code 官方文档code.claude.com/docs/en/skills
  2. 2.Anthropic Skills 仓库github.com/anthropics/skills
  3. 3.官方命令参考code.claude.com/docs/en/commands
  4. 4.frontend-designgithub.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md
  5. 5.webapp-testinggithub.com/anthropics/skills/blob/main/skills/webapp-testing/SKILL.md
  6. 6.mcp-buildergithub.com/anthropics/skills/blob/main/skills/mcp-builder/SKILL.md
  7. 7.skill-creatorgithub.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
  8. 8.当前插件安装流程code.claude.com/docs/en/discover-plugins
更多 Claude Code