Устанавливать и управлять навыками

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

Важно понять ещё до начала: репозиторий-источник не является доверенным. Его имя, описание и число звёзд пишет его владелец. Единственный сигнал безопасности, которому доверяет Control Center, — вердикт антивирусной проверки, через который проходит каждая установка, прежде чем что-либо попадёт на диск или в промпт агента. Если хотите понять логику, прочитайте раздел о навыках в модели агента; эта страница посвящена практическим действиям.

Навыки находятся в разделе Настройки → Рабочее пространство → Навыки (/workspaces/<id>/settings/workspace/skills). Они привязаны к рабочему пространству: установленные здесь навыки принадлежат только этому рабочему пространству. На странице две вкладки: Установленные (локальные навыки, включая редактор Новый навык) и Источники (каталоги GitHub). Обе операции записи проходят один и тот же шлюз проверки.

Добавить репозиторий навыков

Откройте Настройки → Рабочее пространство → Навыки и переключитесь на вкладку Источники.
Нажмите Добавить репозиторий.
Вставьте URL репозитория GitHub, например https://github.com/anthropics/skills, и подтвердите.

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

Навыки репозитория — это каталоги, содержащие SKILL.md (глубиной до трёх уровней, плюс раскладка маркетплейса плагинов Claude plugins/<plugin>/skills/<skill>, при этом деревья зависимостей и вендоров пропускаются). Если позже сетка сообщит, что в репозитории нет навыков, это значит ровно одно: ни один каталог в нём не соответствует соглашению о навыках.

Проверить навык перед установкой

Выберите репозиторий в панели — его навыки появятся сеткой справа, а над ней будет поле фильтра, сужающее каталог по имени, описанию или slug. Щёлкните карточку, чтобы открыть подробный просмотр. Он показывает три вещи:

README, отрендеренный как markdown, — README.md каталога навыка или тело SKILL.md, если README нет.
Предпросмотр проверки — вердикт (pass, warn или quarantine), возможности, которые объявляет содержимое навыка (запускает shell, пишет файлы, сетевой доступ…), и каждую находку, зафиксированную сканером.
Число файлов — установка записывает весь каталог навыка, а не только его SKILL.md.

Предпросмотр сканирует ровно те байты, которые запишет установка, поэтому вердикт, который вы видите, и есть вердикт, который получит установка; ничего не переоценивается за вашей спиной.

Установить навык

Откройте подробный просмотр навыка.
Прочитайте вердикт проверки. При вердикте warn или pass нажмите Установить.
При вердикте quarantine установка остаётся недоступной, пока вы не отметите Я понимаю риск — установить всё равно. Такое переопределение записывается, а не подразумевается.

Установка записывает каталог навыка в рабочее пространство, фиксирует закрепление в skills-lock.json (репозиторий-источник, путь, коммит, из которого он взят, и хэш содержимого), после чего навык становится доступен агентам в рабочем пространстве. Карточка с пометкой Имя занято означает, что это имя локально уже принадлежит другому навыку, — сначала удалите его.

Обновлять навыки со временем

На карточках установленных навыков есть значки: Установлен или Доступно обновление, когда репозиторий ушёл вперёд от закреплённого вами коммита. Откройте подробный просмотр и нажмите Обновить, чтобы загрузить навык заново на новом коммите. Обновление проходит через тот же шлюз проверки, что и установка — навык, новая версия которого получает карантин, отклоняется, а прежняя версия остаётся на месте. Хэш старой версии сохраняется в lock-файле как точка отката.

Удалить навык и убрать репозиторий

Удалить (в подробном просмотре установленного навыка или удаление на вкладке «Установленные») убирает каталог навыка и его закрепление в lock-файле вместе — после удаления от навыка ничего не остаётся.

Удаление репозитория из панели убирает только каталог: установленные из него навыки остаются установленными и по-прежнему обновляются, потому что закрепление хранит репозиторий по имени, а не по ссылке на запись источника. Добавьте репозиторий обратно, если хотите снова его просматривать.

Вызвать навык

Навыки вызываются в собственном пространстве имён, поэтому они никогда не конфликтуют со встроенными slash-командами (/plan, /goal, /loop, /compact):

/skill:<name> — навык, установленный в этом рабочем пространстве, или привязанный к агенту
/skill:<repo>:<name> — навык, поставляемый репозиторием, склонированным в это пространство

Имя без префикса, не совпадающее со встроенной командой, по-прежнему разрешается — для сообщений, написанных до появления пространства имён. /skill:plan — это то, что доходит до навыка с именем plan; /plan — всегда встроенная команда.

Навыки в рамках репозитория

Склонированный репозиторий может поставлять собственные навыки в .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ или skills/. Они не устанавливаются через эту страницу. Агент несёт только навыки того репозитория, в котором он сейчас работает; при переходе они меняются. Поле ввода так не ограничено: /skill:<repo>:<name> доходит до любого репозитория в пространстве.

Навыки репозитория проходят ту же проверку по принципу fail-closed (pass / warn / quarantine), прежде чем их frontmatter попадёт в промпт. warn допускается; quarantine отклоняется, и обойти это на данном пути оператор не может.

См. Навыки в рамках репозитория и Slash-команды.

Связанные руководства

Связанные понятия

Модель агента