Claude Code Skill 从入门到自定义完整教程（Windows 版）

Claude Code Skill（技能）是 Claude CLI 的插件系统，允许你通过简单的斜杠命令（/skill-name）调用预先定义好的复杂工作流。你可以把 Skill 理解为"给 Claude 装外挂"------一个 Skill 文件，即可让 Claude 具备生成小红书图片、转换 Markdown、发布公众号等专业能力。

一、什么是 Claude Skill

核心概念

Skill 本质上是一个包含 SKILL.md 文件的目录，它告诉 Claude：

这个 Skill 能做什么（功能描述）
何时自动触发（触发关键词）
如何操作（分步工作流）
可执行哪些脚本 （可选的 scripts/ 目录）

当你在对话中输入 /skill-name 或说出触发关键词时，Claude 会自动加载对应的 Skill 并按照其定义的流程工作。

Skill 与普通对话的区别

对比项	普通对话	使用 Skill
指令复杂度	需要详细描述每一步	一个命令自动执行完整流程
可重复性	每次结果不一致	标准化流程，结果稳定
专业能力	通用能力	领域专精（图像生成、发布等）
配置	无法记住偏好	支持 EXTEND.md 保存个人配置

两种 Skill 类型

纯提示词型 ：仅包含 SKILL.md，通过详细的自然语言指令引导 Claude 完成任务，无需安装任何依赖。

脚本增强型 ：包含 SKILL.md + scripts/ 目录，通过 Bun/Node.js 脚本调用 API、处理文件等，能力更强大。

二、安装与目录结构

Skill 存放位置

Skills 存放在固定目录，Claude CLI 启动时会自动扫描：

位置	路径	说明
项目级	`.claude/skills/<skill-name>/SKILL.md`	仅对当前项目生效
用户级	`Users/用户名/.claude/skills/<skill-name>/SKILL.md`	---

在 Windows 下，项目级 Skill 路径示例：

objectivec 复制代码

C:\Users\你的用户名\projects\myproject\
└── .claude\
    └── skills\
        ├── baoyu-image-gen\
        │   └── SKILL.md
        ├── baoyu-markdown-to-html\
        │   ├── SKILL.md
        │   └── scripts\
        │       └── main.ts
        └── my-custom-skill\
            └── SKILL.md

安装社区 Skill

社区提供了大量开箱即用的 Skill，以 baoyu 系列为例：

方式一：

powershell 复制代码

# 进入你的项目目录
cd C:\Users\你的用户名\projects\myproject

# 创建 skills 目录
New-Item -ItemType Directory -Force -Path ".claude\skills"

# 下载 baoyu-image-gen Skill（示例）
# 将 SKILL.md 等文件复制到对应目录即可

方式二：

直接告诉 Claude Code：

请帮我安装 github.com/JimLiu/baoyu-skills 中的 Skills

方式三：

注册插件市场

在 Claude Code 中运行：

bash 复制代码

/plugin marketplace add JimLiu/baoyu-skills

直接安装

css 复制代码

2. 安装指定插件
/plugin install content-skills@baoyu-skills

安装 Skill 后无需重启，Claude CLI 会在下次对话时自动识别。

三、使用 Skill

方式一：斜杠命令

在 Claude CLI 对话中，直接输入斜杠加 Skill 名称：

css 复制代码

/baoyu-image-gen 一只可爱的猫咪坐在窗边

/baoyu-markdown-to-html article.md --theme grace

/baoyu-xhs-images mcp-tutorial.md

方式二：自然语言触发

每个 Skill 都定义了触发关键词，说出对应词语时 Claude 会自动加载 Skill：

css 复制代码

帮我生成一张封面图片

把这篇 Markdown 转成 HTML

为这篇文章生成小红书图片系列

方式三：带参数调用

许多 Skill 支持参数选项：

bash 复制代码

/baoyu-image-gen --provider openai --ar 16:9 一片金色的麦田

/baoyu-markdown-to-html article.md --theme modern --color red

/baoyu-xhs-images mcp-tutorial.md --style notion --layout dense

查看可用 Skill

在 Claude CLI 中查看当前项目已安装的所有 Skill：

bash 复制代码

/skills

四、Skill 偏好配置（EXTEND.md）

什么是 EXTEND.md

EXTEND.md 是 Skill 的个人配置文件，用于保存你的使用偏好，避免每次都重复选择。

存放路径（优先级从高到低）：

xml 复制代码

项目级：.baoyu-skills/<skill-name>/EXTEND.md
用户级：C:\Users\你的用户名\.baoyu-skills\<skill-name>\EXTEND.md

配置示例

baoyu-image-gen 的 EXTEND.md：

yaml 复制代码

# baoyu-image-gen Preferences

default_provider: openai
default_quality: 2k
default_model:
  openai: gpt-image-1

首次运行自动引导

大多数 Skill 在首次使用时会自动弹出配置引导，回答几个问题后自动生成 EXTEND.md：

scss 复制代码

> /baoyu-image-gen 一只猫咪

[首次使用检测]
请选择默认图片生成服务商：
① OpenAI (gpt-image-1)
② Google (gemini-3-pro-image)
③ DashScope (通义万象)

你的选择：

五、开发自定义 Skill

最简 Skill 结构

只需一个 SKILL.md 文件即可创建 Skill：

bash 复制代码

.claude/skills/my-translator/
└── SKILL.md

SKILL.md 编写规范

SKILL.md 使用 YAML frontmatter + Markdown 正文格式：

markdown 复制代码

---
name: my-translator
description: Translates text between Chinese and English. Use when user asks to "translate", "翻译", or provides text to convert between languages.
---

# 智能翻译助手

将用户提供的文字在中英文之间互译，保持原文风格和语气。

## 工作流程

### Step 1：识别语言

检测输入文字的语言：
- 主要为中文 → 翻译成英文
- 主要为英文 → 翻译成中文
- 混合 → 询问用户目标语言

### Step 2：翻译

翻译时注意：
- 保持原文的语气（正式/口语）
- 专业术语保持准确
- 地道表达，避免直译

### Step 3：输出

输出格式：
- 原文（引用块显示）
- 译文（直接显示）
- 如有歧义，附加说明

## 使用示例

/my-translator Hello, how are you? /my-translator 今天天气真好翻译：这段英文合同条款

复制代码

带脚本的 Skill

如需调用外部 API 或处理文件，可以添加 scripts/main.ts：

bash 复制代码

.claude/skills/my-weather/
├── SKILL.md
└── scripts/
    └── main.ts

SKILL.md 中通过 Bash 调用脚本：

markdown 复制代码

## 执行查询

```bash
npx -y bun ${SKILL_DIR}/scripts/main.ts --city "北京"

php 复制代码

**scripts/main.ts** 示例：

```typescript
import { parseArgs } from "util";

const { values } = parseArgs({
  args: process.argv.slice(2),
  options: { city: { type: "string" } },
});

// 调用天气 API
const res = await fetch(`https://api.weather.com/?city=${values.city}`);
const data = await res.json();

console.log(JSON.stringify({
  city: values.city,
  temp: data.temperature,
  condition: data.condition,
}));

EXTEND.md 配置支持

在 SKILL.md 中说明支持哪些配置项，让用户可以通过 EXTEND.md 自定义行为：

markdown 复制代码

## 用户配置（EXTEND.md）

支持以下配置项：

# yaml
# 默认目标语言（zh / en）
default_target: zh

# 是否显示原文
show_original: true

# 翻译风格（formal / casual / literary）
style: casual

配置文件路径：$HOME/.skills/my-translator/EXTEND.md

六、总结

Claude Skill 将复杂的 AI 工作流封装成一个斜杠命令，大幅降低了重复性操作的门槛。通过本教程，你已经掌握了：

Skill 的核心概念与两种类型
安装和目录结构规范
三种使用方式：斜杠命令、自然语言、带参数调用
EXTEND.md 个人偏好配置
从零开发自定义 Skill 的完整流程

推荐资源：

Claude Code 官方文档：docs.anthropic.com/en/docs/cla...
baoyu Skill 集合：参考本教程中演示的各 baoyu-* 系列 Skill
Bun 运行时文档：bun.sh