Claude Code Skills 安装与使用完整指南

Code Claude

字数统计: 3.9k阅读时长: 15 min

 2025/11/14 

Claude Code Skills 安装与使用完整指南

一次性安装 10 个实用技能，让 Claude Code 成为你的超级助手

前言

Claude Code 是 Anthropic 推出的命令行工具，Claude Skills 则是预构建的工作流程模板，能让 Claude 以标准化、可重复的方式执行特定任务。本文介绍如何从 awesome-claude-skills 项目安装和使用这些技能。

什么是 Claude Skills？

Claude Skills 是可定制的工作流程，用于教会 Claude 如何执行特定任务。每个 skill 包含：

SKILL.md - 核心指令文件（包含 YAML frontmatter + 工作流程定义）
scripts/ - 可选的辅助脚本
templates/ - 可选的模板文件
resources/ - 可选的资源文件

Skills 的优势：

自动激活 - 根据上下文自动触发，无需手动调用
跨平台通用 - 在 Claude.ai、Claude Code CLI 和 Claude API 中都可使用
标准化流程 - 确保任务执行的一致性和质量
社区驱动 - 开源项目，持续更新和改进

awesome-claude-skills 项目介绍

awesome-claude-skills 是一个技能集合仓库，目前包含 27 个预构建的 skills，分为五大类：

1. 商业与营销 (5 个)

brand-guidelines - 品牌规范应用
competitive-ads-extractor - 竞品广告分析
domain-name-brainstormer - 域名创意生成
lead-research-assistant - 潜在客户研究
internal-comms - 内部沟通材料开发

2. 沟通与写作 (2 个)

content-research-writer - 深度内容创作
meeting-insights-analyzer - 会议记录洞察提取

3. 创意与媒体 (6 个)

canvas-design - 可视化设计
image-enhancer - 图像增强处理
slack-gif-creator - Slack GIF 生成
theme-factory - UI 主题设计
等等…

4. 开发工具 (7 个)

artifacts-builder - React/TypeScript 应用构建
mcp-builder - MCP 服务器创建向导
webapp-testing - Playwright 自动化测试
skill-creator - 从模板创建新 skill
changelog-generator - 自动生成版本日志
等等…

5. 生产力与组织 (7 个)

file-organizer - 智能文件分类
invoice-organizer - 发票文档处理
document-skills-docx - Word 文档处理
document-skills-pdf - PDF 提取和操作
document-skills-pptx - PowerPoint 编辑
document-skills-xlsx - Excel 表格处理
等等…

安装步骤

第一步：克隆仓库

1
2
3

# 克隆 awesome-claude-skills 仓库到本地
cd ~/Downloads
git clone https://github.com/ComposioHQ/awesome-claude-skills.git

第二步：创建 skills 目录

1 2	# 创建 Claude Code 的 skills 配置目录 mkdir -p ~/.claude/skills

第三步：选择并安装 Skills

你可以根据自己的需求选择性安装。这里推荐 10 个比较实用的 skills：

文档处理系列 (4 个)

# 安装文档处理 skills
cp -r ~/Downloads/awesome-claude-skills/document-skills/docx ~/.claude/skills/document-skills-docx
cp -r ~/Downloads/awesome-claude-skills/document-skills/pdf ~/.claude/skills/document-skills-pdf
cp -r ~/Downloads/awesome-claude-skills/document-skills/pptx ~/.claude/skills/document-skills-pptx
cp -r ~/Downloads/awesome-claude-skills/document-skills/xlsx ~/.claude/skills/document-skills-xlsx

功能：

document-skills-docx - Word 文档创建和编辑
document-skills-pdf - PDF 内容提取和操作
document-skills-pptx - PowerPoint 生成和编辑
document-skills-xlsx - Excel 数据处理和分析

文件管理 (2 个)

1
2
3

# 安装文件管理 skills
cp -r ~/Downloads/awesome-claude-skills/file-organizer ~/.claude/skills/
cp -r ~/Downloads/awesome-claude-skills/invoice-organizer ~/.claude/skills/

功能：

file-organizer - 智能文件分类整理，查找重复文件
invoice-organizer - 发票文档处理和元数据提取

内容创作 (2 个)

1
2
3

# 安装内容创作 skills
cp -r ~/Downloads/awesome-claude-skills/content-research-writer ~/.claude/skills/
cp -r ~/Downloads/awesome-claude-skills/changelog-generator ~/.claude/skills/

功能：

content-research-writer - 研究型内容创作，支持引用和分段反馈
changelog-generator - 从 git commits 自动生成用户友好的版本日志

开发工具 (2 个)

1
2
3

# 安装开发工具 skills
cp -r ~/Downloads/awesome-claude-skills/mcp-builder ~/.claude/skills/
cp -r ~/Downloads/awesome-claude-skills/skill-creator ~/.claude/skills/

功能：

mcp-builder - MCP (Model Context Protocol) 服务器创建指南
skill-creator - 从模板生成新的 Claude Skills

第四步：验证安装

# 查看已安装的 skills
ls -1 ~/.claude/skills/

# 验证每个 skill 的完整性
for skill in ~/.claude/skills/*; do
  if [ -f "$skill/SKILL.md" ]; then
    echo "✓ $(basename $skill)";
  else
    echo "✗ $(basename $skill) - 缺少 SKILL.md";
  fi;
done

你应该看到类似以下输出：

✓ changelog-generator
✓ content-research-writer
✓ document-skills-docx
✓ document-skills-pdf
✓ document-skills-pptx
✓ document-skills-xlsx
✓ file-organizer
✓ invoice-organizer
✓ mcp-builder
✓ skill-creator

第五步：重启 Claude Code

Skills 会在 Claude Code 启动时自动加载：

# 退出当前会话（如果正在运行）
/exit

# 重新启动 Claude Code
claude

使用指南

自动激活机制

Skills 会根据上下文自动激活，你只需要用自然语言描述需求即可。

文档处理示例

处理 PDF 文件

# 进入包含 PDF 的目录
cd ~/Documents

# 在 Claude Code 中说：
"帮我提取 report.pdf 的所有文本内容"
"把这三个 PDF 合并成一个文件"
"从 document.pdf 中提取第 5-10 页"

触发条件：提到 PDF、上传 PDF 文件、需要提取/合并/分割操作

处理 Excel 表格

1
2
3

"分析这个 sales.xlsx 的数据"
"创建一个包含本月销售数据的电子表格"
"在 data.xlsx 中添加一个求和公式"

触发条件：提到 Excel、.xlsx、表格、数据分析

创建 Word 文档

1
2
3

"创建一个 Word 文档，包含项目报告"
"从 report.docx 中提取所有表格"
"修改文档的标题样式"

触发条件：提到 Word、.docx、文档创建/编辑

文件管理示例

整理杂乱的文件夹

# 工作流程
cd ~/Downloads  # 进入杂乱的目录

# 在 Claude Code 中说：
"帮我整理这个文件夹，按文件类型分类"
"找出这个目录下的所有重复文件"
"清理超过 30 天没用过的文件"

skill 会做什么：

分析当前目录结构
识别文件类型和内容
建议分类方案
查找重复文件
执行整理操作（需确认）

处理发票文档

1
2
3

"整理我的发票文件，按月份分类"
"从这些发票 PDF 中提取金额和日期"
"为报税准备发票文档"

内容创作示例

写技术博客

# 创建写作目录
mkdir ~/writing/kubernetes-security
cd ~/writing/kubernetes-security

# 在 Claude Code 中说：
"帮我写一篇关于 Kubernetes 安全最佳实践的技术博客，需要包含代码示例和权威引用"

工作流程：

Claude 创建文章大纲
逐段写作并提供反馈
添加代码示例
查找并添加权威来源引用
优化开头和标题吸引力
保持你的写作风格和语气

生成 Changelog

# 进入 git 仓库
cd ~/my-project

# 在 Claude Code 中说：
"生成从 v2.0.0 到现在的 changelog"
"创建本周的更新日志，格式要适合放在 GitHub Release"

skill 会做什么：

扫描 git commit 历史
分类提交（新功能、修复、改进、破坏性变更）
将技术性 commit 转换为用户友好的描述
过滤内部提交（重构、测试等）
生成格式化的 Markdown

开发工具示例

创建 MCP 服务器

# 创建项目目录
mkdir ~/my-mcp-server
cd ~/my-mcp-server

# 在 Claude Code 中说：
"帮我创建一个 MCP 服务器，用 Python 实现，能够访问 GitHub API 获取仓库信息"

工作流程：

深度研究 GitHub API 文档
理解 MCP 协议和最佳实践
设计工具结构（面向工作流，非简单 API 包装）
生成 Python 代码（使用 FastMCP）
创建配置文件
提供测试和部署指导

创建新的 Skill

1 2	"帮我创建一个新的 Claude Skill 用于代码审查" "我想开发一个自定义 skill 来处理视频文件元数据"

配置维护

查看空间占用

# 查看 skills 占用的空间
du -sh ~/.claude/skills/*

# 输出示例：
# 1.3M  document-skills-pptx
# 1.3M  document-skills-docx
# 172K  mcp-builder
# 92K   document-skills-pdf
# ...

更新 CLAUDE.md 文档

建议为项目添加已安装 skills 的说明，便于后续维护：

1 2	# 编辑 ~/.claude/CLAUDE.md # 添加 "Installed Skills" 章节

示例内容：

## Installed Skills

Claude Skills 是可重复使用的工作流程，让 Claude 能够以标准化方式执行特定任务。

### Document Processing (4 skills)
- **document-skills-docx**: Word 文档创建和编辑
- **document-skills-pdf**: PDF 内容提取和处理
- **document-skills-pptx**: PowerPoint 演示文稿生成
- **document-skills-xlsx**: Excel 电子表格处理和数据分析

### File Management (2 skills)
- **file-organizer**: 智能分类和整理文件
- **invoice-organizer**: 发票文档处理和整理

### Content & Writing (2 skills)
- **content-research-writer**: 创建有研究支撑的结构化内容
- **changelog-generator**: 从 git commits 自动生成版本说明

### Development Tools (2 skills)
- **mcp-builder**: MCP 服务器创建指南
- **skill-creator**: 从模板生成新的 Claude Skills

定期清理临时文件

# 清理旧的调试日志（7 天前）
find ~/.claude/debug -type f -mtime +7 -delete

# 清理旧的 shell 快照（7 天前）
find ~/.claude/shell-snapshots -type f -mtime +7 -delete

# 清理旧的 todo 文件（30 天前）
find ~/.claude/todos -type f -mtime +30 -delete

删除不需要的 Skills

如果某些 skills 不常用，可以单独删除：

# 删除特定 skill
rm -rf ~/.claude/skills/invoice-organizer

# 或者全部删除
rm -rf ~/.claude/skills

实战案例

案例 1：整理下载文件夹

背景：Downloads 文件夹有 200+ 个文件，包括 PDF、图片、压缩包等，杂乱无章。

操作：

1 2	cd ~/Downloads claude

对话：

你: "帮我整理这个文件夹，把图片、文档、压缩包分别放到不同的子目录，超过 60 天的文件归档"

Claude: [file-organizer 自动激活]
- 扫描 Downloads 目录
- 识别文件类型（87 张图片、45 个 PDF、23 个压缩包...）
- 建议分类方案：
  • Images/ - 图片文件
  • Documents/ - PDF、Word、Excel
  • Archives/ - zip、tar.gz
  • Old/ - 超过 60 天的文件
- 执行整理（已确认）
- 完成，整理了 200 个文件

结果：Downloads 文件夹从混乱变为井然有序，节省了至少 30 分钟手动整理时间。

案例 2：自动生成产品发布日志

背景：开发了一个月的新功能，有 50+ 个 commits，需要生成用户友好的 changelog。

操作：

1 2	cd ~/my-saas-project claude

对话：

你: "生成从 v3.1.0 到现在的 changelog，格式要适合放在 GitHub Release 和发给客户"

Claude: [changelog-generator 自动激活]
- 读取 git log (从 v3.1.0 到 HEAD)
- 分析 50 个 commits
- 分类整理：
  新功能 (5 个)
  改进 (12 个)
  修复 (8 个)
  安全 (2 个)
- 转换技术描述为用户语言
- 生成格式化的 Markdown

输出：
## v3.2.0 - 2024-11-14

### 新功能
- **团队协作看板** - 支持多人实时编辑，提升团队协作效率
- **自定义报表导出** - 可按需导出 PDF/Excel 格式的数据分析报告
- ...

### 改进
- 优化了仪表盘加载速度，提升 40%
- 改进了移动端体验，适配更多屏幕尺寸
- ...

### 修复
- 修复了大文件上传失败的问题
- 解决了导出数据时中文乱码的 bug
- ...

结果：5 分钟生成了专业的 changelog，原本需要 1-2 小时手动整理。

案例 3：写技术博客并自动添加引用

背景：需要写一篇关于 “Docker 容器安全最佳实践” 的深度技术文章。

操作：

1
2
3

mkdir ~/blog/docker-security
cd ~/blog/docker-security
claude

对话：

你: "写一篇关于 Docker 容器安全最佳实践的技术文章，包含代码示例和权威引用"

Claude: [content-research-writer 自动激活]

步骤 1 - 创建大纲：
1. 容器安全的重要性
2. 镜像安全（基础镜像选择、漏洞扫描）
3. 运行时安全（最小权限、资源限制）
4. 网络安全（网络隔离、加密通信）
5. 最佳实践总结

你: "大纲看起来不错，开始写吧"

Claude:
- 逐段写作
- 添加实际的 Dockerfile 代码示例
- 查找并引用权威来源（OWASP、Docker 官方文档、CIS Benchmark）
- 为每个建议提供理由和实战案例
- 优化开头吸引力

最终输出：
- 5000 字深度文章
- 10+ 代码示例
- 15+ 权威来源引用
- 保持你的写作风格

结果：完成了一篇高质量技术文章，包含研究、写作、引用管理，节省了 3-4 小时。

与 Output Styles 的配合

Claude Code 支持自定义输出风格，Skills 可以与这些风格很好地配合使用：

architect 模式 + mcp-builder

1 2	# 使用架构师视角设计 MCP 服务器 "用 architect 模式帮我设计一个 MCP 服务器，需要考虑扩展性和性能"

prototyping 模式 + changelog-generator

1 2	# 快速原型模式生成简化版 changelog "用 prototyping 模式快速生成 changelog，不要太详细"

code-reviewer 模式 + document-skills

1 2	# 审查模式检查文档质量 "用 code-reviewer 模式分析这个技术文档，找出可以改进的地方"

tdd 模式 + skill-creator

1 2	# 测试驱动开发模式创建新 skill "用 TDD 模式帮我创建一个新的 skill，先写测试"

常见问题

Q1: Skills 没有自动激活怎么办？

可能原因：

Claude Code 未重启 - 退出后重新启动 claude
描述不够明确 - 改进提示词，例如 “处理文档” → “从这个 PDF 中提取文本”
SKILL.md 文件缺失 - 检查 ls ~/.claude/skills/*/SKILL.md

Q2: 如何知道某个 skill 被激活了？

观察 Claude 的回复，如果 skill 激活成功，Claude 会：

使用 skill 定义的特定工作流程
输出符合 skill 规范的格式
可能会明确提到 “使用 [skill名称]”

Q3: 可以同时使用多个 skills 吗？

可以！Claude 会根据任务复杂度自动协调多个 skills：

1 2	"整理这个文件夹并生成整理报告文档" # 可能同时激活 file-organizer + document-skills-docx

Q4: Skills 会消耗很多 token 吗？

Skills 的指令文件（SKILL.md）会在启动时加载到上下文中，但：

只有激活的 skill 才会占用额外 token
相比手动编写详细提示词，skills 通常更高效
可以选择性安装需要的 skills 来控制开销

Q5: 如何更新 skills？

# 拉取最新版本
cd ~/Downloads/awesome-claude-skills
git pull origin main

# 重新安装需要更新的 skill
cp -r ~/Downloads/awesome-claude-skills/file-organizer ~/.claude/skills/

# 重启 Claude Code

进阶使用

创建自定义 Skill

使用 skill-creator skill 来创建你自己的工作流程：

"帮我创建一个新的 skill，用于自动化代码审查流程"

Claude: [skill-creator 激活]
- 生成 SKILL.md 模板
- 定义 frontmatter（name, description）
- 创建工作流程步骤
- 添加示例和最佳实践
- 保存到 ~/.claude/skills/code-review-automation/

扩展 MCP 能力

使用 mcp-builder skill 创建自定义工具：

"创建一个 MCP 服务器来集成 Notion API"

Claude: [mcp-builder 激活]
- 深度研究 Notion API 文档
- 设计面向工作流的工具（非简单 API 包装）
- 生成 Python/TypeScript 代码
- 优化错误提示和上下文管理
- 提供完整的测试和部署方案

总结

通过安装这 10 个精选的 Claude Skills，你可以获得：

文档处理能力 - 处理 Word、Excel、PDF、PPT
文件管理能力 - 智能整理、查找重复、归档
内容创作能力 - 深度写作、研究引用、版本日志
开发扩展能力 - 创建 MCP 服务器、开发新 skills

关键优势：

自动化 - 减少重复劳动，专注创造性工作
标准化 - 确保任务执行的一致性和质量
智能化 - 上下文感知，自动选择最佳工作流程
可扩展 - 可以创建自定义 skills 满足特定需求

下一步行动：

重启 Claude Code 让 skills 生效
尝试实战案例，体验自动化的魅力
探索更多 awesome-claude-skills 项目中的 skills
根据需求创建自定义 skills