aster110/skill-creator

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. 渐进加载（三层）

1. 元数据（~100词）- 始终在上下文中
2. SKILL.md 主体（<5k词）- skill 触发时加载
3. 附加资源 - 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: 测试迭代

1. 在真实任务中使用
2. 发现问题或低效
3. 更新 SKILL.md 或资源
4. 重复

---

不要包含的文件

• README.md
• INSTALLATION_GUIDE.md
• CHANGELOG.md
• 其他与 skill 功能无关的文件

---

存放位置

| 位置 | 作用域 | |------|--------| | ~/.claude/skills/ | 个人全局 | | 项目/.claude/skills/ | 项目级，可 git 共享 |

---

示例：创建一个简单 skill

用户：帮我把"渲染公众号文章"变成 skill

执行：

1. 创建目录 .claude/skills/render-article/
2. 编写 SKILL.md
3. 测试触发词是否有效

---

参考：官方 Skill 仓库