Встановлювати й керувати навичками
У цьому посібнику показано, як наповнити робочий простір навичками з 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 (репозиторій-джерело, шлях, коміт, з якого він походить, і
хеш вмісту), і навичка стає доступною агентам у робочому просторі. Картка з
позначкою Назва зайнята означає, що цю назву локально вже займає інша
навичка — спершу видаліть ту.
Оновлювати навички з часом
Розділ із назвою «Оновлювати навички з часом»Картки встановлених навичок мають позначки: Установлено або Є оновлення, коли репозиторій пішов далі за коміт, який ви зафіксували. Відкрийте детальний перегляд і натисніть Оновити, щоб повторно завантажити на новому коміті. Оновлення проходить той самий шлюз сканування, що й установлення — навичку, нова версія якої потрапляє на карантин, відхиляють, а версія, яка у вас була, лишається на місці. Хеш старої версії зберігають у файлі фіксації як посилання для відкату.
Видалити навичку, вилучити репозиторій
Розділ із назвою «Видалити навичку, вилучити репозиторій»Видалити (у детальному перегляді встановленої навички або через видалення на вкладці «Встановлені») прибирає каталог навички та її фіксацію разом — видалена навичка не лишає по собі нічого.
Вилучення репозиторію з бічної панелі прибирає лише каталог: навички, установлені з нього, лишаються встановленими й далі оновлюються, бо фіксація записує репозиторій за назвою, а не посиланням на запис джерела. Додайте репозиторій назад, якщо хочете знову його переглядати.
Викликати навичку
Розділ із назвою «Викликати навичку»Навички викликають у власному просторі назв, тож вони ніколи не зіштовхуються з
вбудованими 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> дістає будь-який репозиторій
у просторі.
Навички репозиторію проходять те саме сканування з відмовою за замовчуванням
(pass / warn / quarantine), перш ніж їхній frontmatter потрапить у промпт.
warn допускають; quarantine затримують, і на цьому шляху оператор не може це
перевизначити.
Дивіться Навички в межах репозиторію і Slash-команди.