《Skill 开发从入门到精通教程》- 基础篇

2026-10-24

基础介绍名词可以看上一篇《Skill 开发从入门到精通教程》- 认知篇不再介绍了。
给大家介绍 Claude Code 的skill是怎么样做的，首先是先安装Claude Code环境，其次在应用市场安装create-skill，最后是利用create-skill来创建自己的skill。

安装 Claude Code

‌1. 官方安装脚本（推荐）‌：
curl -fsSL https://claude.ai/install.sh | bash，

2. ‌Homebrew 安装‌：
brew install --cask claude-code@latest

3. ‌npm 安装‌：
npm install -g @anthropic-ai/claude-code

你懂的原因可能有些用户安装需要梯子，我基本上都是选的国内源，npm注意版本 Node.js 18+

安装创建skill的skill

1. ‌插件市场‌（推荐）：

/plugin marketplace add anthropics/skills
/plugin install skill-creator@anthropic-agent-skills

2. ‌手动安装‌：

git clone https://github.com/anthropics/skills.git
cp -r skills/skills/skill-creator ~/.claude/skills/

注意一定要重启 Claude Code 才可识别，要不 /skill时看不到内容

skills 生效目录

1 2	`Claude Code 默认路径：~/.claude/skills/ 项目级别的skill默认路径：项目名称字/.claude/skills/`

怎么样使用 skill-creator

1
2

1. ‌在 Claude Code 中输入 /skill，确认列表中包含 skill-creator。
2. 直接输入：“‌请使用 skill-creator 帮我创建一个新技能‌”,AI 会开始询问你技能的名称、用途、输入输出等结构化问题。

生成的目录结构

你的技能文件夹名/
├── SKILL.md        # 核心指令文件（必需，唯一必填文件）
├── scripts/        # 可选：存放可执行脚本（sh/py/bat）
├── references/     # 可选：存放参考规范、文档、接口说明
└── assets/         # 可选：存放模板文件、静态配置、JSON模板

SKILL.md 正文的完整空白模板


# 技能名称
## 一、技能概述
简单说明本技能的核心功能、解决的问题、使用价值。
触发条件 出现"xxxx" 时执行

## 二、前置条件
1. 执行本技能需要满足的环境/文件基础条件
2. 对应项目/文件类型要求

## 三、适用与不适用场景
✅ 适用场景：明确哪些需求可以使用本技能
❌ 不适用场景：明确哪些需求禁止使用本技能

## 四、分步执行步骤
### Step 1：第一步操作
清晰直白的祈使句指令，明确AI需要执行的动作
**检查点**：执行对应命令/操作，验证本步骤是否完成

### Step 2：第二步操作
清晰直白的祈使句指令，明确AI需要执行的动作
**检查点**：执行对应命令/操作，验证本步骤是否完成

## 五、代码示例（Before / After）
### 常规场景
**修改前（Before）**

SKILL.md 标准正文功能作用

技能概述：简洁说明技能核心功能、解决的痛点与使用价值
前置条件：明确技能运行所需的环境、文件、项目基础要求
适用/不适用场景：划定技能使用边界，杜绝误触发、错执行问题
分步执行步骤：采用编号祈使句指令，逻辑清晰、无歧义，约束 AI 执行流程
Before/After 示例：提供直观参考标准，强制 AI 1:1 复刻规范格式
检查点校验：分步校验执行结果，实现“错即停”，降低排错成本
最终验证方式：全流程收尾校验，确认技能完整生效、无异常

skill 名字避坑

官方标准规范：文件夹名统一使用纯小写英文 + 连字符 -
禁止中文、中文符号、英文空格（错误示例：代码测试、test skill）
禁止大写英文、下划线分隔（错误示例：Test-Go、go_test）
禁止特殊符号、数字开头（错误示例：123test、go@test）

怎么样触发执行

在SKILL.md的技能概述中一般会写触发关健词或者指定skill名字来触发 /skill 名字开始干活