validate-skills：AI技能验证工具 - 遵循agentskills.io规范与Claude Code最佳实践

validate-skills by callstackincubator/agent-skills

1,100 周安装量

1,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills

AI/机器学习开发开发运维

🇨🇳中文介绍

验证技能

根据 agentskills.io 规范与 Claude Code 最佳实践，验证 skills/ 目录下的所有技能。

验证清单

针对每个技能目录，请验证：

规范符合性 (agentskills.io)

检查项	规则
`name` 格式	1-64 个字符，仅包含小写字母、数字和连字符，不允许开头、结尾或连续的连字符
`name` 与目录匹配	目录名称必须等于 `name` 字段
`description` 长度	1-1024 个字符，非空
可选字段有效	如果存在、、字段，则需有效

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

检查项	规则
描述格式	使用第三人称，描述技能是什么以及何时使用
正文长度	少于 500 行
引用深度为一层	无嵌套引用链
链接使用 Markdown 格式	使用 `[文本](路径)` 而非纯文件名
避免冗余	不要在正文中重复描述
简洁明了	仅添加 Claude 尚未掌握的上下文

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

按以下格式报告问题：

## 验证结果

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

🇺🇸English

Validate Skills

Validate all skills in skills/ against the agentskills.io spec and Claude Code best practices.

Validation Checklist

For each skill directory, verify:

Spec Compliance (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

Best Practices (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

How to Run

Find all skill directories:
```
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)

References

Weekly Installs

781

Repository

callstackincuba…t-skills

GitHub Stars

997

First Seen

Jan 29, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

claude-code559

gemini-cli529

opencode528

codex527

cursor496

github-copilot486