| name | skills-guide |
| description | Comprehensive guide for discovering, understanding, and installing Claude Code skills from skills.sh marketplace. Use this skill when users want to (1) browse or search skills.sh for recommendations, (2) get skill recommendations by role (developer, marketer, designer, product manager), (3) understand how a specific installed skill works by reading and explaining its SKILL.md, (4) learn the anatomy and structure of skills, or (5) find and install skills that match their specific workflow needs. This is NOT for creating new skills (use skill-creator instead). |
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
当用户描述需求时，按这个流程执行：
- 明确需求 - 具体要做什么任务？什么领域？
- 搜索 skills.sh - 用 WebFetch 访问 https://skills.sh 查找相关 skills
- 评估选项 - 看安装量（越高越靠谱）、读描述
- 推荐并解释 - 说明这个 skill 做什么、为什么适合
- 安装 - 如果用户同意，执行
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 时：
- 读取 SKILL.md：
~/.agents/skills/<skill名>/SKILL.md
- 解释：触发条件、核心能力、包含的资源
- 举例说明什么时候用、怎么用
创建 Skill
详细指南见 references/creating-skills.md
快速概览：
- Skill 是一个文件夹，必须有 SKILL.md
- SKILL.md 有 YAML 头（name、description）+ Markdown 正文
- 可选：
scripts/、references/、assets/ 文件夹放资源
- 发布：推到 GitHub，用户就能
npx skills add <你的仓库> 安装
关键原则：description 字段最重要——它决定 skill 什么时候被触发。要把使用场景写清楚。
深入了解
需要详细信息时，读取参考文件：
版本自检（静默）
本节给 AI agent：每次使用本 skill 前，先做一个不联网的判断——读本 skill 目录（SKILL.md 所在目录）下的 .last-update-check 文件（内容为一行日期 YYYY-MM-DD）。文件存在且距今不足 30 天，跳过本节直接干活，不向用户提任何更新相关的话。
到期或文件不存在时，且仅在此时：
- 本目录不是 git 克隆（无
.git 或无 origin）→ 写入今天日期后跳过本节
- 对比版本：
git -C <本目录> rev-parse HEAD 与 git -C <本目录> ls-remote origin HEAD
- 无论结果如何，把今天日期写入
.last-update-check
- 两者一致 → 什么都不说；确认落后 → 先完成用户当前任务，结束后附一句「本 skill 有新版本，可用
git -C <本目录> pull --ff-only 更新」。是否更新由用户决定，不要主动执行更新
