skillsbd

Управление навыкамиRU

Консоль этого каталога: найти навык или MCP-сервер, поставить его агенту одной командой, проверить свой плагин перед публикацией и отправить его в каталог. Ставит не копию, а связь — навык лежит в одном месте, а агенты видят его каждый у себя.

vakovalskii

автор

JavaScript

язык

MIT

лицензия

Установка

# ставить не нужно, запускается напрямую

npx skillsbd --help

# навык в проект — уедет вместе с репозиторием

npx skillsbd add owner/repo

# навык в домашнюю папку — виден агенту в любом проекте

npx skillsbd add owner/repo --global

Нужен Node.js 18 или новее. Установка навыка, поиск, список и удаление работают без регистрации — ключ спрашивается только при отправке своего плагина в каталог и при проверке его статуса.

Куда попадает навык

Два режима на выбор. По умолчанию — папка проекта: навык коммитится вместе с кодом, и коллега получает его, просто склонировав репозиторий. С флагом глобальной установки — домашняя папка: навык виден агенту в любом проекте, ставить заново в каждой папке не нужно.

Канон один — папка `.agents/skills`, общая конвенция, которую агенты читают напрямую. Тем, у кого путь свой (Claude Code, Windsurf), консоль кладёт туда символическую ссылку на тот же навык. Так копия остаётся одна: обновили — обновилось у всех агентов сразу.

Сейчас в реестре восемь адресатов: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Windsurf и общий путь для Amp, Replit и прочих, кто следует конвенции. Установленным считается тот, у кого есть домашняя папка, — консоль не раскладывает навыки по агентам, которых у вас нет.

Чужое не затирается

В папку навыка кладётся метка происхождения. Если место уже занято навыком, поставленным не отсюда, консоль остановится и не перезапишет его молча — разойтись можно принудительным флагом или установкой под другим именем.

Прежняя проектная папка `.skills` не читалась ни одним агентом: навыки в ней лежали, но агент их не видел. Их содержимое переносится в канон при первом же обращении к проекту, причём занятые имена не затираются.

Своё в каталог

Перед отправкой плагин прогоняется проверкой формата — тем же валидатором, что стоит на сайте, так что расхождения «локально прошло, на сайте отклонили» не будет. Проверка клонирует любой git-хостинг, не только GitHub, и возвращает ненулевой код при блокирующих ошибках — её можно поставить в чужой CI.

Одобренная запись открывает pull request в публичный каталог, где ссылка ведёт на репозиторий автора: код никуда не копируется и остаётся у вас.

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

Нужен ли аккаунт, чтобы поставить навык?

Нет. Установка, поиск, список и удаление работают анонимно — это закреплено тестом, который гоняет команды с пустым окружением. Ключ спрашивается только при отправке своего плагина в каталог и при проверке его статуса.

Ставить в проект или глобально?

В проект — если навык нужен команде и должен уехать вместе с репозиторием. Глобально — если он нужен лично вам во всех проектах. Режим переключается флагом, его понимают установка, список и удаление.

Что будет с навыком, который я уже положил руками в ту же папку?

Он не пострадает. В папке навыка лежит метка происхождения, и чужой навык консоль молча не перезаписывает — она остановится и предложит поставить принудительно или под другим именем.

Мой код попадёт в каталог?

Нет. В публичном каталоге лежит запись со ссылкой на ваш репозиторий, сам код не копируется и остаётся под вашим контролем.