Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

aggrega skills

Встановити навичку Aggrega в AI-асистента

Синтаксис

aggrega skills

Опис

Install the skill that teaches an AI assistant to install and use Aggrega.
A skill is a folder holding a SKILL.md file in the open Agent Skills format,
which many assistants read from a skill folder of their own. The Aggrega skill
tells an assistant how to install Aggrega, how to connect it to the aggrega MCP
server, how to start a workspace, and how to run the authoring loop — scaffold,
validate, build. It carries no copy of any schema: it sends the assistant to
this binary for every structural question and to the published documentation
for every conceptual one.
The skill is built into this binary, so the copy it installs matches the
version you have.

Підкоманди

КомандаОпис
aggrega skills installЗаписати навичку Aggrega в теку навичок ШІ-асистента
aggrega skills listПерелічити навички, що постачаються з цим виконуваним файлом, і асистентів, для яких їх можна інсталювати

Опис aggrega skills install

Write the Aggrega skill into the skill folder of each assistant named with
--agent, so the assistant knows how to install and use Aggrega.
By default the skill goes into the assistant's project skill folder at the root
of your workspace — the one found from the directory you run the command in, or
named with --workspace-root; a directory no workspace marks is its own root —
which is where a project's own skills are committed. With --global it goes
into the assistant's per-user skill folder in your home directory instead,
where the assistant reads it in every project.
Every folder and file a project installation writes is held to the workspace:
a skill folder reached through a link leading out of it is refused, and
nothing is written.
--agent may be given more than once. Where several of the named assistants read
the same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants found
on this machine: each one whose configuration folder is in your home directory
or whose command is on your PATH, as the table below names them. The command
prints each assistant it found and what found it. At a terminal it then asks
before writing: press Enter to install for those, or type the identifiers of
other assistants to add them. Where standard input is not a terminal it
installs for the assistants found without asking. Where it finds none and is
given none, it writes nothing and says so. A project installation is for the
assistants a project's people use rather than those on one machine, so it
always names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every file
written carries a comment line saying where it comes from. Running the command
again replaces a copy carrying that line, which is how a newer aggrega brings
the skill up to its own version. A file at the target that does not carry it
was not written by this command, so the command refuses, names the file and
writes nothing; move it aside or remove it, then run the command again. Every
target is checked before anything is written, so a refusal leaves every folder
as it was.
The assistants it installs for, the folders each one reads, and what finds each
on this machine — its configuration folder in your home directory, or its
command on your PATH:
--agent assistant project folder per-user folder found by
amp Amp .agents/skills ~/.config/amp/skills ~/.config/amp, amp
antigravity Antigravity .agents/skills ~/.gemini/config/skills ~/.gemini/antigravity, antigravity
antigravity-cli Antigravity CLI .agents/skills ~/.gemini/antigravity-cli/skills ~/.gemini/antigravity-cli
claude-code Claude Code .claude/skills ~/.claude/skills ~/.claude, claude
cline Cline .cline/skills ~/.cline/skills ~/.cline, cline
codex Codex .agents/skills ~/.agents/skills ~/.codex, codex
cursor Cursor .cursor/skills ~/.cursor/skills ~/.cursor, cursor
gemini-cli Gemini CLI .gemini/skills ~/.gemini/skills gemini
github-copilot GitHub Copilot .github/skills ~/.copilot/skills ~/.copilot, copilot
goose Goose .agents/skills ~/.agents/skills ~/.config/goose, goose
opencode OpenCode .opencode/skills ~/.config/opencode/skills ~/.config/opencode, opencode
windsurf Windsurf .devin/skills ~/.codeium/windsurf/skills ~/.codeium/windsurf, windsurf
zed Zed .agents/skills ~/.agents/skills ~/.config/zed, zed
An assistant that is not listed is refused by name. It can still use Aggrega
through its MCP server: connect it to "aggrega mcp" as
https://aggrega.ai/docs/install/ describes.

Прапорці aggrega skills install

ПрапорецьЗа замовчуваннямОпис
--agent[]Асистент, для якого інсталювати навичку, за ідентифікатором (наприклад, claude-code, codex, cursor або gemini-cli). Можна повторювати; довідка перелічує кожен ідентифікатор і теку, до якої записує кожен із них. Обов’язковий без —global; з —global і без жодного вказаного асистента навичка інсталюється для асистентів, знайдених на цій машині.
--globalfalseІнсталювати в користувацьку теку навичок кожного асистента у вашому домашньому каталозі, яку він читає в кожному проєкті, замість теки навичок проєкту в корені вашого робочого простору.

Опис aggrega skills list

List the skills built into this binary, and the assistants "aggrega skills
install" can write them for, with the project folder and the per-user folder
each assistant reads skills from. It writes nothing.

Що вона робить

aggrega skills install записує навичку Aggrega в теку навичок кожного ШІ-асистента, якого ви називаєте за допомогою --agent, або, з --global і без --agent, кожного асистента, якого вона знаходить на цій машині. Навичка — це тека з файлом SKILL.md у відкритому форматі Agent Skills: короткий блок frontmatter, що називає навичку й каже, коли її використовувати, а за ним інструкції. Асистент, що читає навички, завантажує її, коли ваш запит підходить, тож знає, як інсталювати Aggrega, як підключитися до aggrega mcp, як розпочати робочий простір і як виконувати цикл авторингу, описаний у розділі Написання файлів Aggrega.

Навичка не містить копії жодної схеми чи контракту сутності. Вона каже асистентові запитувати у виконуваного файлу кожну структурну відповідь — через інструменти MCP, якщо сервер підключено, інакше через командний рядок aggrega — і читати опубліковану документацію, щоб дізнатися, що що означає. Навичка вбудована у виконуваний файл, тож копія, яку вона записує, відповідає встановленій у вас версії.

Terminal window
aggrega skills install --agent claude-code
Installed the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggrega

Куди потрапляє навичка

Без --global навичка потрапляє до теки навичок проєкту асистента в корені вашого робочого простору, де асистент шукає навички проєкту і де ви їх комітите. Робочий простір — той, який знаходить кожна команда: названий через --workspace-root або знайдений від каталогу, в якому ви запускаєте команду, тож запуск із підтеки однаково інсталює в корінь; каталог, якого не позначає жоден робочий простір, є власним коренем. З --global вона потрапляє до користувацької теки навичок асистента у вашому домашньому каталозі, яку асистент читає в кожному проєкті. Таблиця в описі вище наводить обидві теки для кожного асистента; кожна — це тека, яку називає власна документація асистента, а ~ позначає ваш домашній каталог.

Кілька асистентів читають спільну теку .agents/skills. Якщо назвати більше ніж одного з них, навичка записується туди один раз, а всі вони називаються в одному рядку, що про це повідомляє:

Terminal window
aggrega skills install --agent codex --agent zed --global
Installed the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggrega

Асистенти на цій машині

З --global і без --agent команда інсталює навичку для асистентів, яких знаходить на цій машині. Асистент вважається знайденим, коли його власна тека конфігурації є у вашому домашньому каталозі або його команда є у вашому PATH; стовпець found by таблиці в описі вище називає обидва для кожного асистента. Тека чи команда використовується лише там, де вона належить тільки цьому асистентові, тож її знаходження ніколи не означає іншого: спільна тека .agents/skills не знаходить нікого, а .gemini, де файли зберігають і Gemini CLI, і Antigravity, не знаходить жодного з них — Gemini CLI знаходиться за його командою gemini, а кожен продукт Antigravity — за власною текою всередині .gemini. Асистента, конфігурація якого міститься деінде у вашій системі, знаходять за його командою або називають за допомогою --agent.

Команда виводить кожного знайденого асистента й те, за чим його знайдено, а потім інсталює:

Terminal window
aggrega skills install --global
Found Claude Code (claude-code), from the folder /home/you/.claude
Found Codex (codex), from the command /usr/local/bin/codex
Installed the aggrega skill for Claude Code at /home/you/.claude/skills/aggrega
Installed the aggrega skill for Codex at /home/you/.agents/skills/aggrega

У терміналі вона спершу запитує. Після рядків, що називають знайдене, вона просить вас підтвердити: натисніть Enter, щоб інсталювати для цих асистентів, або введіть ідентифікатори інших асистентів, розділені пробілами чи комами, щоб додати їх. Якщо вона не знайшла жодного, то натомість запитує ідентифікатори, а порожня відповідь нічого не записує. Коли стандартний вхід не є терміналом — у скрипті, в асистента, що виконує команду за вас, або у власному інструменті асистента для цього — вона нічого не запитує й інсталює для знайдених асистентів. Якщо вона не знаходить жодного і жодного їй не вказано, вона нічого не записує, повідомляє про це й завершується з ненульовим кодом.

Зазначення будь-якого --agent пропускає пошук: команда інсталює для названих вами асистентів і жодних інших. Інсталяція в проєкт, без --global, завжди їх називає: вона призначена для асистентів, якими користуються люди проєкту, а цього ця машина не підкаже.

Повторна інсталяція і що відхиляється

Кожен файл, який записує команда, містить один рядок коментаря одразу після frontmatter, який каже, що файл походить із навички, вбудованої у виконуваний файл aggrega, і що повторна інсталяція його замінить. За цим рядком команда відрізняє свою копію від вашої:

  • Копія з цим рядком замінюється. Повторний запуск команди після оновлення Aggrega оновлює навичку до нової версії, а рядок, який вона виводить, каже Replaced, а не Installed.
  • Файл без цього рядка відхиляється. SKILL.md, що вже є в місці призначення і який команда не записувала, належить вам, тож команда називає його шлях, нічого ніде не записує й завершується з ненульовим кодом. Перемістіть файл убік або видаліть його, а потім знову запустіть команду. Щоб зберегти власні зміни, тримайте їх у навичці з іншою назвою.
  • Тека, досяжна через посилання, що веде за межі робочого простору, відхиляється. Без --global кожна тека й кожен файл, які записала б команда, обмежені робочим простором: якщо тека навичок асистента або тека на шляху до неї є посиланням, що веде за межі робочого простору, команда називає посилання і те, куди воно веде, нічого ніде не записує й завершується з ненульовим кодом — це умова, описана в A path the operation writes leads through a link out of the directory it must stay inside (Шлях, у який записує операція, веде через посилання за межі каталогу, в якому має залишатися). Через посилання, що залишається всередині робочого простору, запис виконується.

Кожне місце призначення перевіряється до будь-якого запису, тож відмова для одного асистента залишає теки всіх інших асистентів такими, якими вони були. Файли в теці навички, які навичка не записує, не зачіпаються.

Невідомі асистенти

--agent приймає лише ідентифікатори з таблиці вище; кожен із них — це ідентифікатор, який відкритий інструмент командного рядка для навичок використовує для того самого асистента. Будь-який інший ідентифікатор відхиляється із зазначенням його назви та списку відомих. Асистент, якого немає в списку, однаково може використовувати Aggrega: підключіть його до сервера MCP, як описано в розділі Підключення сервера MCP, і він отримає доступ до тих самих інструментів і довідкових матеріалів, на які вказує навичка.

Приклади

Інсталювати навичку для Claude Code в цьому проєкті:

Terminal window
aggrega skills install --agent claude-code

Інсталювати її для Gemini CLI і Cursor в усіх ваших проєктах:

Terminal window
aggrega skills install --agent gemini-cli --agent cursor --global

Інсталювати її в кожен ваш проєкт для асистентів на цій машині:

Terminal window
aggrega skills install --global

Оновити інстальовану копію до виконуваного файлу, до якого ви щойно оновилися:

Terminal window
aggrega skills install --agent claude-code

Перелік відомого

aggrega skills list виводить навички, вбудовані в цей виконуваний файл, з їхніми описами, а потім кожного асистента, якого знає aggrega skills install, з його текою проєкту та користувацькою текою. Нічого не записує.

Terminal window
aggrega skills list