培训讲义

Claude Code Skills 入门与现场练习

这份讲义给现场参会同学使用。你可以按步骤了解 Skill 是什么、把 Skill 放到哪里、怎么验证生效,并跟着示例完成 PDF 摘要、PPT 生成和网页测试演示。

1. Skill 是什么

不是普通提示词

Skill 通常是一个目录,核心文件是 SKILL.md。它可以包含说明、脚本、模板、示例、资产文件和依赖安装步骤。

按需加载

Claude 会根据任务判断是否需要某个 Skill。用得上时才加载详细说明,避免把所有规则都塞进主上下文。

适合标准流程

适合重复性强、质量要求稳定的任务:生成文档、做 PPT、查网页、写测试、审代码、生成设计稿、处理表格。

2. 本地目录安装和启用

现场建议使用本地目录安装,路径清晰、可控,也便于团队统一审核。用户级 Skill 对所有项目生效,项目级 Skill 只对当前仓库生效。

用户级安装

适合个人长期使用的通用 Skill,例如文档处理、PPT、网页测试。

~/.claude/skills/your-skill/SKILL.md

项目级安装

适合某个仓库专用的团队规范、代码审查规则、上线流程。

.claude/skills/your-skill/SKILL.md

现场可直接复制的最小 Skill

1

创建目录

在当前项目中创建一个项目级 Skill:

mkdir -p .claude/skills/meeting-summary
2

创建 SKILL.md

.claude/skills/meeting-summary/SKILL.md 写入下面内容:

---
name: meeting-summary
description: 用于把会议记录、培训记录或访谈内容整理成结构化摘要、行动项和风险点。
---

# Meeting Summary

当用户要求整理会议、培训或访谈内容时,按以下格式输出:

1. 一句话结论
2. 关键要点,最多 5 条
3. 行动项,包含负责人、事项、截止时间
4. 风险和待确认问题

如果原文缺少负责人或截止时间,标记为“待确认”。
3

重启 Claude Code

安装或修改 Skill 后,建议退出并重新进入当前项目。

claude
4

验证是否生效

输入一个和 Skill 描述匹配的任务:

请把下面培训记录整理成会议摘要、行动项和风险点:
今天讨论了 CC Switch、Claude Code 命令、Coding Plan 和 Skills 演示。
研发同学需要本周完成工具安装,负责人待定。
下周要安排一次实操答疑。

安装后没有触发怎么办

  • 确认文件名必须是 SKILL.md,目录结构不要写错。
  • 确认 frontmatter 里有 namedescription
  • 确认 description 写清楚触发场景,例如“会议记录”“培训记录”。
  • 重启 Claude Code 后再试。
  • 直接在提示里点名:请使用 meeting-summary 这个 Skill...

用 CC Switch 管理

如果现场已经安装 CC Switch,也可以打开「Skills」面板,从 GitHub 仓库或 ZIP 文件安装,并同步到支持的应用。团队统一发放 Skill 时,这种方式更方便。

3. 市面常见 Skills 分类

下面按公开 marketplace 和官方文档中常见类型整理。具体名称、下载量和维护状态会变化,演示前建议重新确认。

类别代表 Skills / 来源能演示什么适合人群
办公文档 pdfdocxpptxxlsx,Anthropic 官方 Skills 常见类型。 读 PDF、生成 Word、做 PPT、分析 Excel、生成图表。 产品、运营、售前、培训、管理者。
前端与设计 frontend-designcanvas-design、Vercel React / Next / Web Design skills、shadcn/ui。 把需求转成页面、改 UI 风格、按设计规范生成组件。 前端、全栈、设计工程师。
网页测试与浏览器 webapp-testing、browser-use、agent-browser、use-my-browser。 打开本地页面、点击流程、检查布局、截图验证。 前端、测试、产品验收。
代码质量与流程 systematic-debugging、test-driven-development、code review、verification-before-completion。 按步骤定位 bug、先写测试、做代码审查、验证后再收尾。 研发团队、Tech Lead、质量负责人。
云服务与 DevOps Microsoft Azure skills、GitHub Actions docs、Kubernetes、Postgres、Supabase best practices。 解释云资源、优化成本、写 CI、排查部署、生成数据库迁移建议。 后端、平台工程、运维、云架构师。
营销与内容 SEO audit、copywriting、social content、pricing strategy、marketing psychology。 审网页 SEO、写落地页文案、生成社媒内容、做竞品定位。 市场、增长、独立开发者。
多媒体生成 AI image generation、AI video generation、ElevenLabs TTS / music。 生成图片提示词、视频脚本、语音稿和素材规划。 内容团队、设计、营销。
自定义 Skill skill-creator、mcp-builder、团队自建 SKILL.md。 把团队规范、代码审查清单、上线流程做成可复用 Skill。 所有需要固化流程的团队。

4. 现场练习

下面 3 个练习可以任选其一跟做。每个练习都包含输入、预期产出和验收方式。

练习 A:PDF 摘要

适合所有同学,最容易理解 Skill 的价值。

请使用 PDF 相关能力,读取 ./docs/report.pdf,
输出 5 条关键结论、3 个风险点和一段给老板看的摘要。

预期产出:结构化摘要。验收方式:结论是否来自原文,风险点是否具体。

练习 B:PPT 生成

适合把当天培训内容整理成汇报材料。

请根据今天的培训大纲生成一个 8 页 PPT:
主题是 AI 编程工具入门,风格简洁,面向研发团队。

预期产出:PPT 草稿。验收方式:页数、结构、标题和重点是否符合要求。

练习 C:网页测试

适合技术同学,能看到 Agent 如何用浏览器验证结果。

请测试 http://localhost:3000 的登录页:
检查表单、错误提示、移动端布局,并给出修复建议。

预期产出:测试报告或截图。验收方式:问题是否可复现,建议是否能落到代码修改。

5. 现场练习流程

1

选择一个任务

从 PDF 摘要、PPT 生成、网页测试里选一个。不要只问“这个 Skill 是什么”,要给 Claude 一个具体任务。

2

准备输入材料

可以准备一份 PDF、一段培训记录、一个本地网页地址,或一个简单项目。不要使用包含密钥、客户信息或生产日志的材料。

3

让 Claude 明确产出格式

提示词里写清楚结果格式,例如“输出 5 条结论、3 个风险点、行动项表格”。格式越清楚,结果越容易验收。

4

检查结果

生成后继续追问:“哪些内容来自原文?哪些地方不确定?下一步应该怎么验证?” 不要把 AI 输出当作免审结果。

6. 安全检查清单

第三方 Skill 当作代码看待

Skill 可能包含脚本、依赖安装命令、外部网络请求或工具权限说明。启用前要读 SKILL.md,不要盲装来源不明的 Skill。

练习前准备

  • 提前安装并重启 Claude Code。
  • 准备一个无敏感信息的 demo 项目。
  • 准备 PDF、Excel、网页或 PPT 主题素材。
  • 关闭不必要的权限,尤其是 Shell 和外部网络访问。
  • 不要把公司密钥、客户数据、生产日志放进演示材料。

如何判断 Skill 是否靠谱

  • 来源是否可信,是否来自官方、知名组织或活跃开源仓库。
  • 说明是否清楚,有没有明确适用范围和限制。
  • 是否要求过宽权限,例如无理由访问网络或执行任意 Shell。
  • 是否包含依赖安装和脚本,脚本是否可读。
  • 最近是否维护,issue 和 PR 是否有人处理。

推荐现场策略

先演示官方或可信来源 Skill,再说明第三方 marketplace 只能作为发现入口。真正用于团队生产前,应由技术负责人审核后统一纳入团队 Skill 仓库。

参考来源

整理日期:2026-06-04。Skill 名称、下载量和 marketplace 排名会变化,演示前请重新确认。