一个用于验证和评分代理技能包的CLI工具。

规范合规是表层要求。skill-validator 更进一步：它检查链接是否真的解析，标记不该出现在技能目录中的文件，报告令牌计数，这样你就能看到技能会占用多少代理的上下文窗口，分析内容质量指标，检测跨语言污染，并提供作为评判的大型语言模型评分，以评估技能质量，涵盖清晰度、可操作性和新颖性等维度。一个符合规范的技能如果链接断裂，或者是 60k-token 的参考文件，技术上会通过规范，但实际表现不佳。

目录

• 安装
• CLI
• 自制内容
• 使用 Go
• 预建二进制
• 预提交钩子
• 作为图书馆
• 命令使用
• 验证结构
• 验证链接
• 分析内容
• 污染分析
• 检查
• 评分评估
• 比分报告
• 输出格式
• 紧凑输出
• JSON 输出
• Markdown 输出
• GitHub Actions 注释
• CI集成
• CI 工作流程示例
• 多技能目录
• 示例
• 检查内容及其原因
• 结构验证
• 平面技能布局
• 允许非标准目录

skill-validator

A CLI tool that validates and scores Agent Skill packages.

Spec compliance is table stakes. skill-validator goes further: it checks that links actually resolve, flags files that shouldn’t be in a skill directory, reports token counts so you can see how much of an agent’s context window your skill will consume, analyzes content quality metrics, detects cross-language contamination, and offers LLM-as-judge scoring to evaluate skill quality across dimensions like clarity, actionability, and novelty. A spec-compliant skill that has broken links or a 60k-token reference file will technically pass the spec but perform poorly in practice.

Table of Contents

• Install
  • CLI
    • Homebrew
    • Using Go
    • Pre-built binaries
    • Pre-commit hook
  • As a library
• Command Usage
  • validate structure
  • validate links
  • analyze content
  • analyze contamination
  • check
  • score evaluate
  • score report
• Output Formats
  • Compact output
  • JSON output
  • Markdown output
  • GitHub Actions annotations
• CI Integration
  • CI workflow example
  • Multi-skill directories
• Examples
• What it checks & why
  • Structure validation
    • Flat skill layouts
    • Allowing non-standard directories
    • Allowing nesting at specific paths
    • Excluding paths from non-standard token accounting
  • Link validation
  • Content analysis
  • Contamination analysis
  • LLM scoring
• Stability
• Development

Install

Install CLI

You can install the CLI in four ways:

• Homebrew
• Using Go
• Pre-built binaries
• Pre-commit hook

Homebrew

brew tap agent-ecosystem/tap
brew install skill-validator

Using Go

go install github.com/agent-ecosystem/skill-validator/cmd/skill-validator@latest