Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

aggrega skills

Den Aggrega-Skill in einen KI-Assistenten installieren

Übersicht

aggrega skills

Beschreibung

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.

Unterbefehle

BefehlBeschreibung
aggrega skills installSchreibt den Aggrega-Skill in den Skill-Ordner eines KI-Assistenten
aggrega skills listListet 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 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 von aggrega skills install

FlagStandardBeschreibung
--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.
--globalfalseInstalliert 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 skills
install" can write them for, with the project folder and the per-user folder
each 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.

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

Wo 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:

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

Die 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:

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

An 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 Replaced statt Installed.
  • 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 --global ist 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:

Terminal window
aggrega skills install --agent claude-code

Ihn für Gemini CLI und Cursor in jedem Ihrer Projekte installieren:

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

Installieren Sie ihn in jedem Ihrer Projekte für die Assistenten auf diesem Rechner:

Terminal window
aggrega skills install --global

Eine installierte Kopie auf den Stand des Binarys bringen, auf das Sie gerade aktualisiert haben:

Terminal window
aggrega skills install --agent claude-code

Auflisten, 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.

Terminal window
aggrega skills list