Claude Code Skills：安装现成技能并创建自己的技能
Neaptide · 2026年9月20日 · 8 分钟阅读
从文件夹或插件安装 Claude Code Skills，编写 SKILL.md，并通过表单审查示例检查技能输出。
本文目录
重复任务往往逐渐形成固定顺序：先读相关文件，再检查条件，最后按明确格式报告结果。如果你经常让 Claude Code 审查表单、写修改说明或分析构建错误，就可以把流程整理成技能。
Skill 是一个包含 SKILL.md 指令文件及可选辅助资料的文件夹。 它把可重复执行的流程与示例、辅助文件放在一起。Agent Skills 规范介绍了格式。
本文介绍本地 Claude Code 的安装方法，并创建一个咨询表单审查示例。命令已与文档核对；示例不是在真实网站上完成测试的报告。
哪种任务适合做成 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`。官方 README。
文件夹与插件是不同分发方式。GitHub 上的单独 SKILL.md 不会自动变成可安装插件，应先确认作者是否提供市场包。
阅读安装提示。如果需要激活，运行 `/reload-plugins`；错误可在 `/plugin` 查看。安装范围决定插件是个人使用、项目共享，还是仅对你在该项目中可用。插件安装。
使用他人技能前检查什么
首次运行前阅读 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. 对照测试核查结论。存在测试不表示已运行或通过。
## 报告
每个问题注明：
- 文件与代码位置；
- 触发条件；
- 对用户的潜在影响；
- 建议的验证或修复方式。
单独列出必须运行应用才能确认的行为。
没有发现明确问题时，如实说明，但不要声称表单已全面测试。开头的 `---` 之间是元数据，后面是流程。开放规范要求 `name` 和 `description`，名称与目录一致。本例使用小写拉丁字母和连字符。SKILL.md 格式。
`disable-model-invocation: true` 是 Claude Code 的手动调用设置，本例用它明确启动时机。“只读”描述行为，技术权限需单独配置。调用控制、权限。
调用并检查结果
在 Claude Code 中打开项目后输入：
/form-review 检查 src/components/LeadForm.tsx 中的咨询表单路径只是示例，应换成实际文件。直接调用格式为 `/技能名称`。调用 Skills。
选择一个已知存在某种行为的表单，例如再次点击后错误消息立即消失。检查智能体能否发现该行为，并指出代码原因。
按四点评价：
- 引用真实文件与具体实现位置。
- 每条问题都有触发条件。
- 假设与代码支持的结论分开。
- 没有把阅读测试说成成功运行测试。
如果输出只是通用建议，就加强证据要求：“未指出相关实现位置前，不要加入建议。”再对同一表单运行。
每次只改一项重要指令，便于判断哪个变化改善了结果。这是建议的编辑方法，不是在声明本例技能已经实测。
怎样描述自动选择条件
需要自动选择时，同时描述动作和使用场合。比较：
帮助开发应用。
与：
发布前审查咨询表单，检查字段校验、错误提示及提交状态。用于表单审查请求，不用于整体架构评估。
后者边界更明确。规范也建议在描述中说明做什么、何时使用。description 要求。
本例关闭了自动选择。如果启用，应分别试合适请求、相近主题和无关请求。观察实际选择，比只凭文字是否顺耳更有用。
技能不显示或不触发怎么办
先检查路径、准确文件名和 YAML 开头；`---` 必须是第一行。如果会话开始后才创建顶层 `.claude/skills/`，请重启 Claude Code。编辑与加载。
区分两种情况：直接调用找不到，检查安装；手动能调用却不会自动选中，检查调用模式和描述。
个人技能与项目技能同名时，Claude Code 优先个人技能。结果异常时检查两处目录。同名处理。