shenysun/skills-manager

shenysun

CLI-инструмент для управления навыками AI-агентов: установка, распространение и обновление навыков для 70+ агентов из одного хаба.

Skills Manager — это CLI-инструмент и навык-менеджер, который позволяет устанавливать, импортировать, распространять и обновлять навыки для AI-агентов прямо из разговора с агентом. Подходит разработчикам, использующим несколько агентов (Claude Code, Codex, Cursor и др.) и желающим централизованно управлять библиотекой навыков.

Ключевые возможности

  • Единый хаб ~/.skills-manager для распространения подмножества навыков любому из 70+ агентов через симлинки или копирование.
  • Поддержка пяти типов источников: git-репозитории и URL, прямые ссылки на скачивание (SKILL.md / zip / tar), локальные zip-архивы, маркетплейсы плагинов Claude и индексы обнаружения.
  • Обновления на основе SHA git-дерева подкаталога навыка, что исключает ложные срабатывания при коммитах вне навыка.
  • Учёт резидентной стоимости: анализ frontmatter каждого распространённого навыка и отчёт о затратах на токены с предложениями по сокращению.
  • Восстановление происхождения (provenance) импортированных навыков через анализ lockfile, поиск агентом и подтверждение пользователем.
  • Управление через диалог с агентом: установка, импорт, распространение, обновление и восстановление происхождения выполняются по запросу в чате.

Для каких задач подходит

  • Централизованное управление библиотекой навыков для нескольких AI-агентов (Claude Code, Codex, Cursor и др.) без дублирования.
  • Быстрая установка навыков из различных источников (git, zip, маркетплейсы) с автоматическим отслеживанием обновлений.
  • Контроль затрат на токены за счёт учёта резидентной стоимости навыков и получения рекомендаций по их сокращению.
  • Восстановление информации об источнике для навыков, импортированных без указания происхождения.
  • Автоматизация рутинных операций с навыками через разговор с агентом вместо ручного редактирования файлов.

Подробнее

Skills Manager построен вокруг идеи «один хаб — все агенты». Все навыки хранятся в единой библиотеке ~/.skills-manager, откуда их можно распространять в любого из 70+ поддерживаемых агентов. Распространение может выполняться как через символические ссылки, так и через копирование, с обнаружением устаревших копий и возможностью отката. Инструмент поддерживает пять типов источников: git-репозитории и URL, прямые ссылки на скачивание (SKILL.md, zip, tar), локальные zip-архивы, маркетплейсы плагинов Claude и индексы обнаружения. Обновления отслеживаются по SHA git-дерева подкаталога навыка, поэтому коммиты, не затрагивающие навык, не вызывают ложных обновлений. Отдельное внимание уделено учёту резидентной стоимости: каждый распространённый навык занимает место в контексте сообщения, и команда skills-manager cost показывает приблизительные затраты по каждому пути выполнения с рекомендациями по сокращению. Для импортированных навыков без источника предусмотрено восстановление происхождения через анализ lockfile, поиск агентом и подтверждение пользователем. Управление происходит преимущественно через диалог с агентом: достаточно попросить установить, импортировать или обновить навык, и менеджер выполнит операцию. Под капотом CLI представляет собой простой JSON-движок, что упрощает интеграцию и отладку. Инструмент распространяется под лицензией MIT и требует Node.js.

Частые вопросы

Как установить skills-manager?

Основная команда установки из README:

npx skills-manager-cli

Какие задачи решает skills-manager?

Skills Manager решает задачи централизованного управления навыками AI-агентов: установку из разных источников, распространение по множеству агентов, отслеживание обновлений и контроль затрат на токены. Он также помогает восстановить происхождение импортированных навыков и автоматизировать эти операции через диалог с агентом.

Какие агенты поддерживаются?

Инструмент работает с любыми агентами, загружающими навыки, и имеет каталог из 70+ агентов, включая Claude Code, Codex, Cursor и другие.

Как настроить распространение навыков на нескольких агентов?

По умолчанию используется единый хаб ~/.skills-manager. Для каждого агента можно указать способ распространения (симлинк или копирование) и выбрать подмножество навыков.

Можно ли использовать инструмент коммерчески?

Да, проект распространяется под лицензией MIT, которая разрешает коммерческое использование, изменение и распространение при сохранении уведомления об авторских правах.