Skill Creator Skill | Agent Skills

Skill Creator

帮助创建符合 Testany 规范的 Claude Code Skills。

Testany Skill 规范（强制）

命名与结构约定

| 约定项 | 规范 | |--------|------| | 命名语言 | 英文，kebab-case（如 prd-writer） | | 目录结构 | 扁平结构 skills/xxx/ | | 必须文件 | 只需 SKILL.md | | references 命名 | 英文 |

审核标准

| 审核项 | 要求 | |--------|------| | Frontmatter | 必须包含触发词 | | 行数限制 | SKILL.md < 500 行 | | 边界检查 | 必须通过 quick_validate.py + 人工审核 | | 语言 | 必须中文（技术术语可保留英文） | | 示例 | 必须有使用示例 |

目录结构

skill-name/
├── SKILL.md (必需)
└── references/ (可选，按需加载的参考文档)

不要创建 README.md、CHANGELOG.md 等额外文件。

核心原则

简洁优先

Context window 是公共资源。只添加 Claude 不知道的信息。

默认假设：Claude 已经很聪明。 用简洁示例代替冗长解释。

渐进式加载

Metadata（name + description）- 始终在 context 中
SKILL.md body - 触发后加载
references/ - 按需加载

Skill 创建流程

步骤 1：理解需求

通过具体示例理解 skill 的使用场景：

这个 skill 要支持什么功能？
用户会怎么使用它？
什么话会触发这个 skill？

步骤 2：规划内容

分析每个示例，确定需要的资源：

| 资源类型 | 用途 | 示例 | |----------|------|------| | references/ | 参考文档，按需加载 | 模板、规范、API 文档 | | scripts/ | 可执行脚本 | 验证、初始化工具 | | assets/ | 输出资源 | 图片、模板文件 |

步骤 3：初始化 Skill

scripts/init_skill.py <skill-name>

脚本默认输出到 skills/ 目录，会创建：

SKILL.md 模板
示例目录结构（scripts/、references/、assets/）

步骤 4：编写 SKILL.md

Frontmatter（必需）

---
name: skill-name
description: 触发词1、触发词2。功能描述，说明什么时候使用这个 skill。
---

重要：description 必须包含触发词，这是 skill 被激活的关键。

Body

使用中文撰写
简洁明了，< 500 行
包含使用示例
引用 references 时说明何时读取

步骤 5：验证

scripts/quick_validate.py skills/<skill-name>

检查项：

Frontmatter 格式
行数限制
触发词存在

步骤 6：人工审核

验证通过后，提交人工审核：

功能完整性
文档清晰度
示例有效性

参考示例：prd-writer

prd-writer 是一个符合 Testany 规范的 skill 示例：

prd-writer/
├── SKILL.md (233 行)
└── references/
    ├── new-feature-ui.md
    ├── new-feature-backend.md
    ├── integration.md
    ├── refactoring.md
    └── optimization.md

Frontmatter 示例：

---
name: prd-writer
description: 写 PRD、写产品需求文档、PRD 模板、新功能需求。帮助撰写高质量的产品需求文档，支持多种类型：新功能（有UI/无UI）、第三方集成、功能重构、性能/安全优化。
---

注意 description 开头的触发词：写 PRD、写产品需求文档、PRD 模板、新功能需求

常见问题

Q: references 和 assets 的区别？

references/：供 Claude 参考的文档，会加载到 context
assets/：输出资源（图片、模板），不加载到 context

Q: SKILL.md 太长怎么办？

拆分到 references/，在 SKILL.md 中引用并说明何时读取。

Q: 如何测试 skill？

运行 quick_validate.py 验证格式
实际使用测试功能
根据反馈迭代改进

Agent Skills: Skill Creator

Install this agent skill to your local

Skill Files