Claude Code Skills：安装现成技能并创建自己的技能
Neaptide · 2026年9月20日 · 8 分钟阅读 · 更新于: 2026年10月3日
从文件夹或插件安装 Claude Code Skills，编写 SKILL.md，并通过表单审查示例检查技能输出。
本文目录
如果你经常让 Claude Code 审查表单、写修改说明或排查构建错误，这些任务做多了就会有固定的顺序：先读相关文件，再检查条件，最后用清楚的格式交出结果。这套顺序可以写成一个技能，一次写好，以后直接用。
Skill（技能）是一个文件夹，里面有写着指令的 SKILL.md，需要时还可以放辅助资料。智能体拿到的是一套可以重复执行的流程，连同示例和辅助文件。格式见 Agent Skills 规范。
本文讲怎样在本地 Claude Code 中安装技能，并动手写一个审查咨询表单的教学技能。文中命令已于 2026 年 10 月 3 日对照官方文档核对。示例仅用于教学，不是在真实网站上的测试报告。
哪种任务适合做成 Skill
选一个你已经能说清楚的流程，例如：“交付表单前，检查必填字段、错误提示和提交行为，再列出问题。”
第一个技能这样选，比笼统的“做高质量网站”合适得多。表单检查有输入、有步骤，结果也能评判。
| 工作任务 | 技能中保存什么 | 预期结果 |
|---|---|---|
| 表单审查 | 输入场景与检查顺序 | 问题及未核实条件 |
| 修改说明 | 结构与细节取舍标准 | 符合实际 diff 的草稿 |
| 构建错误分析 | 日志阅读与排查顺序 | 有依据的原因或剩余假设 |
| 文章发布准备 | 编辑要求与链接检查 | 具体修改清单 |
先从表中的一行做起。一个技能如果又开发网站、又写广告、又配置服务器、还负责发布，出了问题就很难查是哪一步的毛病。
从文件夹安装技能
个人技能放在 `~/.claude/skills/`，项目技能放在仓库内的 `.claude/skills/`。每个技能有自己的文件夹和 SKILL.md。个人技能在这台机器的所有项目里都能用，项目技能则跟着代码一起保存。
project/
└── .claude/
└── skills/
└── form-review/
├── SKILL.md
└── references/
└── checklist.md如果下载的是技能合集，找到需要的那个技能，把整个文件夹复制过去。只复制 SKILL.md，其中引用的辅助资料可能就找不到了。
检查最终的目录结构。解压时常见的错误是多出一层：
.claude/skills/form-review/form-review/SKILL.md在本例中，文件应当再往上一层：
.claude/skills/form-review/SKILL.md复制前先看有没有同名文件夹。如果有，先比较两个版本，以免覆盖自己的修改。
通过插件安装
如果作者以插件形式分发技能，就按他的安装说明来。Anthropic 官方仓库的命令如下，需要在 Claude Code 里输入：
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills第一条命令添加市场，第二条安装示例技能。处理文档的技能在同一仓库里，名为 `document-skills@anthropic-agent-skills`。
文件夹和插件是两种不同的分发方式。在 GitHub 上找到的单个 SKILL.md 不能用 `/plugin install` 安装，先确认作者有没有提供市场包。
`/plugin install` 会打开插件详情页，在那里选择安装范围：个人所有项目可用、仓库的所有协作者可用，或者只有你在这个仓库中可用。装完后看一下安装摘要。需要重新加载时，Claude Code 一般会自己执行 `/reload-plugins`。如果插件加载失败，原因在 `/plugin` 的 Errors 标签页里。
使用他人技能前检查什么
第一次运行前，先读 SKILL.md 和附带的脚本，看它们做的事和任务是否对得上。一个用来审查表单的技能，却要把仓库内容发到外部服务器，这就需要作者给出解释。
记下技能的来源、所用的版本和你改过的地方。以后更新导致结果变化时，才有东西可以对照。
还要看作者默认了哪些前提。他写技能时可能针对某个框架、某套命令或某个浏览器工具，而你的项目里并没有。这些地方要换成自己的做法。“到处都能用”这种话，哪个技能也保证不了。
创建表单审查 Skill
我们的技能只读表单的实现，然后写出报告。它不改代码，也不提交咨询，这样找问题和修问题就分开了。
在编辑器里创建 `.claude/skills/form-review/` 目录。在 macOS、Linux 或 WSL 上也可以用终端：
mkdir -p .claude/skills/form-review然后在其中新建 SKILL.md，内容如下。这是教学示例，需要按自己的项目调整。
---
name: form-review
description: 审阅咨询表单实现，报告校验、消息与提交方面的问题。用于发布前的表单审查。
disable-model-invocation: true
---
# 咨询表单审查
## 目标
寻找实现错误，并指出还需要检查什么。
仅阅读文件。不要修改代码、提交表单或访问外部服务。
## 输入
需要表单路径或用户流程名称。
如果匹配多个表单，先确认审查哪一个。
## 步骤
1. 阅读表单组件、处理函数和相关测试。
2. 找到必填字段及校验规则。
3. 从代码检查空值和无效邮箱的处理。
4. 跟踪提交中、成功和错误状态。
5. 检查提交时重复点击是否被明确处理；
如不清楚，说明不确定性。
6. 对照测试核查结论。存在测试不表示已运行或通过。
## 报告
每个问题注明：
- 文件与代码位置；
- 触发条件；
- 对用户的潜在影响；
- 建议的验证或修复方式。
单独列出必须运行应用才能确认的行为。
没有发现明确问题时，如实说明，但不要声称表单已全面测试。文件开头两行 `---` 之间是元数据，下面是流程本身。开放的 Agent Skills 规范要求必须有 `name` 和 `description`，并且名称要与文件夹名一致。Claude Code 自身更宽松：所有字段都是可选的，只建议填写 `description`。名称可以用小写拉丁字母、数字和连字符。
`disable-model-invocation: true` 是 Claude Code 的设置：加上它，技能只能手动调用，Claude 不会自行加载。本例用它来保证每次审查都由明确的命令启动。指令里写的“只读”说的是行为，技术上的访问权限要另外配置。
调用并检查结果
在 Claude Code 中打开项目，输入：
/form-review 检查 src/components/LeadForm.tsx 中的咨询表单这里的路径只是示例，请换成项目里真实存在的文件。直接调用技能的写法是 `/技能名称`。
检验技能时，选一个你已经知道毛病的表单。比如，提交失败的错误提示在再次点击按钮后立刻消失。看智能体能不能发现这一点，并在代码里指出原因。
从四个方面评判报告：
- 引用的文件确实存在，并指明了具体的实现位置。
- 每条问题都写明了在什么条件下出现。
- 推测和有代码依据的结论分开写。
- 读过测试不等于跑通测试，报告没有把两者混为一谈。
如果得到的是一长串泛泛的建议，就把对证据的要求提高。例如加上一句：“未指出相关实现位置前，不要加入建议。”然后在同一个表单上再跑一遍。
每次只改指令中的一处要点，否则分不清是哪次修改让回答变得更有用。这里讲的是编辑上的检验方法，本文没有给出该技能的任何测试结果。
怎样描述自动选择条件
如果希望技能被自动选中，描述里要同时写清它做什么、什么时候用。比较一下：
帮助开发应用。
以及更准确的写法：
发布前审查咨询表单，检查字段校验、错误提示及提交状态。用于表单审查请求，不用于整体架构评估。
第二种写法有明确的边界，智能体把它用到无关任务上的可能性也更小。规范同样建议在 `description` 中写明技能做什么、何时使用。
本例关闭了自动选择。如果要打开，先用几种请求试一试描述：合适的、意思相近的、明显无关的。实际看它怎么选，比只凭感觉推敲措辞可靠。
技能不显示或不触发怎么办
先检查路径、SKILL.md 的准确文件名和 YAML 块的开头：`---` 必须是第一行。对已有技能文件夹的修改，Claude Code 在会话中就能识别。如果顶层目录 `.claude/skills/` 是在会话开始后才创建的，请运行 `/reload-skills`。
再区分两种情况。直接调用时找不到技能，检查安装。手动能调用，但智能体从不自己选它，就检查调用模式和描述。
个人技能和项目技能同名时，Claude Code 运行的是个人技能。结果出乎意料时，两个目录都要看一看。