SkillRanker — подбор нужного скилла на следующий шаг
SkillRanker
CLI sr на Rust оценивает контекст живой сессии, сравнивает скиллы и подсказывает агенту один подходящий, а при сомнении молчит
- 141 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Для оценки наружу уходит контекст разговоров с агентом, и скрытие лишних данных работает не безупречно
- Хук работает на каждом запросе и тратит платные попытки провайдера
Установка
- Работает в
Ручная установка
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/skillranker/main/install.sh?$(date +%s)" | bash -s -- --verifyСтавит sr в ~/.local/bin с проверкой SHA256. Из исходников: cargo install --locked --path . --bin sr.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Для оценки наружу уходит контекст разговоров с агентом, и скрытие лишних данных работает не безупречно
- Хук работает на каждом запросе и тратит платные попытки провайдера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SkillRanker (`sr`) — отдельная утилита на Rust, которая отвечает на вопрос, какой скилл из большой библиотеки нужен агенту на следующем шаге. Она берет недавний разговор, текущий запрос, признаки рабочего каталога и список скиллов, видимых выбранной среде агента. Оценку дает провайдер, совместимый с Jev: по умолчанию TypeSafe.ai, а также TypeSafe Jev на Cloudflare. Сначала он сравнивает кандидатов широко, затем читает расширенные выдержки из короткого списка и проверяет, подходит ли каждый. В обоих сравнениях есть явный вариант «ничего не подходит». Для библиотек больше 254 скиллов кандидатов сужает локальный поиск Quill. Явный запрос скилла разрешается локально до любых вызовов. Результат носит совещательный характер: агент решает сам. Для Claude Code `sr install-hook claude` ставит хук `UserPromptSubmit`, который называет не больше одного проверенного скилла и никогда не блокирует работу при сбое. Команды `sr rank`, `sr demo`, `sr capabilities --json` и ключ `--why-not` показывают, почему скилл не попал в рекомендацию.
Для кого. Тем, у кого в Claude Code или Codex накопились десятки скиллов с похожими описаниями и кто теряет время и контекст на выбор подходящего.
Подходит, если
- В библиотеке сотни скиллов, и агент грузит не те, расходуя контекст
- После нескольких ходов предыдущий скилл стал неактуален, и нужна новая подсказка под текущий шаг
- Хочется понять, почему нужный скилл не предложили: ключ `--why-not` показывает порог и подсказку
- Перед подключением к сессии надо посмотреть работу на офлайн-примере командой `sr demo`
- Расходы на оценки нужно ограничить общим лимитом попыток и автоматическим выключателем провайдера
Не подходит, если
- Нужна работа полностью офлайн: свежая оценка требует вашего ключа провайдера и сети
- Нет ключа TypeSafe.ai или аккаунта Cloudflare: без них рекомендации не появятся
- В библиотеке три-четыре скилла: расход на оценку превысит выгоду от подсказки
- Нужна гарантированная автозагрузка скилла: результат лишь совет, и агент выбирает сам
Пример запроса к агенту
Посмотри, какие скиллы подойдут для следующего шага в этой сессии, и объясни ключом --why-not, почему не попал скилл для тестов.Ограничения
Свежее ранжирование требует собственного ключа провайдера (`TYPESAFE_API_KEY` либо учетные данные Cloudflare) и явного согласия на сеть флагом `--allow-network` или настройкой. Локальной модели в программе нет. Оценки считает сторонний сервис, а программа лишь готовит ему данные.
Качество ограничено видимым списком скиллов и поиском Quill, который может пропустить перифразы и многоязычные совпадения. Нативная поддержка среды требует проверенного контракта событий, поэтому надежнее всего работают Claude Code и Codex. Установка поддерживает Linux и macOS, на macOS состояние нужно держать на локальной файловой системе APFS или HFS+.
Как отключить. Уберите хук командой из документации и удалите бинарник `~/.local/bin/sr`. Установщик ставит небольшой скилл использования в найденные Claude Code и Codex, его папку удалите вручную, а при установке с `--no-configure` лишних файлов нет.
Частые вопросы
Как поставить SkillRanker?
Установщик с проверкой SHA256 кладет `sr` в `~/.local/bin`: команда `curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/skillranker/main/install.sh?$(date +%s)" | bash -s -- --verify`. Из исходников: `cargo install --locked --path . --bin sr`.
Что такое Jev?
Это провайдер оценки, который сравнивает кандидатов по смыслу и умеет сказать, что ни один не подходит. SkillRanker дает вокруг него интеграцию с сессией, локальные защитные механизмы и обратную связь. Без ключа провайдера свежее ранжирование недоступно.
Что уходит наружу?
Свежие оценки отправляют провайдеру отредактированный контекст и выдержки скиллов. Сеть включается только вашим решением, одного ключа для этого мало. Флаг `--offline` гарантирует ноль запросов.
Блокирует ли хук работу агента?
Нет. Если рекомендация не удалась, хук выводит пустой ответ, пишет короткую диагностику и завершается с кодом ноль. Он называет не больше одного скилла и молчит при обычном воздержании.
Какие агенты поддерживаются?
Хук реализован для Claude Code через `sr install-hook claude`, и установщик ставит скилл использования также в Codex. Для других сред переносимой границей служит ввод нормализованного контекста.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин и скилл подбирают под задачу три проверенных скилла из офлайн-реестра, с оценкой безопасности и объяснением выбора.
Скилл-врач для скиллов: выбирает архитектуру, проверяет по чек-листу с 21 красной линией и выдает отчет со ссылками на строки
Rust-утилита со своим окном: сканирует скиллы Codex, Claude Code и Gemini CLI, ищет опасные строки и включает или отключает их
Скилл для создания, проверки и улучшения других скиллов: сначала архитектура, потом тесты, оценка и упаковка
Утилита clawskills ищет по индексу из 125 тысяч скиллов и ставит найденные в папки Claude Code, Cursor, Codex и OpenClaw.
Скилл ищет другие скиллы под вашу задачу через сервис DeepSkill Market и ранжирует их с учетом отзывов тех, кто уже запускал
Коротко о README
В README разобрана проблема выбора среди похожих скиллов и устройство ранжирования в два этапа с локальным поиском Quill. Разделы посвящены командам, настройке, объяснению и воспроизведению результата, локальной обратной связи, оценке с бюджетом, хукам, встроенному TUI, приватности и ограничениям. Лицензия приведена в конце файла.