Menu
创建新的 Skill、修改和改进已有 Skill。当用户想要创建 Skill、编辑 Skill、 将当前工作流程转化为可复用 Skill、或者提供了一个现成的 Skill 内容要求适配时使用。 即使用户没有明确说"创建 skill"，只要他们表达了"把这个流程自动化"、"记住这个做法"、 "下次也这样做"之类的意图，也应该考虑使用此 skill。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | skill-creator |
| description | 创建新的 Skill、修改和改进已有 Skill。当用户想要创建 Skill、编辑 Skill、 将当前工作流程转化为可复用 Skill、或者提供了一个现成的 Skill 内容要求适配时使用。 即使用户没有明确说"创建 skill"，只要他们表达了"把这个流程自动化"、"记住这个做法"、 "下次也这样做"之类的意图，也应该考虑使用此 skill。 |
| user-invocable | false |
创建新 Skill 和迭代改进已有 Skill 的指南。
$HAPPYCLAW_SKILLS_DIR（由 HappyClaw 负责运行时链接）你的工作是判断用户处于哪个阶段，然后帮他们推进。可能他们说"我想做一个 X 的 skill"，那就从需求捕获开始；也可能他们已经有一份现成的 SKILL.md，那就直接进入适配/改进环节。
HappyClaw 有自己的 Skill 管理机制。创建、迁移或修改用户级 Skill 时，只把源文件写到 $HAPPYCLAW_SKILLS_DIR（宿主机对应 data/skills/{ownerId}/）。不要把 HappyClaw Skill 安装到 provider 原生目录，例如 ~/.claude/skills、~/.codex/skills、~/.agents/skills。
这些 provider 原生目录可能只对某个 runner 或当前宿主环境生效，不会进入 HappyClaw 的 /api/skills、Web Skills 管理页，也不保证能被未来自动新建的 workspace 继承。data/sessions/<workspace>/.claude/skills / .claude/skills 这类目录只应视为 HappyClaw 启动 runtime 时生成的链接层或缓存，不是持久化来源。
只有在用户明确要求“给 Codex/Claude 原生环境单独安装一个 skill，和 HappyClaw 无关”时，才考虑写入 provider 原生目录，并且要说明它不会被 HappyClaw 统一管理。
从对话上下文中提取信息，必要时向用户提问：
Bash、Read、Edit 等）如果当前对话中已经包含了一个完整的工作流程（比如用户说"把刚才这个流程做成 skill"），直接从对话历史中提取：用了什么工具、步骤顺序、用户做了哪些修正、输入输出格式。
{skill-id}/ ← 目录名就是 skill ID
├── SKILL.md ← 必需（skill 定义文件）
├── scripts/ ← 可选（可执行脚本，用于确定性/重复性任务）
├── references/ ← 可选（参考文档，按需加载到上下文）
└── assets/ ← 可选（模板、图标等静态资源）
skill-id 命名规则：只允许字母、数字、下划线、连字符（正则：/^[\w\-]+$/）。用小写加连字符，如 code-reviewer、daily-report。
---
name: my-skill
description: >
这个 skill 做什么、什么时候应该触发。描述要具体，
涵盖触发场景和关键词，让 Claude 能准确判断何时使用。
user-invocable: true
allowed-tools: Bash(*), Read, Edit
argument-hint: <参数说明>
---
# Skill 标题
Markdown 格式的详细指令...
| 字段 | 必需 | 说明 |
|---|---|---|
name | 是 | 显示名称 |
description | 是 | 触发描述——这是 Claude 决定是否使用此 skill 的主要依据 |
user-invocable | 否 | 用户能否通过 /skill-name 直接调用（默认 true） |
allowed-tools | 否 | 允许使用的工具，逗号分隔（如 Bash(*), Read, Edit） |
argument-hint | 否 | 参数提示文本 |
将 SKILL.md 重命名为 SKILL.md.disabled 即可禁用，反之启用。用户也可以在 Web UI 的 Skills 页面切换。
Skill 使用三层加载机制，合理分配上下文：
要点：
references/ 目录，SKILL.md 中给出清晰的指引cloud-deploy/
├── SKILL.md ← 工作流 + 选择逻辑
└── references/
├── aws.md
├── gcp.md
└── azure.md
description 是触发的核心机制。Claude 看到用户消息后，根据 description 判断是否需要这个 skill。
写得"主动"一些：Claude 目前倾向于"少触发"，所以 description 要稍微"推"一下。比如：
不够好：如何构建数据展示面板。
更好：如何构建数据展示面板。当用户提到仪表盘、数据可视化、指标展示、或者想要展示任何类型的数据时都应该使用此 skill，即使他们没有明确说"面板"。
## 提交消息格式
**示例 1：**
输入：添加了基于 JWT 的用户认证
输出：feat(auth): 实现 JWT 认证
**示例 2：**
输入：修复了侧边栏在移动端的滚动问题
输出：fix(ui): 修复移动端侧边栏滚动
scripts/ 目录Skills 目录路径通过环境变量 $HAPPYCLAW_SKILLS_DIR 获取。这个目录是 HappyClaw 用户级 Skill 的唯一持久化来源。
# 创建 skill 目录和 SKILL.md
mkdir -p "$HAPPYCLAW_SKILLS_DIR/my-new-skill"
# 然后用 Write/Edit 工具写入 $HAPPYCLAW_SKILLS_DIR/my-new-skill/SKILL.md
不要额外写入 ~/.claude/skills、~/.codex/skills、~/.agents/skills。HappyClaw 会在每次 runtime 启动时自动把 $HAPPYCLAW_PROJECT_SKILLS_DIR 和 $HAPPYCLAW_SKILLS_DIR 链接进 session 目录；Codex 的 tool-loader 也会直接扫描这两个目录。
如果当前 runtime 已经启动，新创建的 skill 通常从下一轮/下一次 runtime 启动开始稳定可见。需要立刻验证时，优先直接读取 $HAPPYCLAW_SKILLS_DIR/<skill-id>/SKILL.md 或重新启动一次相关 runtime，不要为了“立即可见”污染 provider 原生目录。
用户级 skill 的实际文件在 $HAPPYCLAW_SKILLS_DIR/ 中，可以直接用 Read/Edit 工具修改。项目级 skill 在 $HAPPYCLAW_PROJECT_SKILLS_DIR（通常是 /workspace/project-skills/ 或 container/skills/）中，默认只读；要定制它们，使用下面的覆盖机制。
系统自带的默认 skill（如 agent-browser、post-test-cleanup）是项目级的，只读挂载。如果你觉得某个默认 skill 需要根据当前环境精简或调整（比如去掉不适用的命令、添加特定于当前系统的配置），按以下步骤操作：
# 1. 复制默认 skill 到用户目录
cp -r /workspace/project-skills/agent-browser "$HAPPYCLAW_SKILLS_DIR/agent-browser"
# 2. 编辑用户目录中的副本（这里可以随意修改）
# 用 Read/Edit 工具修改 $HAPPYCLAW_SKILLS_DIR/agent-browser/SKILL.md
# 3. 无需手动写 provider 原生目录；HappyClaw 下次 runtime 启动会自动链接用户级覆盖
原理：runtime 启动时，符号链接按"项目级 → 用户级"的顺序创建，同名的用户级 skill 会自动覆盖项目级。所以只要在用户目录放一个同名目录，下次启动就生效。
恢复默认：在 Web UI 的 Skills 页面删除用户级的同名 skill，或者手动 rm -rf "$HAPPYCLAW_SKILLS_DIR/agent-browser"。下次启动时项目级原版会自动恢复。
注意：只复制你需要修改的 skill，不要批量复制所有默认 skill。保持用户目录精简，未来项目级 skill 更新时未被覆盖的会自动获得更新。
ls "$HAPPYCLAW_SKILLS_DIR" # 列出用户级 skill
ls "$HAPPYCLAW_PROJECT_SKILLS_DIR" # 列出项目级 skill
cat "$HAPPYCLAW_SKILLS_DIR"/*/SKILL.md # 查看用户级 skill 内容
创建 skill 后，和用户一起测试和改进：
改进时的原则：
创建的 skill 不得包含：
$ANTHROPIC_API_KEY）的指令skill 的内容应该是"如果描述给用户听，不会让他们感到意外"的。