Claude Code Skills 安装使用指南
目录
- 一、什么是 Skills
- 1.1 Skills 简介
- 1.2 Skills vs Slash Commands
- 1.3 为什么需要 Skills
- 二、Skills 核心特点
- 2.1 按需加载
- 2.2 自动热重载
- 2.3 命名空间隔离
- 2.4 标准化格式
- 三、安装 Skills
- 3.1 方式一：自然语言安装
- 3.2 方式二：手动安装
- 3.3 方式三：插件市场安装
- 3.4 重要提示
- 四、Skills 存放位置
- 4.1 三种存储位置
- 4.2 核心原则
- 五、插件 Skills
- 5.1 插件 Skills 特点
- 5.2 手动 Skills vs 插件 Skills
- 六、常用 Skills 推荐
- 6.1 Anthropic 官方 Skills
- 6.2 Superpowers
- 6.3 Planning-with-files
- 6.4 UI/UX Pro Max Skill
- 6.5 Skills 市场
- 七、创建自定义 Skills
- 7.1 步骤一：建立技能文件夹结构
- 7.2 目录结构说明
- 7.3 步骤二：编写 SKILL.md 文件
- 7.4 SKILL.md 模板示例
- 八、快速上手
- 九、常见使用场景
- 十、最佳实践
- 十一、常见问题
一、什么是 Agent Skills
1.1 Agent Skills 简介
Agent Skill 是 Claude Code 的扩展机制，是一种轻量级的开放格式，用于通过专业知识和工作流扩展AI Agent功能。 Agent Skills是Anthropic发布的功能。允许将提示词、代码包等专业能力打包成可按需加载的skills，支持多个skills叠加且Claude自动识别所需能力。。你可以把它理解成一个技能目录，里面放着一套指令，以及可选的模板、示例和脚本。
它遵循 Agent Skills 标准。对 Claude Code 来说，一个 Skill 至少要有一个SKILL.md文件；Claude 会根据 Skill 的名称和描述，判断要不要加载它。说白了，就是把重复的工作流变成资产，用的时候直接调。
1.3 为什么需要 Skills
没有 Skills 之前，这些问题应该挺常见的：
- ❌ 每次代码审查都重复同样的检查，费时又容易漏
- ❌ 部署前总担心"我是不是忘了检查什么"
- ❌ 团队里每个人有自己的 Checklist，质量参差不齐
- ❌ 老员工离职，摸索出来的经验也带走了
有了 Skills，至少能把这些重复劳动自动化掉：
- ✅ 代码审查：每次要手动检查十几个项目，现在描述需求就能自动跑完检查流程
- ✅ 部署前检查：把环境变量、API Key、配置文件这些必查项打包成 Skill，不会漏
- ✅ 问题排查：团队的排查步骤固化下来，新人不会两眼一抹黑
- ✅ 团队协作：老员工的经验不会随着离职流失，Skills 变成可复用的资产
二、Skills 核心特点
2.1 按需加载
Claude Code 不会一次性加载所有 Skills。它采用渐进式加载策略：
- 只加载与当前请求相关的 Skills
- 通过匹配
description字段来判断相关性 - 避免将不相关的 Skill 内容加载到上下文中
好处：
- 节省上下文预算
- 提高响应速度
- 减少无关信息的干扰
2.2 自动热重载
Skills 修改后自动生效，无需重启会话：
- 个人 Skills（
~/.claude/skills/）修改后立即可用 - 项目 Skills（
.claude/skills/）修改后立即可用 - 插件 Skills 安装/更新后自动加载
2.3 命名空间隔离
- 手动安装的 Skills 直接使用名称，如
my-skill - 插件提供的 Skills 使用命名空间前缀，如
document-skills:pdf - 避免不同来源的 Skills 产生命名冲突
2.4 标准化格式
遵循 Agent Skills 标准：
- 至少需要一个
SKILL.md文件 - 可选的模板、示例和脚本
- 统一的 frontmatter 格式（
name、description）
三、安装 Skills
3.1 方式一：通过自然语言安装
你可以直接告诉 Claude Code 帮你安装 Skill，例如：
帮我安装一个 skill，项目地址是：https://github.com/anthropics/skills/blob/main/skills/pptxClaude 会理解你的需求并自动完成安装。
3.2 方式二：手动安装
下载 Skill 的安装包，然后直接复制到.claude/skills/目录下即可：
.claude/ └── skills/ └── your-skill/ ├── SKILL.md ├── scripts/ └── references/3.3 方式三：通过插件市场安装
在 Claude Code 中执行以下命令，将官方仓库注册为插件市场：
/plugin marketplace add anthropics/skills然后在插件市场中搜索你需要的 Skill。
通过插件市场安装的 Skills 会保存在.claude/plugins/marketplaces/目录下。
你也可以直接用命令安装指定的插件：
/plugin install document-skills@anthropic-agent-skills3.4 重要提示
⚠️安装完成后，记得重启 Claude Code，这样 Skills 才能生效。
四、Skills 存放位置
4.1 三种存储位置
| 类型 | 路径 | 适用范围 | 获取方式 |
|---|---|---|---|
| 个人 | ~/.claude/skills/<skill-name>/SKILL.md | 所有项目 | 手动创建 |
| 项目 | .claude/skills/<skill-name>/SKILL.md | 当前项目 | 手动创建 |
| 插件 | ~/.claude/plugins/cache/<marketplace>/<plugin>/skills/ | 所有项目 | 插件市场安装 |
4.2 核心原则
无论哪种位置，每个 Skill 都要有自己的文件夹，不是把 SKILL.md 直接扔进 skills/ 根目录。
五、插件 Skills
插件 Skills 是通过 Claude Code 插件市场安装的 Skill 集合。它们存储在~/.claude/plugins/cache/目录下，按市场和插件名组织。
5.1 插件 Skills 特点
- 命名空间：插件内的 Skills 使用命名空间前缀，例如
document-skills:pdf - 版本管理：每个插件安装后带有版本哈希，便于更新和回滚
- 批量安装：一个插件可以包含多个相关 Skills
- 自动发现：安装后自动被 Claude Code 识别和加载
示例路径结构：
~/.claude/plugins/cache/ └── anthropic-agent-skills/ └── document-skills/ └── <version-hash>/ └── skills/ ├── xlsx/ ├── docx/ ├── pptx/ └── pdf/5.2 手动 Skills vs 插件 Skills
| 特性 | 手动 Skills | 插件 Skills |
|---|---|---|
| 安装方式 | 手动复制/克隆 | 插件市场一键安装 |
| 版本管理 | 手动维护 Git | 自动版本控制 |
| 更新方式 | 手动 git pull | 插件更新机制 |
| 命名冲突 | 需自行避免 | 命名空间隔离 |
六、常用 Skills 推荐
6.1 Anthropic 官方 Skills
- GitHub 地址：https://github.com/anthropics/skills
- 维护方：Anthropic 官方团队
- 特点：经过严格测试，质量有保证，覆盖文档处理、代码审查、设计工具等核心功能
- 适合人群：新手入门的首选，最稳定可靠的选择
6.2 Superpowers
- GitHub 地址：https://github.com/obra/superpowers
- 核心定位：全流程覆盖的 Skills 集合
- 功能范围：头脑风暴 → 需求文档 → 开发实现 → 测试验证
- 设计理念：@obra 认为 AI 写代码太随意了，所以他编写了一组 Skills，让 AI 像专业工程师一样按照标准流程工作
6.3 Planning-with-files
- GitHub 地址：https://github.com/OthmanAdi/planning-with-files
- 核心功能：专注于文件规划和项目管理
- 能力说明：
- 帮助 AI 更好地理解项目结构
- 提供文件组织方式的建议
- 辅助项目规划和任务分配
6.4 UI/UX Pro Max Skill
- GitHub 地址：https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
- 核心功能：专注于 UI/UX 设计领域
- 能力说明：
- 生成高质量的设计方案
- 提供用户界面设计建议
- 优化现有设计的用户体验
6.5 Skills 市场
- 访问地址：https://skillsmp.com/zh
- 统计数据：
- Skills 总数超过 58,000 个
- 支持 AI 智能搜索
- 支持按照分类浏览
七、创建自定义 Skills
创建自己的 Skills 其实并不复杂，主要可以分为以下几个步骤：
7.1 步骤一：建立技能文件夹结构
在你的.claude/skills/目录下创建一个新文件夹，比如命名为my-skill/。
7.2 目录结构说明
my-skill/ ├── SKILL.md # 核心指令文件（必需） ├── template.md # Claude 填写的模板（可选） ├── examples/ # 示例目录（可选） │ └── sample.md # 示例输出 ├── scripts/ # 可执行脚本目录（可选） │ ├── script1.py │ └── script2.js └── references/ # 详细文档目录（可选） ├── api-spec.md └── database-schema.md| 文件/目录 | 必需性 | 用途 |
|---|---|---|
SKILL.md | ✅ 必需 | 核心指令文件 |
template.md | ⭕ 可选 | Claude 填写的模板 |
examples/ | ⭕ 可选 | 示例输出目录 |
scripts/ | ⭕ 可选 | 存放可执行脚本 |
references/ | ⭕ 可选 | 存放按需加载的详细文档 |
7.3 步骤二：编写 SKILL.md 文件
这是技能的核心定义文件，使用 YAML Frontmatter 格式。
7.4 SKILL.md 模板示例
--- name: my-skill description: 这是一个示例技能，用于演示如何创建自定义 Skill --- # Skill: my-skill 这里编写你的技能说明和使用指令... ## 使用场景 描述这个技能适用于什么场景... ## 工作流程 1. 第一步做什么 2. 第二步做什么 3. 第三步做什么 ## 输出格式 描述最终输出应该遵循什么格式...八、快速上手（3 分钟）
安装官方插件：
claude plugin install document-skills@anthropic-agent-skills查看可用 Skills：
What skills are available?开始使用：
不用记命令，也不用查文档，说人话就行。例如：帮我看看这个 PDF 里的表格
九、常见使用场景
| 场景 | 说明 |
|---|---|
| 代码审查 | 把重复的检查项固化成 Skill，自动检查错误处理、日志格式、注释完整性 |
| 部署前检查 | 把环境变量、API Key、配置文件这些必查项打包成 Skill，不会遗漏 |
| 问题排查 | 团队的排查步骤固化下来，新人也能按流程排查 |
| 团队协作 | 老员工的经验不会随着离职流失，Skills 变成团队可复用的资产 |
| 文档处理 | 处理 PDF、Excel、Word 等文档，自动提取内容 |
| 项目规划 | 辅助项目结构分析和任务分解 |
十、最佳实践
- 按项目组织 Skills：将项目特定的 Skills 放在项目的
.claude/skills/目录下，便于团队协作 - 保持 Skill 聚焦：一个 Skill 只做一件事，这样按需加载更精准
- 使用标准化格式：遵循 YAML Frontmatter 格式，提供清晰的
name和description - 添加示例：在
examples/目录下添加示例输出，帮助 Claude 理解你的期望 - 定期更新：及时更新 Skills 以适应项目需求变化
- 版本控制：将项目 Skills 纳入 Git 版本控制，便于团队共享和更新
十一、常见问题
Q: Skills 修改后需要重启 Claude Code 吗？
A: 不需要，Skills 支持自动热重载，修改后立即可用。
Q: 为什么我的 Skill 没有被自动加载？
A: 检查description是否包含当前上下文相关的关键词，Claude 是通过描述匹配来判断是否加载的。
Q: 个人 Skills 和项目 Skills 有什么区别？
A: 个人 Skills 存储在用户目录，对所有项目可见；项目 Skills 存储在项目目录，只对当前项目可见。
Q: 可以同时加载多个 Skills 吗？
A: 可以，Claude 会根据上下文自动匹配并加载所有相关的 Skills。
Q: 如何删除一个 Skill？
A: 直接删除对应的文件夹即可，Claude 会自动识别变化。