关于 create-skill
用于在 `.agents/skills/` 中创建新技能的仓库工作流指南，涵盖需求收集、目录结构、可选的公开同步，以及使用仓库命令进行验证。
主要功能
- 01收集名称和预期行为
- 02阅读仓库技能规范
- 03创建所需技能结构
- 04将公开技能同步到 Claude
- 05使用 pnpm skills:check 验证
适用场景
- 01创建仓库私有技能
- 02准备公开共享的技能
- 03按仓库规则检查新技能
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/create-skill确认已加载。
详细介绍
创建技能
按照 .agents/skills/README.md 中定义的工作流，在 .agents/skills/<skill-name>/ 中创建一个新技能。
工作流
第 1 步：收集意图
在创建任何内容之前，先询问用户：
- 技能名称：技能应该叫什么？（仅小写字母、数字、连字符，例如
gh-create-pr、prepare-release） - 描述：这个技能应该做什么？包括具体的触发场景（例如“当用户要求创建 PR 时使用”）
- 这是公共技能吗？：是否应将其同步到
.claude/skills/以供共享使用？（默认：否，仅私有） - 测试用例（可选）：用户是否想为此技能设置评估？
如果用户只提供了部分信息（例如只提供了名称），则采用合理的默认值继续，并请求确认。
第 2 步：阅读指南
在创建新技能之前，始终阅读 .agents/skills/README.md，以确保符合当前工作流。
第 3 步：创建技能结构
创建以下目录结构：
.agents/skills/<skill-name>/
└── SKILL.md
SKILL.md 模板：
---
name: <skill-name>
description: <description>
---
# <Skill Name>
[Instructions for the skill]
Frontmatter 字段：
name：技能标识符（小写字母、数字、连字符）description：何时触发（技能做什么 + 具体场景）
第 4 步：同步（如果是公共技能）
如果用户想要一个公共技能，则在验证之前：
- 将技能名称添加到
.agents/skills/public-skills.txt（每行一个，不要行内注释） - 运行同步：
pnpm skills:sync
这会在 .claude/skills/<skill-name>/ 创建一个指向 .agents/skills/<skill-name>/ 的符号链接。
注意：pnpm skills:check 主要验证公共技能（即 public-skills.txt 中的技能），也会验证相关的治理文件，因此必须先同步再验证。
第 5 步：验证
运行验证命令：
pnpm skills:check
如果有问题，请修复并重新运行。
第 6 步：总结
向用户展示：
- 已创建的文件
- 验证结果
- 后续步骤（如何使用该技能）
命名规则
- 仅使用小写字母、数字和连字符
- 优先使用简短、面向动作的名称（例如
gh-create-pr）
公共技能与私有技能
| 类型 | 位置 | 同步 | 要求 |
|---|---|---|---|
| 私有 | .agents/skills/ | 否 | 只需创建文件夹 |
| 公共 | 两者 | 是 | 添加到 public-skills.txt + 运行 pnpm skills:sync |
命令参考
# Validate skill structure
pnpm skills:check
# Sync public skills to Claude
pnpm skills:sync
约束
- 绝不要在
.agents/skills/<skill-name>/之外创建技能 - 在完成之前始终运行
pnpm skills:check - 公共技能既需要添加到
public-skills.txt，也需要运行pnpm skills:sync - 如果 skill-creator 技能可用，你可以使用它进行高级技能开发（评估、迭代），但本技能负责基本创建流程。
评论
支持 Markdown