aggrega skills
Den Aggrega-Skill in einen KI-Assistenten installieren
Übersicht
aggrega skillsBeschreibung
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 skilltells an assistant how to install Aggrega, how to connect it to the aggrega MCPserver, 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 tothis binary for every structural question and to the published documentationfor every conceptual one.
The skill is built into this binary, so the copy it installs matches theversion you have.Unterbefehle
| Befehl | Beschreibung |
|---|---|
aggrega skills install | Schreibt den Aggrega-Skill in den Skill-Ordner eines KI-Assistenten |
aggrega skills list | Listet die Skills auf, die dieses Binary mitbringt, und die Assistenten, für die es sie installieren kann |
Beschreibung von 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 rootof your workspace — the one found from the directory you run the command in, ornamed 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 goesinto 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, andnothing is written.
--agent may be given more than once. Where several of the named assistants readthe same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants foundon this machine: each one whose configuration folder is in your home directoryor whose command is on your PATH, as the table below names them. The commandprints each assistant it found and what found it. At a terminal it then asksbefore writing: press Enter to install for those, or type the identifiers ofother assistants to add them. Where standard input is not a terminal itinstalls for the assistants found without asking. Where it finds none and isgiven none, it writes nothing and says so. A project installation is for theassistants a project's people use rather than those on one machine, so italways names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every filewritten carries a comment line saying where it comes from. Running the commandagain replaces a copy carrying that line, which is how a newer aggrega bringsthe skill up to its own version. A file at the target that does not carry itwas not written by this command, so the command refuses, names the file andwrites nothing; move it aside or remove it, then run the command again. Everytarget is checked before anything is written, so a refusal leaves every folderas it was.
The assistants it installs for, the folders each one reads, and what finds eachon this machine — its configuration folder in your home directory, or itscommand 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 Aggregathrough its MCP server: connect it to "aggrega mcp" ashttps://aggrega.ai/docs/install/ describes.Flags von aggrega skills install
| Flag | Standard | Beschreibung |
|---|---|---|
--agent | [] | Assistent, für den der Skill installiert wird, anhand seiner Kennung (zum Beispiel claude-code, codex, cursor oder gemini-cli). Wiederholbar; die Hilfe listet jede Kennung und den Ordner auf, in den jede schreibt. Ohne —global erforderlich; mit —global und ohne Angabe wird der Skill für die auf diesem Rechner gefundenen Assistenten installiert. |
--global | false | Installiert in den benutzerbezogenen Skill-Ordner jedes Assistenten in Ihrem Home-Verzeichnis, den er in jedem Projekt liest, statt in den Projekt-Skill-Ordner an der Wurzel Ihres Workspace. |
Beschreibung von aggrega skills list
List the skills built into this binary, and the assistants "aggrega skillsinstall" can write them for, with the project folder and the per-user foldereach assistant reads skills from. It writes nothing.Funktionsweise
aggrega skills install schreibt den Aggrega-Skill in den Skill-Ordner jedes KI-Assistenten, den Sie mit --agent nennen, oder, mit --global und ohne --agent, jedes Assistenten, den es auf diesem Rechner findet. Ein Skill ist ein Ordner mit einer SKILL.md-Datei im offenen Format Agent Skills: ein kurzer Frontmatter-Block, der den Skill benennt und sagt, wann er zu verwenden ist, gefolgt von Anweisungen. Ein Assistent, der Skills liest, lädt ihn, wenn Ihre Anfrage dazu passt, und weiß so, wie Aggrega installiert wird, wie er sich mit aggrega mcp verbindet, wie ein Workspace angelegt wird und wie die in Aggrega-Dateien verfassen beschriebene Authoring-Schleife abläuft.
Der Skill enthält keine Kopie eines Schemas oder Entitätsvertrags. Er weist den Assistenten an, das Binary nach jeder strukturellen Antwort zu fragen — die MCP-Werkzeuge, wo der Server verbunden ist, sonst die Kommandozeile aggrega — und die veröffentlichte Dokumentation zu lesen, um zu erfahren, was die Dinge bedeuten. Der Skill ist in das Binary eingebaut, sodass die Kopie, die er schreibt, zur installierten Version passt.
aggrega skills install --agent claude-codeInstalled the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggregaWo der Skill landet
Ohne --global kommt der Skill in den Projekt-Skill-Ordner des Assistenten an der Wurzel Ihres Workspace, wo der Assistent nach den Skills des Projekts sucht und wo Sie sie committen. Der Workspace ist derjenige, den jeder Befehl findet — der, den --workspace-root nennt, oder der, der vom Verzeichnis aus gefunden wird, in dem Sie den Befehl ausführen, sodass die Ausführung aus einem Unterordner trotzdem an der Wurzel installiert —, und ein Verzeichnis, das kein Workspace markiert, ist seine eigene Wurzel. Mit --global kommt er in den benutzerbezogenen Skill-Ordner des Assistenten in Ihrem Home-Verzeichnis, den der Assistent in jedem Projekt liest. Die Tabelle in der Beschreibung oben gibt beide Ordner für jeden Assistenten an; jeder ist der Ordner, den die eigene Dokumentation des Assistenten nennt, und ~ steht für Ihr Home-Verzeichnis.
Mehrere Assistenten lesen den gemeinsamen Ordner .agents/skills. Werden mehrere davon genannt, wird der Skill dort einmal geschrieben, und alle werden in der einen Zeile genannt, die es meldet:
aggrega skills install --agent codex --agent zed --globalInstalled the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggregaDie Assistenten auf diesem Rechner
Mit --global und ohne --agent installiert der Befehl den Skill für die Assistenten, die er auf diesem Rechner findet. Ein Assistent gilt als gefunden, wenn sein eigener Konfigurationsordner in Ihrem Home-Verzeichnis liegt oder sein Befehl in Ihrem PATH steht; die Spalte found by der Tabelle in der Beschreibung oben nennt beides für jeden Assistenten. Ein Ordner oder Befehl wird nur dort verwendet, wo er allein diesem Assistenten gehört, sodass sein Fund nie für einen anderen steht: Der gemeinsame Ordner .agents/skills findet niemanden, und .gemini, in dem sowohl Gemini CLI als auch Antigravity Dateien ablegen, findet keinen von beiden — Gemini CLI wird über seinen Befehl gemini gefunden und jedes Antigravity-Produkt über seinen eigenen Ordner unterhalb von .gemini. Ein Assistent, dessen Konfiguration an anderer Stelle Ihres Systems liegt, wird über seinen Befehl gefunden oder mit --agent genannt.
Der Befehl gibt jeden gefundenen Assistenten aus und wodurch er gefunden wurde, und installiert dann:
aggrega skills install --globalFound Claude Code (claude-code), from the folder /home/you/.claudeFound Codex (codex), from the command /usr/local/bin/codexInstalled the aggrega skill for Claude Code at /home/you/.claude/skills/aggregaInstalled the aggrega skill for Codex at /home/you/.agents/skills/aggregaAn einem Terminal fragt er zuerst. Nach den Zeilen, die nennen, was er gefunden hat, bittet er Sie um Bestätigung: Drücken Sie die Eingabetaste, um für diese zu installieren, oder geben Sie die Kennungen weiterer Assistenten, getrennt durch Leerzeichen oder Kommas, ein, um sie hinzuzufügen. Hat er keinen gefunden, fragt er stattdessen nach den Kennungen, und eine leere Antwort schreibt nichts. Wenn die Standardeingabe kein Terminal ist — ein Skript, ein Assistent, der den Befehl für Sie ausführt, oder das eigene Werkzeug des Assistenten dafür —, fragt er nichts und installiert für die gefundenen Assistenten. Findet er keinen und wird ihm keiner genannt, schreibt er nichts, meldet dies und endet mit einem Exit-Code ungleich null.
Die Angabe eines beliebigen --agent überspringt die Suche: Der Befehl installiert für die von Ihnen genannten Assistenten und keine anderen. Eine Projektinstallation ohne --global nennt sie immer: Sie ist für die Assistenten bestimmt, die die Personen des Projekts verwenden, und das verrät dieser Rechner nicht.
Erneut installieren, und was abgelehnt wird
Jede Datei, die der Befehl schreibt, trägt direkt nach dem Frontmatter eine Kommentarzeile, die besagt, dass sie aus dem in das aggrega-Binary eingebauten Skill stammt und dass eine erneute Installation sie ersetzt. An dieser Zeile unterscheidet der Befehl seine eigene Kopie von Ihrer:
- Eine Kopie mit dieser Zeile wird ersetzt. Wird der Befehl nach einem Upgrade von Aggrega erneut ausgeführt, wird der Skill auf die neue Version gebracht, und die ausgegebene Zeile lautet
ReplacedstattInstalled. - Eine Datei ohne diese Zeile wird abgelehnt. Eine
SKILL.md, die bereits am Ziel liegt und die der Befehl nicht geschrieben hat, gehört Ihnen, daher nennt der Befehl ihren Pfad, schreibt nirgendwo etwas und endet mit einem Exit-Code ungleich null. Verschieben Sie die Datei beiseite oder entfernen Sie sie, und führen Sie den Befehl dann erneut aus. Um eigene Änderungen zu behalten, legen Sie sie in einem Skill mit einem anderen Namen ab. - Ein Ordner, der über einen aus dem Workspace hinausführenden Link erreicht wird, wird abgelehnt. Ohne
--globalist jeder Ordner und jede Datei, die der Befehl schreiben würde, an den Workspace gebunden: Wo der Skill-Ordner eines Assistenten oder ein Ordner auf dem Weg dorthin ein Link ist, der aus dem Workspace hinausführt, nennt der Befehl den Link und wohin er führt, schreibt nirgendwo etwas und endet mit einem Exit-Code ungleich null — die Bedingung, die in A path the operation writes leads through a link out of the directory it must stay inside (Ein Pfad, den der Vorgang schreibt, führt über einen Link aus dem Verzeichnis hinaus, in dem er bleiben muss) beschrieben ist. Durch einen Link, der innerhalb des Workspace bleibt, wird geschrieben.
Jedes Ziel wird geprüft, bevor etwas geschrieben wird, sodass eine Ablehnung für einen Assistenten auch den Ordner jedes anderen Assistenten unverändert lässt. Dateien im Ordner des Skills, die der Skill nicht schreibt, bleiben unberührt.
Assistenten, die es nicht kennt
--agent akzeptiert nur die Kennungen aus der Tabelle oben, jede davon die Kennung, die das offene Kommandozeilenwerkzeug für Skills für denselben Assistenten verwendet. Jede andere Kennung wird namentlich abgelehnt, mit der Liste der bekannten. Ein nicht aufgeführter Assistent kann Aggrega trotzdem verwenden: Verbinden Sie ihn mit dem MCP-Server, wie Den MCP-Server verbinden beschreibt, und er erreicht dieselben Werkzeuge und dasselbe Referenzmaterial, auf die der Skill verweist.
Beispiele
Den Skill für Claude Code in diesem Projekt installieren:
aggrega skills install --agent claude-codeIhn für Gemini CLI und Cursor in jedem Ihrer Projekte installieren:
aggrega skills install --agent gemini-cli --agent cursor --globalInstallieren Sie ihn in jedem Ihrer Projekte für die Assistenten auf diesem Rechner:
aggrega skills install --globalEine installierte Kopie auf den Stand des Binarys bringen, auf das Sie gerade aktualisiert haben:
aggrega skills install --agent claude-codeAuflisten, was es kennt
aggrega skills list gibt die in dieses Binary eingebauten Skills mit ihren Beschreibungen aus, dann jeden Assistenten, den aggrega skills install kennt, mit seinem Projektordner und seinem benutzerbezogenen Ordner. Es schreibt nichts.
aggrega skills list