Навичка Aggrega
Навичка Aggrega навчає AI-асистента встановлювати й використовувати Aggrega. Це тека з назвою aggrega, що містить файл SKILL.md у відкритому форматі Agent Skills, який багато асистентів читають із власної теки навичок і завантажують, коли ваш запит стосується Aggrega.
Є два способи надати навичку асистентові. Асистент, який встановлює плагіни, отримує її як частину плагіна Aggrega, що також підключає асистента до MCP-сервера Aggrega, за один крок: див. Встановлення плагіна. Для будь-якого асистента, який читає навички з теки, навичку туди може записати двійковий файл aggrega: див. Встановлення лише навички.
Встановлення плагіна
Репозиторій aggrega-ai/aggrega-skills містить навичку і водночас є плагіном для наведених нижче асистентів. Встановлення плагіна додає навичку Aggrega і підключає асистента до MCP-сервера Aggrega, який асистент потім сам запускає як aggrega mcp, тож для цього асистента не потрібні ні aggrega skills install, ні кроки з розділу Підключення сервера MCP.
Плагін не встановлює двійковий файл aggrega. Спершу встановіть його, як описано в розділі Встановлення двійкового файлу, щоб асистент знайшов aggrega у PATH, коли запускатиме сервер.
Claude Code
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsУ самому Claude Code те саме робить команда /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.
Codex
codex plugin marketplace add aggrega-ai/aggrega-skillscodex plugin add aggrega@aggregaПерша команда додає репозиторій як маркетплейс плагінів з назвою aggrega; друга встановлює з нього плагін aggrega.
GitHub Copilot
У GitHub Copilot CLI:
copilot plugin marketplace add aggrega-ai/aggrega-skillscopilot plugin install aggrega@aggregaVisual Studio Code з GitHub Copilot знаходить плагіни, встановлені GitHub Copilot CLI, і теж їх використовує. Щоб встановити плагін безпосередньо з Visual Studio Code, виконайте Chat: Install Plugin from Source з палітри команд і вкажіть адресу репозиторію, https://github.com/aggrega-ai/aggrega-skills.
Gemini CLI
gemini extensions install https://github.com/aggrega-ai/aggrega-skillsGemini CLI встановлює плагін як одне зі своїх розширень.
Antigravity
agy plugin install https://github.com/aggrega-ai/aggrega-skillsCursor
Cursor завантажує плагін із теки всередині ~/.cursor/plugins/local/. Помістіть туди репозиторій, а потім виконайте Developer: Reload Window з палітри команд:
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggregaKiro
Kiro встановлює плагін як power. На панелі Powers виберіть Add Custom Power, потім Import power from GitHub, введіть адресу репозиторію, https://github.com/aggrega-ai/aggrega-skills, і виберіть Install. Kiro запускає й зупиняє MCP-сервер плагіна разом із power.
OpenClaw
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skillsOpenClaw двічі запитує, перш ніж встановити плагін із джерела, яке він сам не перевірив. Спершу він зупиняється й просить вас переглянути джерело та знову виконати команду з --force; потім він просить вашої згоди на те, що приносить плагін, — тут навичку й MCP-сервер, — за допомогою --accept-capabilities. Переглянувши репозиторій, виконайте:
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities--force також замінює вже встановлений плагін з такою самою назвою, тож спершу перевірте openclaw plugins list, якщо раніше ви встановлювали плагін з назвою aggrega.
Тека, у якій працює сервер
Інструменти Aggrega працюють у робочому просторі, і на виклик, що не вказує жодного, відповідь надається в робочому просторі, який сервер знаходить, виходячи з теки, у якій його запущено. Деякі асистенти запускають сервер плагіна у власній теці плагіна, а не у вашому проєкті, — так робить Codex. Навичка велить асистентові, перш ніж працювати в проєкті, перевірити за допомогою інструмента config-show, у якому робочому просторі відповідає сервер, і там, де вони відрізняються, вказувати теку проєкту як workspace_root у кожному виклику, що його приймає, — повним шляхом, оскільки відносний workspace_root читається відносно робочого простору, у якому сервер уже відповідає.
Встановлення лише навички
Щоб встановити навичку без плагіна, скористайтеся двійковим файлом aggrega, який записує вбудовану в нього копію. Установіть її для асистентів на вашому комп’ютері в усіх ваших проєктах:
aggrega skills install --globalУстановіть її для одного асистента в проєкті, у якому ви перебуваєте, назвавши асистента:
aggrega skills install --agent claude-codeПерелічіть асистентів, для яких її можна встановити, разом із текою, яку читає кожен із них:
aggrega skills listКоманда встановлення теж може додати її під час встановлення двійкового файлу: відповідний параметр наведено в розділі Додавання навички асистента під час встановлення. Встановлена в такий спосіб навичка не містить підключення до сервера: підключіть асистента до сервера, як описано в розділі Підключення сервера MCP.
Що навичка повідомляє вашому асистентові
Навичка пояснює асистентові, як установити Aggrega, як під’єднати його до сервера aggrega mcp, як почати робочий простір і як виконувати цикл створення — scaffold, validate, build, — описаний у розділі Створення файлів Aggrega. Вона не містить копії жодної схеми чи контракту сутності: по кожну структурну відповідь вона відсилає асистента до двійкового файлу — до інструментів MCP, коли сервер під’єднано, а інакше до командного рядка aggrega, — а щодо значення речей — до опублікованої документації.
Навичка і MCP-сервер виконують різні завдання, і асистент працює найкраще з обома. Навичка — це інструкції, які читає асистент; сервер, який під’єднує плагін або який під’єднують за розділом Під’єднання MCP-сервера, — це інструменти, які він викликає. Асистент, який не встановлює жодного плагіна і якого немає в списку --agent, пропускає навичку й однаково отримує доступ до тих самих інструментів і довідкових матеріалів через сервер.
Куди її встановлено
Плагін зберігає навичку в теці, у якій асистент зберігає свої плагіни. aggrega skills install записує її деінде: без --global — до проєктної теки навичок асистента в корені вашого робочого простору, де фіксуються навички проєкту; з --global — до користувацької теки навичок асистента у вашому домашньому каталозі, яку асистент читає в кожному проєкті. З --global і без --agent команда шукає асистентів на вашому комп’ютері, виводить кожного знайденого та те, за чим його знайдено, а в терміналі запитує перед записом. aggrega skills наводить теки для кожного асистента, те, за чим знаходять кожного з них, і те, що команда відмовляється перезаписувати.
Підтримання навички в актуальному стані
Навичка, що надійшла з плагіном, оновлюється разом із плагіном у той спосіб, у який асистент оновлює свої плагіни; плагін, клонований до локальної теки Cursor, оновлюється командою git pull у цій теці, після чого виконується Developer: Reload Window. Плагін підключає сервер, який запускає двійковий файл aggrega з вашого PATH, тож інструменти й довідкові матеріали відповідають встановленому у вас двійковому файлу.
Навичку також вбудовано в двійковий файл aggrega, тому копія, яку записує aggrega skills install, відповідає встановленій у вас версії. Після оновлення Aggrega — команда інсталятора оновлює двійковий файл на місці — знову виконайте ту саму команду aggrega skills install, щоб оновити цю копію до нової версії.