| name | skill-creator |
| description | 创建新的 Claude Code Skill。当用户说"帮我创建一个 skill"、"把这个变成 skill"、"新建技能"时触发。 |
Skill Creator
帮助创建有效的 Claude Code Skill。
触发词
- "帮我创建一个 skill"
- "把这个变成 skill"
- "新建技能"
- "/create-skill"
Skill 核心概念
Skill 是模块化的能力包，用于扩展 Claude 的能力：
- 专业工作流：多步骤的领域流程
- 工具集成：特定文件格式或 API 的使用方法
- 领域知识：公司特定知识、schema、业务逻辑
- 打包资源：脚本、参考文档、资产文件
Skill 目录结构
skill-name/
├── SKILL.md # 必须 - 核心指令
└── 可选资源/
├── scripts/ # 可执行脚本（Python/Bash）
├── references/ # 参考文档（按需加载）
└── assets/ # 输出资源（模板、图标）
SKILL.md 格式
---
name: skill-name
description: 做什么 + 什么时候触发（这是最重要的字段）
---
[指令内容]
- "关键词1"
- "关键词2"
1. xxx
2. xxx
[示例用法]
设计原则
1. 简洁为王
- 上下文窗口是共享的，假设 Claude 已经很聪明
- 只添加 Claude 不知道的信息
- 用简洁示例代替冗长解释
2. 设置合适的自由度
| 自由度 | 何时使用 | 形式 |
|---|
| 高 | 多种有效方法，依赖上下文判断 | 文字说明 |
| 中 | 有推荐模式，允许一些变化 | 伪代码/脚本 |
| 低 | 操作脆弱，一致性关键 | 精确脚本 |
3. 渐进加载（三层）
- 元数据（~100词）- 始终在上下文中
- SKILL.md 主体（<5k词）- skill 触发时加载
- 附加资源 - Claude 按需加载
创建流程
方法一：使用脚本（推荐）
.claude/skills/skill-creator/scripts/create-skill.js <skill-name> [description]
.claude/skills/skill-creator/scripts/create-skill.js my-skill "我的自定义技能"
方法二：手动创建
Step 1: 理解需求
- 这个 skill 要做什么？
- 用户会怎么触发它？
- 需要什么输入/输出？
Step 2: 规划资源
- 需要脚本吗？放
scripts/
- 需要参考文档吗？放
references/
- 需要模板/资产吗？放
assets/
Step 3: 创建目录
mkdir -p .claude/skills/你的skill名
Step 4: 编写 SKILL.md
- frontmatter: 清晰的 name + 全面的 description
- body: 使用 skill 和资源的指令
Step 5: 测试迭代
- 在真实任务中使用
- 发现问题或低效
- 更新 SKILL.md 或资源
- 重复
不要包含的文件
- README.md
- INSTALLATION_GUIDE.md
- CHANGELOG.md
- 其他与 skill 功能无关的文件
存放位置
| 位置 | 作用域 |
|---|
~/.claude/skills/ | 个人全局 |
项目/.claude/skills/ | 项目级，可 git 共享 |
示例：创建一个简单 skill
用户：帮我把"渲染公众号文章"变成 skill
执行：
- 创建目录
.claude/skills/render-article/
- 编写 SKILL.md
- 测试触发词是否有效
参考：官方 Skill 仓库
