Инструмент CLI, который проверяет и оценивает пакеты навыков агента.

Соответствие спецификации - это столовые ставки. skill-validator идет дальше: он проверяет, что ссылки на самом деле разрешаются, помечает файлы, которые не должны быть в каталоге навыков, сообщает количество токенов, чтобы вы могли видеть, сколько контекстного окна агента будет потреблять ваш навык, анализирует показатели качества контента, обнаруживает межъязыковое загрязнение и предлагает оценку качества навыков по всем измерениям, таким как ясность, работоспособность и новизна. Специфический навык, который имеет неработающие ссылки или справочный файл с токеном 60k, технически пройдет спецификацию, но на практике будет работать плохо.

Таблица содержимого

• Установить
• КЛИ
• Домашнее пиво Использование Go
• Предварительно построенные двоичные файлы
• Крючок перед выполнением задания Как библиотека
• Командное использование
• проверяемая структура
• проверять ссылки
• анализировать контент
• анализировать загрязнение проверить
• оценка баллов Отчет о результатах
• Выходные форматы
• Компактный выход
• Выход JSON
• Маркдаун выход
• аннотации к 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