validate-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Validate Skills

验证Skill

Validate all skills in

skills/

against the agentskills.io spec and Claude Code best practices.

验证

skills/

目录下的所有Skill是否符合agentskills.io规范和Claude Code最佳实践。

Validation Checklist

验证检查清单

For each skill directory, verify:

针对每个Skill目录，需验证以下内容：

Spec Compliance (agentskills.io)

规范合规性（agentskills.io）

Check	Rule
`name` format	1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens
`name` matches directory	Directory name must equal `name` field
`description` length	1-1024 characters, non-empty
Optional fields valid	`license` , `metadata` , `compatibility` if present

检查项	规则
`name` 格式	1-64个字符，仅包含小写字母、数字和连字符，无开头、结尾或连续的连字符
`name` 与目录匹配	目录名称必须与 `name` 字段一致
`description` 长度	1-1024个字符，不能为空
可选字段有效性	若存在 `license` 、 `metadata` 、 `compatibility` 字段，需确保其合法

Best Practices (Claude Code)

最佳实践（Claude Code）

Check	Rule
Description format	Third person, describes what + when to use
Body length	Under 500 lines
References one-level deep	No nested reference chains
Links are markdown	Use `[text](path)` not bare filenames
No redundancy	Don't repeat description in body
Concise	Only add context Claude doesn't already have

检查项	规则
描述格式	使用第三人称，说明功能及适用场景
正文长度	少于500行
引用层级	仅允许一级引用，无嵌套引用链
链接格式	使用 `[文本](路径)` 格式，而非裸文件名
无冗余内容	正文中不要重复描述字段的内容
简洁性	仅添加Claude尚不具备的上下文信息

How to Run

运行方式

Find all skill directories:
bash
```
fd -t d -d 1 . skills/
```
For each skill, read
```
SKILL.md
```
and check against the rules above

Report issues in this format:

## Validation Results

### skills/example-skill
- [PASS] name format valid
- [FAIL] name "example" doesn't match directory "example-skill"
- [PASS] description length OK (156 chars)

查找所有Skill目录：
bash
```
fd -t d -d 1 . skills/
```
针对每个Skill，读取
```
SKILL.md
```
并对照上述规则进行检查

以下列格式报告问题：

## 验证结果

### skills/example-skill
- [通过] name格式有效
- [失败] name“example”与目录“example-skill”不匹配
- [通过] description长度符合要求（156字符）