skill-new

skill-new

创建一个新的技能文件夹，并按当前项目的布局放置格式正确的 SKILL.md。

不适用情形

激活条件位于 frontmatter 的 when_to_use 字段中。 编辑现有技能时不要激活此技能—— 此技能仅用于创建新技能。

需要收集的信息

写入文件前，请确保已收集以下信息：

1. name — 全部小写，以连字符分隔，且在现有技能中唯一。 如果用户的请求中明显包含名称，则从中提取； 否则请询问用户。
2. description — 用一到两句话描述此技能的用途。 保持简洁； 激活条件应写在 when_to_use 中。 如果不明确，请询问用户。
3. when_to_use — 用于告知 Agent 何时激活此技能的触发条件： 用户可能会说的短语、文件类型、项目形态。 Agent 会结合 description 和 when_to_use 进行匹配，因此请写得具体。 如果不明确，请询问用户。
4. 正文内容 — 此技能激活时 Agent 应遵循的步骤。 如果用户尚未描述操作流程，请询问用户。

确定目标目录

查看项目中现有 SKILL.md 文件的位置， 并遵循相同的约定。 常见布局：

• skills/<name>/SKILL.md — 多技能仓库中最常见
• .claude/skills/<name>/SKILL.md — Claude 专用的项目布局
• 仓库根目录下的 <name>/SKILL.md — 扁平布局

如果找不到现有技能，则默认使用 skills/<name>/SKILL.md。

步骤

1. 按上述规则确定目标目录。
2. 确认目标路径尚不存在。 如果已存在，请停止并询问是要覆盖还是选择其他名称。
3. 创建目录。
4. 使用下方模板编写 SKILL.md。
5. 报告创建的路径。

SKILL.md 模板

---
name: <name>
description: >-
  <one or two sentences: what the skill does>
when_to_use: >-
  <triggers: phrases the user might say, file types, project shapes>
---

# <Human-readable title>

<One-paragraph summary of what the skill does.>

## Steps

1. <First action>
2. <Second action>
3. <Final action>

规则

• 除非技能确实需要，否则不要添加 scripts/ 或 references/ 子文件夹—— 保持脚手架精简。
• 不要编写单独的技能 README； SKILL.md 就是文档。
• Frontmatter 中的 name 必须与文件夹名称一致。