agent-skills-creator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Agent Skills Creator

Agent Skills 创作指南

Create skills that follow the Agent Skills open format. Covers the full lifecycle from pattern selection through validation and README update.

创作遵循Agent Skills开放格式的Skills。涵盖从模式选择到验证及README更新的完整生命周期。

Reference Files

参考文件

File	Read When
`references/format-specification.md`	Default: frontmatter constraints, directory structure, naming rules
`references/skill-patterns.md`	Choosing a pattern or need a structural template for a specific skill type
`references/quality-checklist.md`	Final validation before shipping

文件	阅读时机
`references/format-specification.md`	默认场景：前置元数据约束、目录结构、命名规则
`references/skill-patterns.md`	选择模式或需要特定类型Skill的结构模板时
`references/quality-checklist.md`	发布前的最终验证环节

Choose a Skill Pattern

选择Skill模式

Pattern	When to use	Example	Key files
Simple/hub	Dispatch to 2-5 focused files by track	`design-ui`	SKILL.md + track files
Workflow	Multi-step process with progressive loading	`agents-md` , `plan-feature`	SKILL.md + `references/`
Rules-based	Audit/lint with categorized rules	`audit-typography` , `docs-writing`	SKILL.md + `rules/`
Mixed	Workflow with conditional references	`multi-tenant-platform-architecture`	SKILL.md + `references/`

Decision guide:

Auditing or linting against a checklist: rules-based
Guiding a multi-step process: workflow
Dispatching to different tracks by context: simple/hub
Unsure: start with workflow (most flexible)

Load

references/skill-patterns.md

for structural templates and skeletons of each pattern.

模式	适用场景	示例	核心文件
Simple/hub	根据分类调度至2-5个聚焦文件	`design-ui`	SKILL.md + 分类文件
Workflow	带渐进式加载的多步骤流程	`agents-md` , `plan-feature`	SKILL.md + `references/`
Rules-based	带分类规则的审核/检查	`audit-typography` , `docs-writing`	SKILL.md + `rules/`
Mixed	带条件参考的工作流	`multi-tenant-platform-architecture`	SKILL.md + `references/`

决策指南：

针对检查清单进行审核或检查：基于规则
指导多步骤流程：工作流
根据上下文调度至不同分类：Simple/hub
不确定时：从工作流开始（灵活性最高）

加载

references/skill-patterns.md

获取各模式的结构模板和框架。

Creation Workflow

创作工作流

Copy this checklist to track progress:

text

Skill creation progress:
- [ ] Step 1: Choose skill pattern
- [ ] Step 2: Create directory and frontmatter
- [ ] Step 3: Write SKILL.md body
- [ ] Step 4: Add reference or rule files
- [ ] Step 5: Validate with quality checklist
- [ ] Step 6: Update README.md
- [ ] Step 7: Smoke-test installation

复制以下检查清单以跟踪进度：

text

Skill创作进度：
- [ ] 步骤1：选择Skill模式
- [ ] 步骤2：创建目录和前置元数据
- [ ] 步骤3：编写SKILL.md主体内容
- [ ] 步骤4：添加参考或规则文件
- [ ] 步骤5：使用质量检查清单进行验证
- [ ] 步骤6：更新README.md
- [ ] 步骤7：安装冒烟测试

Step 1: Choose skill pattern

步骤1：选择Skill模式

Use the pattern table above. Load

references/skill-patterns.md

for full templates.

使用上方的模式表格。加载

references/skill-patterns.md

获取完整模板。

Step 2: Create directory and frontmatter

步骤2：创建目录和前置元数据

Load

references/format-specification.md

for hard constraints.

Create
```
skills/<name>/SKILL.md
```
Folder name must match
```
name
```
field (kebab-case)
```
name
```
: max 64 chars, lowercase letters/numbers/hyphens, no "anthropic" or "claude"
```
description
```
: max 1024 chars, third-person voice, include "Use when..." triggers with specific keywords

加载

references/format-specification.md

查看硬性约束。

创建
```
skills/<name>/SKILL.md
```
文件夹名称必须与
```
name
```
字段匹配（短横线命名法）
```
name
```
：最多64字符，仅包含小写字母/数字/短横线，不能包含“anthropic”或“claude”
```
description
```
：最多1024字符，使用第三人称语气，包含带特定关键词的“适用于...场景”触发语

Step 3: Write SKILL.md body

步骤3：编写SKILL.md主体内容

Keep under 500 lines; split into reference files if longer
Only add context Claude does not already have
Use consistent terminology throughout
Include a copyable progress checklist for multi-step workflows
Include validation/feedback loops for quality-critical tasks

内容控制在500行以内；若超过则拆分至参考文件
仅添加Claude尚不具备的上下文信息
全程使用一致的术语
为多步骤工作流添加可复制的进度检查清单
为质量关键型任务添加验证/反馈环节

Step 4: Add reference or rule files

步骤4：添加参考或规则文件

Workflow/mixed pattern: add

references/

folder with focused files. Link each from SKILL.md with "Read when..." guidance in a table.

Rules-based pattern: add

rules/

folder. See the rules folder section below.

Simple/hub pattern: add track files alongside SKILL.md. Link from a tracks table.

Key constraints:

References must be one level deep from SKILL.md (no chains)
Files over 100 lines need a table of contents at the top
Files are only loaded when explicitly listed in SKILL.md

工作流/混合模式：添加

references/

文件夹及聚焦文件。在SKILL.md中通过“阅读时机...”指南的表格链接每个文件。

基于规则的模式：添加

rules/

文件夹。请参阅下方的规则文件夹部分。

Simple/hub模式：在SKILL.md旁添加分类文件。通过分类表格进行链接。

核心约束：

参考文件必须位于SKILL.md的下一级目录（不能嵌套多层）
超过100行的文件需在顶部添加目录
仅当在SKILL.md中明确列出时，文件才会被加载

Step 5: Validate

步骤5：验证

Load

references/quality-checklist.md

and run all applicable checks.

加载

references/quality-checklist.md

并运行所有适用的检查项。

Step 6: Update README.md

步骤6：更新README.md

Add a row to the Skills table:

markdown

| `<skill-name>` | <phase> | <one-line description> |

Phases used in this repo: Before coding, Project start, Design, Build, Design/dev, Writing/audit, Pre-ship, Pre-merge, Pre-launch, Architecture, Maintenance, Authoring.

在Skills表格中添加一行：

markdown

| `<skill-name>` | <阶段> | <单行描述> |

本仓库使用的阶段：编码前、项目启动、设计、构建、设计/开发、写作/审核、发布前、合并前、上线前、架构、维护、创作。

Step 7: Smoke-test

步骤7：冒烟测试

Install and confirm files appear in the target directory:

bash

cp -R skills/<name> ~/.claude/skills/
ls ~/.claude/skills/<name>/

安装并确认文件出现在目标目录中：

bash

cp -R skills/<name> ~/.claude/skills/
ls ~/.claude/skills/<name>/

Rules Folder Structure

规则文件夹结构

For rules-based skills (audits, lints, checklists), create a

rules/

folder with:

对于基于规则的Skills（审核、检查、检查清单），创建

rules/

文件夹并包含以下内容：

rules/_sections.md

rules/_sections.md

Category map with impact levels. Format:

markdown

undefined

带影响级别的类别映射。格式：

markdown

undefined

Sections

章节

This file defines all sections, their ordering, impact levels, and descriptions. The section ID (in parentheses) is the filename prefix used to group rules.

本文件定义所有章节、排序、影响级别及描述。章节ID（括号内）是用于分组规则的文件名前缀。

1. Category Name (prefix)

1. 类别名称（前缀）

Impact: CRITICAL | HIGH | MEDIUM-HIGH | MEDIUM | LOW-MEDIUM Description: One sentence explaining why this category matters.

undefined

影响级别： CRITICAL | HIGH | MEDIUM-HIGH | MEDIUM | LOW-MEDIUM 描述： 解释该类别重要性的一句话说明。

undefined

rules/_template.md

rules/_template.md

Template for individual rule files:

markdown

---
title: Rule Title Here
impact: MEDIUM
tags: tag1, tag2
---

单个规则文件的模板：

markdown

---
title: 规则标题
impact: MEDIUM
tags: tag1, tag2
---

Rule Title Here

规则标题

Brief explanation of the rule and why it matters.

Incorrect (description of what's wrong):

[code block with bad example]

Correct (description of what's right):

[code block with good example]

undefined

对规则及其重要性的简要说明。

错误示例（说明问题所在）：

[错误示例代码块]

正确示例（说明正确做法）：

[正确示例代码块]

undefined

Individual rule files

单个规则文件

Named
```
<prefix>-<slug>.md
```
where prefix matches the section ID
One rule per file
Each file follows the
```
_template.md
```
structure

命名为
```
<prefix>-<slug>.md
```
，其中前缀需与章节ID匹配
每个文件对应一条规则
每个文件需遵循
```
_template.md
```
的结构

SKILL.md priority table

SKILL.md优先级表格

Include a table mapping categories to prefixes and rule counts:

markdown

| Priority | Category | Impact | Prefix | Rules |
|----------|----------|--------|--------|-------|
| 1 | Category Name | CRITICAL | `prefix-` | N |

添加映射类别与前缀、规则数量的表格：

markdown

| 优先级 | 类别 | 影响级别 | 前缀 | 规则数量 |
|----------|----------|--------|--------|-------|
| 1 | 类别名称 | CRITICAL | `prefix-` | N |

Anti-patterns

反模式

Dumping full specification into SKILL.md body (use reference files)
Creating reference-to-reference chains (keep one level deep)
Including time-sensitive content ("before August 2025, use...")
Restating what Claude already knows (how to write Markdown, general coding advice)
Using "I audit..." or "Use this to..." voice in descriptions (use third-person)
Adding README.md, CHANGELOG.md, or INSTALLATION_GUIDE.md to the skill folder
Dropping files in folders without linking them from SKILL.md

将完整规范直接写入SKILL.md主体（应使用参考文件）
创建参考文件嵌套引用（仅允许一级深度）
包含时效性内容（如“2025年8月前使用...”）
重复Claude已掌握的知识（如如何编写Markdown、通用编码建议）
在描述中使用“我审核...”或“使用此工具...”的语气（应使用第三人称）
在Skill文件夹中添加README.md、CHANGELOG.md或INSTALLATION_GUIDE.md
在文件夹中放置文件但未在SKILL.md中链接

agent-skills-creator

Original

Translation

Agent Skills Creator

Agent Skills 创作指南

Reference Files

参考文件

Choose a Skill Pattern

选择Skill模式

Creation Workflow

创作工作流

Step 1: Choose skill pattern

步骤1：选择Skill模式

Step 2: Create directory and frontmatter

步骤2：创建目录和前置元数据

Step 3: Write SKILL.md body

步骤3：编写SKILL.md主体内容

Step 4: Add reference or rule files

步骤4：添加参考或规则文件

Step 5: Validate

步骤5：验证

Step 6: Update README.md

步骤6：更新README.md

Step 7: Smoke-test

步骤7：冒烟测试

Rules Folder Structure

规则文件夹结构

rules/_sections.md

rules/_sections.md

Sections

章节

1. Category Name (prefix)

1. 类别名称（前缀）

rules/_template.md

rules/_template.md

Rule Title Here

规则标题

Individual rule files

单个规则文件

SKILL.md priority table

SKILL.md优先级表格

Anti-patterns

反模式

Related Skills

相关Skills

`rules/_sections.md`

`rules/_sections.md`

`rules/_template.md`

`rules/_template.md`