Skills 技能包详解
Skills 技能包详解
Skills 是 Claude Code 中的预封装工作流系统，就像游戏中的"技能包"，用完即走，不占用上下文。它是别人已经编写好的、可直接使用的功能模块。
一、什么是 Skills？
核心概念
Skills 是预封装的工作流，具有以下特点：
- 即用即走：不占用主对话上下文
- 预定义逻辑：封装了特定场景的最佳实践
- 可复用：一次编写，多次使用
- 可分享：可以分享给其他用户使用
官方 Skills 库
Anthropic 提供了官方的 Skills 库：
- GitHub 地址：https://github.com/anthropics/skills
- Star 数：32k+
二、Skills 的类型
| 类型 | 说明 | 示例 |
|------|------|------|
| User Skills | 用户自定义技能，存储在本地 | 个人工作流自动化 |
| Plugin Skills | 插件提供的技能，随插件安装 | frontend-design |
| Built-in Skills | Claude Code 内置技能 | commit, review-pr |
三、常用官方 Skills
安装命令
# 前端设计技能
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
# 文档协同技能
npx skills-installer install @anthropics/claude-code/doc-coauthoring --client claude-code
# Canvas 设计技能
npx skills-installer install @anthropics/claude-code/canvas-design --client claude-code
# PDF 处理技能
npx skills-installer install @anthropics/claude-code/pdf --client claude-code
# 算法艺术生成
npx skills-installer install @anthropics/claude-code/algorithmic-art --client claude-code
使用方法
# 在 Claude Code 对话中使用
使用 frontend-design skill 优化 https://example.com
使用 pdf skill 提取 report.pdf 中的表格数据
四、查看可用 Skills
命令方式
# 查看所有可用的 Skills
claude /skills
技能列表内容
执行 /skills 命令后，会显示：
- 已安装的 Skills 列表
- 可从市场安装的 Skills
- 自定义 Skills
- 每个 Skill 的描述和使用方法
五、如何编写自己的 Skills
Skill 目录结构
my-skill/
├── skill.json # Skill 元数据
├── skill.md # Skill 文档
├── api/ # API 定义（可选）
└── tools/ # 自定义工具（可选）
skill.json 示例
{
"name": "my-custom-skill",
"description": "我的自定义技能",
"version": "1.0.0",
"author": "Your Name",
"categories": ["automation"],
"license": "MIT",
"skill": {
"file": "skill.md",
"description": "这个技能用于..."
}
}
skill.md 示例
# My Custom Skill
这个技能帮助用户快速完成[特定任务]。
## 使用场景
- 场景1：描述...
- 场景2：描述...
## 使用方式
用户只需要告诉你要完成什么，这个技能就会自动：
1. 分析需求
2. 执行步骤
3. 返回结果
## 注意事项
- 注意事项1
- 注意事项2
Skill.md 模板
# [Skill Name]
[简要描述这个技能的作用]
## 使用场景
- [场景1]
- [场景2]
- [场景3]
## 使用前提
- [前提1]
- [前提2]
## 使用方式
/use [skill-name]
## 参数说明
| 参数 | 必填 | 说明 |
|------|------|------|
| param1 | 是 | 参数1的说明 |
| param2 | 否 | 参数2的说明 |
## 使用示例
### 示例1
/use my-skill --param1 value1
### 示例2
/use my-skill --param1 value1 --param2 value2
## 注意事项
- [注意事项1]
- [注意事项2]
## 相关技能
- [相关技能1]
- [相关技能2]
六、安装本地 Skill
方式一：复制到配置目录
# 将技能复制到 Claude Code 配置目录
cp -r my-skill ~/.claude/skills/
方式二：使用安装命令
# 使用 npx 安装
npx skills-installer install ./my-skill --client claude-code
方式三：从 GitHub 安装
# 直接从 GitHub 仓库安装
npx skills-installer install github:username/repo --client claude-code
七、Skill 使用最佳实践
场景选择
| 场景 | 推荐使用 | 不推荐使用 |
|------|----------|------------|
| 复杂工作流 | ✅ Skills | ❌ 简单任务 |
| 重复性操作 | ✅ Skills | ❌ 一次性任务 |
| 团队共享流程 | ✅ Skills | ❌ 个人临时脚本 |
性能考虑
- 小任务：直接使用自然语言描述
- 大任务：使用 Skills 封装
- 超复杂任务：考虑使用 Subagents
上下文管理
- Skills 不占用主对话上下文
- 适合需要频繁使用的功能
- 避免在 Skills 中处理临时性需求
八、常见问题
问题 1：Skill 无法安装
错误信息：
Error: Failed to install skill
解决方案：
- 检查网络连接
- 确认 Skill 名称正确
- 检查权限设置
问题 2：Skill 使用无响应
可能原因：
- Skill 配置错误
- 缺少必要的参数
- 依赖工具未安装
解决方案：
# 查看 Skill 详细信息
claude /skills [skill-name]
# 检查 Skill 配置
cat ~/.claude/skills/[skill-name]/skill.json
问题 3：自定义 Skill 不生效
可能原因：
- 目录结构不正确
- JSON 格式错误
- 文件权限问题
解决方案：
- 确认目录结构符合规范
- 验证 JSON 文件格式
- 检查文件权限
九、进阶技巧
组合使用 Skills
# 组合多个 Skills
使用 frontend-design skill 设计页面
使用 pdf skill 生成设计文档
Skills 与 Hooks 结合
{
"hooks": {
"tool-use-hook": {
"command": "npx skills-installer run my-skill",
"enabled": true
}
}
}
Skills 版本管理
# 查看已安装 Skills 版本
claude /skills
# 更新 Skills
npx skills-installer update @anthropics/claude-code/frontend-design --client claude-code
# 卸载 Skills
npx skills-installer uninstall @anthropics/claude-code/frontend-design --client claude-code
十、总结
通过本指南，你已经了解了：
- ✅ 什么是 Skills 及其核心概念
- ✅ Skills 的三种类型
- ✅ 如何安装和使用官方 Skills
- ✅ 如何编写自定义 Skills
- ✅ Skills 的最佳实践
Skills 是 Claude Code 强大的扩展机制之一，合理使用 Skills 可以大大提高开发效率。