Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

aggrega skills

Installer la skill Aggrega dans un assistant IA

Synopsis

aggrega skills

Description

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.

Sous-commandes

CommandeDescription
aggrega skills installÉcrit la skill Aggrega dans le dossier de skills d’un assistant IA
aggrega skills listListe les skills que ce binaire fournit et les assistants pour lesquels il peut les installer

Description de 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.

Flags de aggrega skills install

OptionPar défautDescription
--agent[]Assistant pour lequel installer la skill, par identifiant (par exemple claude-code, codex, cursor ou gemini-cli). Répétable ; l’aide liste chaque identifiant et le dossier dans lequel chacun écrit. Obligatoire sans —global ; avec —global et sans identifiant donné, la skill est installée pour les assistants trouvés sur cette machine.
--globalfalseInstalle dans le dossier de skills par utilisateur de chaque assistant, dans votre répertoire personnel, qu’il lit dans chaque projet, plutôt que dans le dossier de skills du projet à la racine de votre espace de travail.

Description de 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.

Fonctionnement

aggrega skills install écrit la skill Aggrega dans le dossier de skills de chaque assistant d’IA que vous nommez avec --agent ou, avec --global et sans --agent, de chacun de ceux qu’il trouve sur cette machine. Une skill est un dossier contenant un fichier SKILL.md au format ouvert Agent Skills : un court bloc de frontmatter qui nomme la skill et indique quand l’utiliser, suivi d’instructions. Un assistant qui lit les skills la charge lorsque votre demande correspond, et sait ainsi comment installer Aggrega, comment se connecter à aggrega mcp, comment démarrer un workspace et comment mener la boucle de rédaction décrite dans Rédiger des fichiers Aggrega.

La skill ne contient aucune copie d’un schéma ou d’un contrat d’entité. Elle indique à l’assistant de demander au binaire chaque réponse structurelle — les outils MCP là où le serveur est connecté, la ligne de commande aggrega sinon — et de lire la documentation publiée pour savoir ce que signifient les choses. La skill est intégrée au binaire, de sorte que la copie qu’elle écrit correspond à la version que vous avez installée.

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

Où la skill est placée

Sans --global, la skill va dans le dossier de skills du projet de l’assistant, à la racine de votre espace de travail, là où l’assistant cherche les skills du projet et là où vous les committez. L’espace de travail est celui que trouve chaque commande — celui que nomme --workspace-root, ou celui trouvé à partir du répertoire dans lequel vous exécutez la commande, de sorte que l’exécuter depuis un sous-dossier installe quand même à la racine — et un répertoire qu’aucun espace de travail ne marque est sa propre racine. Avec --global, elle va dans le dossier de skills par utilisateur de l’assistant, dans votre répertoire personnel, que l’assistant lit dans chaque projet. Le tableau de la description ci-dessus donne les deux dossiers pour chaque assistant ; chacun est le dossier que nomme la propre documentation de cet assistant, et ~ désigne votre répertoire personnel.

Plusieurs assistants lisent le dossier partagé .agents/skills. En nommer plus d’un écrit la skill à cet endroit une seule fois et les nomme tous dans l’unique ligne qui le signale :

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

Les assistants présents sur cette machine

Avec --global et sans --agent, la commande installe la skill pour les assistants qu’elle trouve sur cette machine. Un assistant est considéré comme trouvé lorsque son propre dossier de configuration se trouve dans votre répertoire personnel, ou que sa commande est dans votre PATH ; la colonne found by du tableau de la description ci-dessus indique les deux pour chaque assistant. Un dossier ou une commande n’est utilisé que là où il appartient à cet assistant seul, de sorte que le trouver ne vaut jamais pour un autre : le dossier partagé .agents/skills ne trouve personne, et .gemini, où Gemini CLI et Antigravity conservent tous deux des fichiers, ne trouve ni l’un ni l’autre — Gemini CLI est trouvé par sa commande gemini, et chaque produit Antigravity par son propre dossier sous .gemini. Un assistant dont la configuration se trouve ailleurs sur votre système est trouvé par sa commande, ou nommé avec --agent.

La commande affiche chaque assistant trouvé et ce qui l’a trouvé, puis installe :

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

Dans un terminal, elle demande d’abord. Après les lignes qui nomment ce qu’elle a trouvé, elle vous demande de confirmer : appuyez sur Entrée pour installer pour ceux-là, ou saisissez les identifiants d’autres assistants, séparés par des espaces ou des virgules, pour les ajouter. Si elle n’en a trouvé aucun, elle demande plutôt les identifiants, et une réponse vide n’écrit rien. Lorsque l’entrée standard n’est pas un terminal — un script, un assistant qui exécute la commande pour vous, ou l’outil propre de l’assistant pour cela —, elle ne demande rien et installe pour les assistants trouvés. Si elle n’en trouve aucun et qu’aucun ne lui est donné, elle n’écrit rien, le signale et se termine avec un code non nul.

Nommer un --agent quelconque saute la recherche : la commande installe pour les assistants que vous avez nommés et aucun autre. Une installation de projet, sans --global, les nomme toujours : elle est destinée aux assistants qu’utilisent les personnes du projet, ce que cette machine ne dit pas.

Réinstaller, et ce qui est refusé

Chaque fichier que la commande écrit porte une ligne de commentaire, juste après le frontmatter, indiquant qu’il provient de la skill intégrée au binaire aggrega et qu’une nouvelle installation le remplace. Cette ligne est ce qui permet à la commande de distinguer sa propre copie de la vôtre :

  • Une copie portant cette ligne est remplacée. Relancer la commande après une mise à niveau d’Aggrega met la skill à jour vers la nouvelle version, et la ligne imprimée indique Replaced plutôt que Installed.
  • Un fichier sans cette ligne est refusé. Un SKILL.md déjà présent à la cible et que la commande n’a pas écrit vous appartient ; la commande nomme donc son chemin, n’écrit rien nulle part et se termine avec un code non nul. Déplacez le fichier ailleurs ou supprimez-le, puis relancez la commande. Pour conserver vos propres modifications, gardez-les dans une skill portant un autre nom.
  • Un dossier atteint par un lien menant hors de l’espace de travail est refusé. Sans --global, chaque dossier et chaque fichier que la commande écrirait sont tenus à l’espace de travail : lorsque le dossier de skills d’un assistant, ou un dossier sur le chemin qui y mène, est un lien menant hors de l’espace de travail, la commande nomme le lien et l’endroit où il mène, n’écrit rien nulle part et se termine avec un code non nul — la condition décrite dans A path the operation writes leads through a link out of the directory it must stay inside (Un chemin que l’opération écrit mène, par un lien, hors du répertoire dans lequel elle doit rester). Un lien qui reste à l’intérieur de l’espace de travail est suivi pour l’écriture.

Chaque cible est vérifiée avant que quoi que ce soit ne soit écrit, de sorte qu’un refus pour un assistant laisse aussi le dossier de chaque autre assistant tel qu’il était. Les fichiers du dossier de la skill que la skill n’écrit pas sont laissés intacts.

Assistants qu’elle ne connaît pas

--agent n’accepte que les identifiants du tableau ci-dessus, chacun étant l’identifiant que l’outil ouvert en ligne de commande pour les skills utilise pour le même assistant. Tout autre identifiant est refusé nommément, avec la liste de ceux que la commande connaît. Un assistant qui n’est pas listé peut tout de même utiliser Aggrega : connectez-le au serveur MCP comme le décrit Connecter le serveur MCP, et il accédera aux mêmes outils et au même matériel de référence que ceux vers lesquels pointe la skill.

Exemples

Installer la skill pour Claude Code dans ce projet :

Terminal window
aggrega skills install --agent claude-code

L’installer pour Gemini CLI et Cursor dans chacun de vos projets :

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

L’installer dans chacun de vos projets pour les assistants présents sur cette machine :

Terminal window
aggrega skills install --global

Mettre une copie installée au niveau du binaire vers lequel vous venez de passer :

Terminal window
aggrega skills install --agent claude-code

Lister ce qu’elle connaît

aggrega skills list imprime les skills intégrées à ce binaire avec leurs descriptions, puis chaque assistant que aggrega skills install connaît, avec son dossier de projet et son dossier par utilisateur. Elle n’écrit rien.

Terminal window
aggrega skills list