Навык 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, чтобы обновить эту копию до новой версии.