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: 做什么 + 什么时候触发（这是最重要的字段）

Skill 标题

[指令内容]

触发词

• "关键词1"
• "关键词2"

执行步骤

1. xxx
2. xxx

示例

[示例用法]

设计原则

1. 简洁为王

• 上下文窗口是共享的，假设 Claude 已经很聪明

• 只添加 Claude 不知道的信息

• 用简洁示例代替冗长解释

2. 设置合适的自由度

自由度 何时使用 形式

高 多种有效方法，依赖上下文判断 文字说明

中 有推荐模式，允许一些变化 伪代码/脚本

低 操作脆弱，一致性关键 精确脚本

3. 渐进加载（三层）

• 元数据（~100词）- 始终在上下文中

• SKILL.md 主体（<5k词）- skill 触发时加载

• 附加资源 - Claude 按需加载

创建流程

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 仓库