Claude Code Skills 安装使用指南
目录
- 一、什么是 Skills
- 二、Skills 核心特点
- 三、安装 Skills
- 四、Skills 存放位置
- 五、插件 Skills
- 六、常用 Skills 推荐
- 七、创建自定义 Skills
- 八、快速上手
- 九、常见使用场景
- 十、最佳实践
- 十一、常见问题
一、什么是 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/pptx
Claude 会理解你的需求并自动完成安装。
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-skills
3.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 会自动识别变化。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
9
0- 0
已为社区贡献3条内容
所有评论(0)