V

validate-skills

by @callstackincubatorv
4.5(20)

根据`agentskills.io`规范和Claude Code最佳实践,验证所有技能的合规性。

skill-validationcompetency-assessmenthr-analyticstalent-managementGitHub
安装方式
npx skills add https://github.com/callstackincubator/agent-skills --skill validate-skills
compare_arrows

Before / After 效果对比

1 组
使用前

人工逐一检查技能目录,验证其是否符合 `agentskills.io` 规范和 Claude Code 最佳实践,过程耗时且容易遗漏细节。

使用后

使用 `validate-skills` 技能,可以自动化验证所有技能的命名格式、描述、标签等是否符合规范,确保技能库的质量和一致性,显著提高验证效率和准确性。

SKILL.md

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)

CheckRule
name format1-64 chars, lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens
name matches directoryDirectory name must equal name field
description length1-1024 characters, non-empty
Optional fields validlicense, metadata, compatibility if present

Best Practices (Claude Code)

CheckRule
Description formatThird person, describes what + when to use
Body lengthUnder 500 lines
Loading is one-level deepSKILL.md is the only progressive-disclosure entry point: every reference file must be reachable from SKILL.md. References may cross-link each other for navigation (see note below).
Links are markdownUse [text](path) not bare filenames
No redundancyDon't repeat description in body
ConciseOnly add context Claude doesn't already have

One-level-deep vs. cross-linking. The one-level-deep rule targets progressive-disclosure loading chains — a reference that can only be discovered by loading another reference first (SKILL.md → a.md → b.md, where b.md is not linked from SKILL.md). That is a defect: it hides content from the loader.

It does not forbid navigational cross-links. Per AGENTS.md, reference files end with a "Related Skills" footer linking sibling references, and this is required. A cross-link is fine as long as both endpoints are also reachable directly from SKILL.md. Only flag a reference that is reachable exclusively through another reference.

How to Run

  1. Find all skill directories:

    fd -t d -d 1 . skills/
    
  2. For each skill, read SKILL.md and check against the rules above

  3. 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

用户评价 (0)

发表评价

效果
易用性
文档
兼容性

暂无评价

统计数据

安装量7.9K
评分4.5 / 5.0
版本
更新日期2026年11月19日
对比案例1 组

用户评分

4.5(20)
5
30%
4
55%
3
15%
2
0%
1
0%

为此 Skill 评分

0.0

兼容平台

🔧Claude Code
🔧OpenClaw
🔧OpenCode
🔧Codex
🔧Gemini CLI
🔧GitHub Copilot
🔧Amp
🔧Kimi CLI

时间线

创建2026年3月17日
最后更新2026年11月19日
🎁 Agent 知识卡片
调研问卷