Skills Guide

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](references/skills-anatomy.md) - Skills 技术结构详解
• [references/creating-skills.md](references/creating-skills.md) - 从零创建 skill 的完整指南
• [references/top-skills.md](references/top-skills.md) - 按角色和场景分类的热门推荐

创建 Skills 完整指南

创建流程概览

1. 明确需求 - 这个 skill 要解决什么问题？ 2. 设计结构 - 需要哪些资源？ 3. 编写 SKILL.md - 核心文件 4. 测试 - 本地安装测试 5. 发布 - 推送到 GitHub

Step 1: 明确需求

问自己：

• 什么任务会反复出现？
• Claude 缺少什么专业知识？
• 有哪些固定的工作流程？

好的 skill 场景：

• ✅ SEO 审计 - 有固定检查清单
• ✅ 品牌设计 - 有具体规范要遵循
• ✅ PDF 处理 - 需要特定工具和脚本
• ✅ 公司内部流程 - 有特定的操作步骤

不适合做 skill 的：

• ❌ 一次性任务
• ❌ Claude 本身就擅长的通用任务
• ❌ 没有固定模式的工作

Step 2: 设计结构

确定需要什么资源：

Step 3: 编写 SKILL.md

3.1 写好 Description

这是最重要的部分。Description 决定 skill 何时触发。

模板：

description: [做什么]. Use when [触发场景1], [触发场景2], [关键词列表].

示例：

description: Comprehensive SEO audit framework for diagnosing website
optimization issues. Use when users ask about "SEO audit," "technical SEO,"
"why am I not ranking," "SEO issues," "on-page SEO," "meta tags review,"
or "SEO health check."

3.2 选择结构模式

工作流模式（适合有步骤的流程）：

## Workflow
1. Step 1: ...
2. Step 2: ...
3. Step 3: ...

任务模式（适合工具集合）：

## Quick Start
...
## Task 1: Create
...
## Task 2: Edit
...

指南模式（适合规范/标准）：

## Guidelines
...
## Specifications
...

3.3 保持精简

• 主文件 < 500 行
• 详细内容放 references/
• 只写 Claude 不知道的信息

Step 4: 本地测试

把 skill 文件夹复制到 ~/.agents/skills/：

cp -r my-skill ~/.agents/skills/

然后在 Claude Code 中测试：

• 触发是否正常？
• 输出是否符合预期？
• 有没有遗漏的场景？

Step 5: 发布到 GitHub

1. 创建 GitHub 仓库

• 仓库名建议和 skill 名一致
• 可以一个仓库放多个 skills

2. 组织文件结构

   my-repo/
   ├── skill-a/
   │   └── SKILL.md
   └── skill-b/
       └── SKILL.md

3. 推送代码

   git init
   git add .
   git commit -m "Initial skill release"
   git remote add origin https://github.com/username/repo.git
   git push -u origin main

4. 用户安装

   npx skills add username/repo

最佳实践

Description 写作

• ✅ 列出所有触发关键词
• ✅ 描述具体使用场景
• ❌ 不要太短（会漏触发）
• ❌ 不要太模糊（会误触发）

内容组织

• ✅ 渐进式披露：核心在 SKILL.md，详情在 references
• ✅ 使用示例：比长解释更有效
• ❌ 不要重复 Claude 已知的知识
• ❌ 不要创建多余的文档（README、CHANGELOG 等）

资源管理

• ✅ scripts：测试后再打包
• ✅ references：按主题拆分，按需加载
• ✅ assets：只放必要的模板

发布到 skills.sh

skills.sh 会自动索引 GitHub 上的 skills：

• 用户安装后会被统计
• 安装量决定排名
• 高质量 skill 会自然上升

提升曝光的方法：

• 写清楚的 description
• 解决真实痛点
• 在社交媒体分享

Skills 技术结构详解

什么是 Skills

Skills 是 Claude Code 的能力扩展包。它们把专业知识、工作流程、工具集成打包成模块，让 Claude 从通用助手变成特定领域的专家。

类比：

• Skills 之于 Claude = 插件之于 Chrome
• Skills 之于 Claude = App 之于手机

核心文件：SKILL.md

每个 skill 必须有一个 SKILL.md 文件，包含两部分：

1. YAML Frontmatter（元数据）

---
name: skill-name
description: 详细描述这个 skill 做什么，以及什么时候触发它。
---

关键点：

• name：skill 名称，必须和文件夹名一致
• description：最重要的字段 - Claude 根据这个判断是否触发 skill
• description 要包含：功能描述 + 触发场景 + 关键词

好的 description 示例：

description: Comprehensive document creation, editing, and analysis with support
for tracked changes, comments, formatting preservation, and text extraction.
Use when Claude needs to work with professional documents (.docx files) for:
(1) Creating new documents, (2) Modifying or editing content, (3) Working with
tracked changes, (4) Adding comments, or any other document tasks.

2. Markdown Body（指令主体）

skill 触发后加载的内容，包含：

• 工作流程指导
• 具体指令
• 资源引用
• 示例

目录结构

skill-name/
├── SKILL.md           # 必需 - 主文件
├── scripts/           # 可选 - 可执行脚本
│   └── helper.py
├── references/        # 可选 - 参考文档
│   └── api-docs.md
└── assets/            # 可选 - 输出资源
    └── template.pptx

scripts/ 目录

存放可执行代码（Python/Bash 等），用于：

• 重复性任务（每次都要写相同代码）
• 需要确定性输出的操作
• 复杂的数据处理

示例：PDF skill 的 rotate_pdf.py、extract_text.py

references/ 目录

存放参考文档，用于：

• API 文档
• 数据库 schema
• 详细的工作流指南
• 公司政策/规范

关键：只在需要时加载，保持主文件精简

assets/ 目录

存放输出用的资源文件：

• 模板文件（.pptx, .docx）
• 图片、图标
• 字体文件
• 项目脚手架

三层加载机制

Skills 使用渐进式加载，节省上下文空间：

设计原则：上下文是公共资源，能不加载就不加载。

触发机制

Claude 根据 description 字段判断是否触发 skill：

1. 用户发送消息 2. Claude 扫描所有已安装 skill 的 description 3. 匹配到相关 skill → 加载 SKILL.md body 4. 执行 skill 中的指令

所以 description 要写好：

• ✅ 明确列出触发场景
• ✅ 包含用户可能使用的关键词
• ❌ 不要写在 body 里（触发前看不到）

安装位置

所有 skills 安装在：~/.agents/skills/

每个 skill 一个文件夹：

~/.agents/skills/
├── pdf/
├── docx/
├── seo-audit/
└── frontend-design/

Skills 热门推荐

数据来源：skills.sh，更新时间 2026年1月

按角色推荐

开发者必装

安装命令：

npx skills add vercel-labs/agent-skills --yes
npx skills add expo/skills --yes

产品经理 / 运营

安装命令（一次装 23 个营销 skills）：

npx skills add coreyhaines31/marketingskills --yes

市场 / 内容创作

设计师

安装命令：

npx skills add anthropics/skills --yes

中文用户友好

宝玉老师（@dotey）的 skills，专为中文场景设计：

安装命令：

npx skills add jimliu/baoyu-skills --yes

按场景推荐

文档处理

Anthropic 官方出品：

npx skills add anthropics/skills --yes

浏览器自动化

适合：批量截图、自动登录、数据采集、竞品分析

视频制作

官方仓库汇总

如何选择

1. 先看安装量 - 高安装量 = 经过验证 2. 看出品方 - 官方/大厂优先 3. 看描述 - 是否匹配你的需求 4. 装上试试 - 用几次就知道好不好

发现新 Skills

• skills.sh - 按安装量排行
• GitHub 搜索 - 搜 "claude skill" 或 "SKILL.md"
• X/Twitter - 关注 @anthropicclaude、@dotey