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

Claude Code Skill 从入门到自定义完整教程(Windows 版)Claude Code Skill 技能 是 Claude CLI 的插件系统 允许你通过简单的斜杠命令 skill name 调用预先定义好的复杂工作流 你可以把 Skill 理解为 给 Claude 装外挂 一个 Skill 文件 即可让 Claude 具备生成小红书图片 转换 Markdown 发布公众号等专业能力 Skill 本质上是一个包含

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

01-cover-claude-skill-tutorial.png


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

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

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

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

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

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


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

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

在 Windows 下,项目级 Skill 路径示例:

C:Users你的用户名projectsmyproject └── .claude

GPT plus 代充 只需 145└── skills ├── baoyu-image-gen │ └── SKILL.md
    ├── baoyu-markdown-to-html
    │   ├── SKILL.md │ └── scripts │ └── main.ts └── my-custom-skill └── SKILL.md 

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

方式一:
# 进入你的项目目录 cd C:Users你的用户名projectsmyproject # 创建 skills 目录 New-Item -ItemType Directory -Force -Path ".claudeskills" # 下载 baoyu-image-gen Skill(示例) # 将 SKILL.md 等文件复制到对应目录即可 
方式二:

直接告诉 Claude Code:

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

方式三:
  1. 注册插件市场

在 Claude Code 中运行:

GPT plus 代充 只需 145/plugin marketplace add JimLiu/baoyu-skills 

2. 直接安装

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

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


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

GPT plus 代充 只需 145/baoyu-image-gen 一只可爱的猫咪坐在窗边 /baoyu-markdown-to-html article.md --theme grace /baoyu-xhs-images mcp-tutorial.md 

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

帮我生成一张封面图片

把这篇 Markdown 转成 HTML

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

许多 Skill 支持参数选项:

GPT plus 代充 只需 145/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

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

/skills 

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

存放路径(优先级从高到低):

GPT plus 代充 只需 145项目级:.baoyu-skills/<skill-name>/EXTEND.md 用户级:C:Users你的用户名.baoyu-skills<skill-name>EXTEND.md 

baoyu-image-gen 的 EXTEND.md:

# baoyu-image-gen Preferences

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

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

GPT plus 代充 只需 145> /baoyu-image-gen 一只猫咪

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

你的选择:


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

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

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

GPT plus 代充 只需 145— 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 今天天气真好 翻译:这段英文合同条款

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

GPT plus 代充 只需 145.claude/skills/my-weather/ ├── SKILL.md └── scripts/

└── main.ts 

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

GPT plus 代充 只需 145 执行查询

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

 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, }));

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

GPT plus 代充 只需 145 用户配置(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

小讯
上一篇 2026-03-19 11:54
下一篇 2026-03-19 11:52

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/241489.html