Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

aggrega skills

Installa la skill di Aggrega in un assistente AI

Sinossi

aggrega skills

Descrizione

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.

Sottocomandi

ComandoDescrizione
aggrega skills installScrive la skill di Aggrega nella cartella delle skill di un assistente AI
aggrega skills listElenca le skill fornite da questo binario e gli assistenti per cui può installarle

Descrizione di 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.

Flag di aggrega skills install

FlagPredefinitoDescrizione
--agent[]Assistente per cui installare la skill, tramite identificatore (ad esempio claude-code, codex, cursor o gemini-cli). Ripetibile; l’help elenca ogni identificatore e la cartella in cui scrive ciascuno. Obbligatorio senza —global; con —global e nessuno indicato, la skill viene installata per gli assistenti trovati su questa macchina.
--globalfalseInstalla nella cartella delle skill per utente di ogni assistente nella tua home directory, che l’assistente legge in ogni progetto, anziché nella cartella delle skill del progetto alla radice del tuo workspace.

Descrizione di 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.

Cosa fa

aggrega skills install scrive la skill di Aggrega nella cartella delle skill di ogni assistente AI che nomini con --agent oppure, con --global e senza --agent, di ognuno che trova su questa macchina. Una skill è una cartella che contiene un file SKILL.md nel formato aperto Agent Skills: un breve blocco di frontmatter che nomina la skill e dice quando usarla, seguito dalle istruzioni. Un assistente che legge le skill la carica quando la tua richiesta corrisponde, così sa come installare Aggrega, come collegarsi ad aggrega mcp, come avviare un workspace e come eseguire il ciclo di authoring descritto in Scrivere file Aggrega.

La skill non contiene alcuna copia di schemi o contratti di entità. Dice all’assistente di chiedere al binario ogni risposta strutturale — gli strumenti MCP dove il server è connesso, altrimenti la riga di comando aggrega — e di leggere la documentazione pubblicata per il significato delle cose. La skill è integrata nel binario, quindi la copia che scrive corrisponde alla versione che hai installato.

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

Dove finisce la skill

Senza --global, la skill va nella cartella delle skill di progetto dell’assistente alla radice del tuo workspace, dove l’assistente cerca le skill del progetto e dove le committi. Il workspace è quello che trova ogni comando — quello nominato da --workspace-root, o quello trovato a partire dalla directory in cui esegui il comando, quindi eseguirlo da una sottocartella installa comunque alla radice — e una directory che nessun workspace contrassegna è la propria radice. Con --global, va nella cartella delle skill per utente dell’assistente nella tua home directory, che l’assistente legge in ogni progetto. La tabella nella descrizione sopra riporta entrambe le cartelle per ogni assistente; ciascuna è la cartella indicata dalla documentazione dell’assistente stesso, e ~ indica la tua home directory.

Diversi assistenti leggono la cartella condivisa .agents/skills. Nominarne più d’uno scrive la skill lì una sola volta e li nomina tutti nell’unica riga che lo segnala:

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

Gli assistenti su questa macchina

Con --global e senza --agent, il comando installa la skill per gli assistenti che trova su questa macchina. Un assistente risulta trovato quando la sua cartella di configurazione si trova nella tua home directory, oppure quando il suo comando è nel tuo PATH; la colonna found by della tabella nella descrizione sopra indica entrambi per ogni assistente. Una cartella o un comando viene usato solo dove appartiene esclusivamente a quell’assistente, quindi trovarlo non vale mai per un altro: la cartella condivisa .agents/skills non trova nessuno, e .gemini, dove sia Gemini CLI sia Antigravity tengono file, non trova né l’uno né l’altro — Gemini CLI viene trovato dal suo comando gemini, e ogni prodotto Antigravity dalla propria cartella sotto .gemini. Un assistente la cui configurazione si trova altrove nel sistema viene trovato dal suo comando, oppure nominato con --agent.

Il comando stampa ogni assistente che ha trovato e che cosa lo ha trovato, poi installa:

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

In un terminale chiede prima. Dopo le righe che nominano ciò che ha trovato, ti chiede di confermare: premi Invio per installare per quelli, oppure digita gli identificatori di altri assistenti, separati da spazi o virgole, per aggiungerli. Se non ne ha trovato nessuno, chiede invece gli identificatori, e una risposta vuota non scrive nulla. Se lo standard input non è un terminale — uno script, un assistente che esegue il comando per te, o lo strumento dell’assistente stesso per farlo — non chiede nulla e installa per gli assistenti che ha trovato. Se non ne trova nessuno e non ne riceve nessuno, non scrive nulla, lo segnala ed esce con un codice diverso da zero.

Indicare un qualsiasi --agent salta la ricerca: il comando installa per gli assistenti che hai nominato e per nessun altro. Un’installazione di progetto, senza --global, li nomina sempre: è destinata agli assistenti usati dalle persone del progetto, cosa che questa macchina non può sapere.

Installare di nuovo, e che cosa rifiuta

Ogni file che il comando scrive porta una riga di commento, subito dopo il frontmatter, che dice che proviene dalla skill integrata nel binario aggrega e che installare di nuovo lo sostituisce. Quella riga è il modo in cui il comando distingue la propria copia dalla tua:

  • Una copia che porta la riga viene sostituita. Eseguire di nuovo il comando dopo l’aggiornamento di Aggrega porta la skill alla nuova versione, e la riga che stampa dice Replaced anziché Installed.
  • Un file senza la riga viene rifiutato. Un SKILL.md già presente nella destinazione che il comando non ha scritto è tuo, quindi il comando ne nomina il percorso, non scrive nulla da nessuna parte e termina con un codice diverso da zero. Sposta il file altrove o rimuovilo, poi esegui di nuovo il comando. Per mantenere modifiche tue, tienile in una skill con un altro nome.
  • Una cartella raggiunta tramite un link che porta fuori dal workspace viene rifiutata. Senza --global, ogni cartella e ogni file che il comando scriverebbe sono vincolati al workspace: dove la cartella delle skill di un assistente, o una cartella sul percorso verso di essa, è un link che porta fuori dal workspace, il comando nomina il link e dove porta, non scrive nulla da nessuna parte e termina con un codice diverso da zero — la condizione descritta in A path the operation writes leads through a link out of the directory it must stay inside (Un percorso che l’operazione scrive porta, tramite un link, fuori dalla directory in cui deve restare). Un link che resta all’interno del workspace viene seguito nella scrittura.

Ogni destinazione viene controllata prima che venga scritto qualcosa, quindi un rifiuto per un assistente lascia invariata anche la cartella di ogni altro assistente. I file nella cartella della skill che la skill non scrive vengono lasciati stare.

Assistenti che non conosce

--agent accetta solo gli identificatori della tabella sopra, ciascuno l’identificatore che lo strumento a riga di comando aperto per le skill usa per lo stesso assistente. Qualsiasi altro identificatore viene rifiutato per nome, con l’elenco di quelli che conosce. Un assistente non elencato può comunque usare Aggrega: collegalo al server MCP come descrive Collegare il server MCP, e raggiungerà gli stessi strumenti e lo stesso materiale di riferimento a cui rimanda la skill.

Esempi

Installa la skill per Claude Code in questo progetto:

Terminal window
aggrega skills install --agent claude-code

Installala per Gemini CLI e Cursor in ogni tuo progetto:

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

Installala in ogni tuo progetto per gli assistenti su questa macchina:

Terminal window
aggrega skills install --global

Porta una copia installata al livello del binario a cui hai appena aggiornato:

Terminal window
aggrega skills install --agent claude-code

Elencare ciò che conosce

aggrega skills list stampa le skill integrate in questo binario con le loro descrizioni, poi ogni assistente che aggrega skills install conosce, con la sua cartella di progetto e la sua cartella per utente. Non scrive nulla.

Terminal window
aggrega skills list