Skills 完整指南

帮助用户理解、查找和创建 Claude Code Skills。

快速问答

什么是 Skills？ Skills 是扩展 Claude 能力的模块化包。可以理解为"专家知识包"——给 Claude 注入特定领域的工作流、专业知识和工具。

在哪找 Skills？ skills.sh - 开放的 Skills 目录，按安装量排行。

怎么安装？

npx skills add <owner/repo> --yes

Skills 装在哪？ ~/.agents/skills/ - 每个 skill 一个文件夹，里面有 SKILL.md 文件。

帮用户找 Skill

当用户描述需求时，按这个流程执行：

1. 明确需求 - 具体要做什么任务？什么领域？
2. 搜索 skills.sh - 用 WebFetch 访问 https://skills.sh 查找相关 skills
3. 评估选项 - 看安装量（越高越靠谱）、读描述
4. 推荐并解释 - 说明这个 skill 做什么、为什么适合
5. 安装 - 如果用户同意，执行 npx skills add <owner/repo> --yes

热门推荐速查

开发者：

• vercel-labs/agent-skills → React/Next.js 最佳实践（37k+ 安装）
• anthropics/skills → 官方文档处理（PDF、Word、PPT、Excel）
• expo/skills → 移动应用开发

产品/运营/市场：

• coreyhaines31/marketingskills → 23个营销skills（文案、定价、SEO、广告）

内容创作者（中文友好）：

• jimliu/baoyu-skills → 幻灯片、配图、小红书图片（宝玉老师出品）

解读已安装的 Skill

当用户想了解某个 skill 时：

1. 读取 SKILL.md：~/.agents/skills/<skill名>/SKILL.md
2. 解释：触发条件、核心能力、包含的资源
3. 举例说明什么时候用、怎么用

创建 Skill

详细指南见 references/creating-skills.md

快速概览：

1. Skill 是一个文件夹，必须有 SKILL.md
2. SKILL.md 有 YAML 头（name、description）+ Markdown 正文
3. 可选：scripts/、references/、assets/ 文件夹放资源
4. 发布：推到 GitHub，用户就能 npx skills add <你的仓库> 安装

关键原则：description 字段最重要——它决定 skill 什么时候被触发。要把使用场景写清楚。

深入了解

需要详细信息时，读取参考文件：

• references/skills-anatomy.md - Skills 技术结构详解
• references/creating-skills.md - 从零创建 skill 的完整指南
• references/top-skills.md - 按角色和场景分类的热门推荐

版本自检（静默）

本节给 AI agent：每次使用本 skill 前，先做一个不联网的判断——读本 skill 目录（SKILL.md 所在目录）下的 .last-update-check 文件（内容为一行日期 YYYY-MM-DD）。文件存在且距今不足 30 天，跳过本节直接干活，不向用户提任何更新相关的话。

到期或文件不存在时，且仅在此时：

1. 本目录不是 git 克隆（无 .git 或无 origin）→ 写入今天日期后跳过本节
2. 对比版本：git -C <本目录> rev-parse HEAD 与 git -C <本目录> ls-remote origin HEAD
3. 无论结果如何，把今天日期写入 .last-update-check
4. 两者一致 → 什么都不说；确认落后 → 先完成用户当前任务，结束后附一句「本 skill 有新版本，可用 git -C <本目录> pull --ff-only 更新」。是否更新由用户决定，不要主动执行更新