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- 从模板创建新 skillchangelog-generator- 自动生成版本日志- 等等…
5. 生产力与组织 (7 个)
file-organizer- 智能文件分类invoice-organizer- 发票文档处理document-skills-docx- Word 文档处理document-skills-pdf- PDF 提取和操作document-skills-pptx- PowerPoint 编辑document-skills-xlsx- Excel 表格处理- 等等…
安装步骤
第一步:克隆仓库
# 克隆 awesome-claude-skills 仓库到本地
cd ~/Downloads
git clone https://github.com/ComposioHQ/awesome-claude-skills.git
第二步:创建 skills 目录
# 创建 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 个)
# 安装文件管理 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 个)
# 安装内容创作 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 个)
# 安装开发工具 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 表格
"分析这个 sales.xlsx 的数据"
"创建一个包含本月销售数据的电子表格"
"在 data.xlsx 中添加一个求和公式"
触发条件:提到 Excel、.xlsx、表格、数据分析
创建 Word 文档
"创建一个 Word 文档,包含项目报告"
"从 report.docx 中提取所有表格"
"修改文档的标题样式"
触发条件:提到 Word、.docx、文档创建/编辑
文件管理示例
整理杂乱的文件夹
# 工作流程
cd ~/Downloads # 进入杂乱的目录
# 在 Claude Code 中说:
"帮我整理这个文件夹,按文件类型分类"
"找出这个目录下的所有重复文件"
"清理超过 30 天没用过的文件"
skill 会做什么:
- 分析当前目录结构
- 识别文件类型和内容
- 建议分类方案
- 查找重复文件
- 执行整理操作(需确认)
处理发票文档
"整理我的发票文件,按月份分类"
"从这些发票 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
"帮我创建一个新的 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 的说明,便于后续维护:
# 编辑 ~/.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、图片、压缩包等,杂乱无章。
操作:
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。
操作:
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 容器安全最佳实践” 的深度技术文章。
操作:
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
# 使用架构师视角设计 MCP 服务器
"用 architect 模式帮我设计一个 MCP 服务器,需要考虑扩展性和性能"
prototyping 模式 + changelog-generator
# 快速原型模式生成简化版 changelog
"用 prototyping 模式快速生成 changelog,不要太详细"
code-reviewer 模式 + document-skills
# 审查模式检查文档质量
"用 code-reviewer 模式分析这个技术文档,找出可以改进的地方"
tdd 模式 + skill-creator
# 测试驱动开发模式创建新 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:
"整理这个文件夹并生成整理报告文档"
# 可能同时激活 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
相关资源:
作者:Even Chan 日期:2025-11-14 版本:1.0
如果这篇教程对你有帮助,欢迎分享给其他 Claude Code 用户。有任何问题或建议,欢迎在评论区讨论。