Korra
Меню
Программа (CLI)Открытый код · MIT

skill-validator

Проверить скилл перед использованием

Проверяет структуру скилла, ссылки и содержимое. Помогает найти ошибки и оценить объём инструкций.

  • На вашем компьютере
  • Ключ по желанию
  • Только читает
  • Бесплатно
  • Данные: локально; оценка — Anthropic или OpenAI

Используют с Claude Code — по открытым источникам. Сверено с документацией 29.09.2026.

Пример задачи
Папка скилла
Отчёт об ошибках

Что можно поручить агенту

  • Найти повреждённые ссылки в скилле.

  • Проверить структуру перед публикацией.

  • Увидеть слишком большие файлы инструкций.

Подключить

Проще всего — отправить агенту ссылку: он прочитает инструкцию, установит, подключит и проверит сам.

Сообщение агенту
Подключи инструмент «skill-validator» по инструкции: https://korra-agent.online/library/skill-validator/agent.txt

Попросите агента

Задание для агента

Подойдёт любой агент с доступом к терминалу: он проверит систему, установит программу и проверит работу.

Что выполнит агент

Агент выполнит их сам — вручную только если хотите. Метка показывает, откуда сведения: инструкция автора или документация агента.

Claude Code

По инструкции автора

Используют: PR: инженер Square запускал skill-validator через Claude Code на 100+ скиллах источник

pre-commit hook id: skill-validator-claude (проверяет .claude/skills/)

Источник

Codex

По инструкции автора

Способ из инструкции автора — ссылка ниже.

Команда
pre-commit hook id: skill-validator-codex

Источник

Cursor

По инструкции автора

Способ из инструкции автора — ссылка ниже.

Команда
pre-commit hook id: skill-validator-cursor

Источник

Hermes

Любой агент с терминалом

Обычная программа: агент с доступом к терминалу установит её по заданию ниже.

OpenClaw

Любой агент с терминалом

Обычная программа: агент с доступом к терминалу установит её по заданию ниже.

Korra

Любой агент с терминалом

Обычная программа: агент с доступом к терминалу установит её по заданию ниже.

Что можно сделать

3 готовых сценариев. Каждый промпт можно отправить агенту после подключения.

Скилл перед публикацией

Список ошибок и предупреждений по структуре, описанию, ссылкам и объёму — с указанием файлов.

  • Команда check запускает все проверки, кроме оценки моделью.
  • Код выхода 0 — чисто, 1 — есть ошибки, 2 — только предупреждения.
Промпт для агента
Промпт
Проверь мой скилл через skill-validator перед публикацией.
1. Попроси путь к папке скилла.
2. Запусти skill-validator check и разбери вывод.
3. Составь список: сначала ошибки, потом предупреждения. Для каждого — файл, что не так и как исправить.
4. Исправляй только после моего согласия, затем запусти проверку снова.
Готово, когда check завершается с кодом 0 или оставшиеся предупреждения я принял осознанно.

Совет. Чистая проверка значит, что скилл собран правильно, но не что он полезен или безопасен.

Чужой скилл перед установкой

Короткий отчёт о чужом скилле: лишние файлы, битые ссылки, объём и что делают его скрипты.

  • validate structure находит файлы, которым не место в скилле, и считает токены.
Промпт для агента
Промпт
Хочу установить чужой скилл — проверь его до установки.
1. Попроси ссылку на репозиторий или папку. Скачай во временную папку, никуда не устанавливай и ничего не запускай.
2. Запусти skill-validator check и посчитай токены по файлам.
3. Прочитай все скрипты и перечисли, что они делают: сеть, файлы, ключи, установка программ.
4. Сохрани отчёт в review.md рядом со скиллом.
Готово, когда в отчёте есть вывод: ставить, ставить с оговорками или не ставить — и почему.

Совет. skill-validator проверяет устройство скилла, а не намерения автора. Чтение скриптов — отдельная и обязательная часть проверки.

Скилл стал слишком тяжёлым

План сокращения: какие файлы съедают контекст агента и что можно вынести или убрать.

  • Отчёт показывает токены по каждому файлу.
  • analyze content оценивает, насколько конкретны инструкции.
Промпт для агента
Промпт
Мой скилл разросся, помоги его сократить.
1. Попроси путь к скиллу.
2. Запусти skill-validator validate structure и analyze content --per-file, покажи токены по файлам.
3. Предложи, что сократить, что вынести в references и что удалить. Для каждого пункта — сколько токенов сэкономим.
4. Правь только после моего согласия, затем проверь снова.
Готово, когда SKILL.md стал короче, а проверка проходит без ошибок.

Совет. Метрики текста, судя по README, считаются по английским словам (use, run, must). Для скилла на русском ориентируйтесь на токены и структуру.

Если настраиваете вручную

Установите CLI одним из способов README, затем укажите путь к скиллу. Базовый check не запускает оценку моделью.

skill-validator check ./my-skill

Замените ./my-skill на папку вашего скилла. Команда проверяет содержимое и ссылки, не редактируя инструкции.

Открыть инструкцию проекта

Что учесть

Успешная проверка структуры не гарантирует безопасность или полезность скилла в реальной задаче.