aggrega skills
Instalar a skill do Aggrega num assistente de IA
Sinopse
aggrega skillsDescrição
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.Subcomandos
| Comando | Descrição |
|---|---|
aggrega skills install | Escreve a skill do Aggrega na pasta de skills de um assistente de IA |
aggrega skills list | Lista as skills que este binário inclui e os assistentes para os quais as pode instalar |
Descrição 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 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 de aggrega skills install
| Flag | Predefinição | Descrição |
|---|---|---|
--agent | [] | Assistente para o qual instalar a skill, por identificador (por exemplo claude-code, codex, cursor ou gemini-cli). Repetível; a ajuda enumera cada identificador e a pasta em que cada um escreve. Obrigatório sem —global; com —global e nenhum indicado, a skill é instalada para os assistentes encontrados nesta máquina. |
--global | false | Instala na pasta de skills por utilizador de cada assistente, no diretório pessoal, que o assistente lê em todos os projetos, em vez de na pasta de skills do projeto na raiz do workspace. |
Descrição de 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.O que faz
aggrega skills install escreve a skill do Aggrega na pasta de skills de cada assistente de IA nomeado com --agent ou, com --global e sem --agent, de cada um que encontra nesta máquina. Uma skill é uma pasta que contém um ficheiro SKILL.md no formato aberto Agent Skills: um breve bloco de frontmatter que nomeia a skill e diz quando a usar, seguido de instruções. Um assistente que lê skills carrega-a quando o pedido corresponde, e fica assim a saber como instalar o Aggrega, como se ligar ao aggrega mcp, como iniciar um espaço de trabalho e como executar o ciclo de autoria descrito em Escrever ficheiros do Aggrega.
A skill não contém qualquer cópia de um schema ou de um contrato de entidade. Indica ao assistente que peça ao binário cada resposta estrutural — as ferramentas MCP onde o servidor está ligado e, caso contrário, a linha de comandos aggrega — e que leia a documentação publicada para saber o que as coisas significam. A skill está incorporada no binário, pelo que a cópia que escreve corresponde à versão instalada.
aggrega skills install --agent claude-codeInstalled the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggregaOnde fica a skill
Sem --global, a skill vai para a pasta de skills de projeto do assistente na raiz do workspace, onde o assistente procura as skills do projeto e onde estas são submetidas com commit. O workspace é aquele que todos os comandos encontram — o que --workspace-root indica, ou o encontrado a partir do diretório em que o comando é executado, pelo que executá-lo a partir de uma subpasta instala na mesma na raiz — e um diretório que nenhum workspace marca é a sua própria raiz. Com --global, vai para a pasta de skills por utilizador do assistente no diretório pessoal, que o assistente lê em todos os projetos. A tabela na descrição acima indica ambas as pastas para cada assistente; cada uma é a pasta que a documentação do próprio assistente indica, e ~ representa o diretório pessoal.
Vários assistentes leem a pasta partilhada .agents/skills. Nomear mais do que um deles escreve a skill aí uma única vez e nomeia-os todos na única linha que o reporta:
aggrega skills install --agent codex --agent zed --globalInstalled the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggregaOs assistentes nesta máquina
Com --global e sem --agent, o comando instala a skill para os assistentes que encontra nesta máquina. Um assistente conta como encontrado quando a sua própria pasta de configuração está no diretório pessoal do utilizador, ou o seu comando está no PATH; a coluna found by da tabela na descrição acima indica ambos para cada assistente. Uma pasta ou um comando só é usado quando pertence exclusivamente a esse assistente, pelo que encontrá-lo nunca vale por outro: a pasta partilhada .agents/skills não encontra ninguém, e .gemini, onde tanto o Gemini CLI como o Antigravity guardam ficheiros, não encontra nenhum dos dois — o Gemini CLI é encontrado pelo seu comando gemini, e cada produto Antigravity pela sua própria pasta dentro de .gemini. Um assistente cuja configuração se encontra noutro local do sistema é encontrado pelo seu comando, ou nomeado com --agent.
O comando imprime cada assistente que encontrou e aquilo que o encontrou, e depois instala:
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/aggregaNum terminal, pergunta primeiro. Depois das linhas que nomeiam o que encontrou, pede confirmação: prima Enter para instalar para esses, ou escreva os identificadores de outros assistentes, separados por espaços ou vírgulas, para os acrescentar. Quando não encontrou nenhum, pede antes os identificadores, e uma resposta vazia não escreve nada. Quando a entrada padrão não é um terminal — um script, um assistente a executar o comando pelo utilizador, ou a própria ferramenta do assistente para o efeito —, não pergunta nada e instala para os assistentes que encontrou. Quando não encontra nenhum e nenhum lhe é indicado, não escreve nada, informa disso e termina com um código diferente de zero.
Nomear qualquer --agent salta a pesquisa: o comando instala para os assistentes nomeados e para nenhum outro. Uma instalação de projeto, sem --global, nomeia-os sempre: destina-se aos assistentes que as pessoas do projeto usam, o que esta máquina não indica.
Instalar novamente, e o que recusa
Cada ficheiro que o comando escreve tem uma linha de comentário, logo a seguir ao frontmatter, a indicar que provém da skill incorporada no binário aggrega e que instalar novamente o substitui. É por essa linha que o comando distingue a sua própria cópia da do utilizador:
- Uma cópia com a linha é substituída. Executar novamente o comando depois de atualizar o Aggrega leva a skill para a nova versão, e a linha que imprime diz
Replacedem vez deInstalled. - Um ficheiro sem a linha é recusado. Um
SKILL.mdjá presente no destino que o comando não escreveu pertence ao utilizador, pelo que o comando indica o respetivo caminho, não escreve nada em lado nenhum e termina com um código diferente de zero. Mova o ficheiro para outro lado ou remova-o e, em seguida, execute novamente o comando. Para manter alterações próprias, mantenha-as numa skill com outro nome. - Uma pasta alcançada através de uma ligação que leva para fora do workspace é recusada. Sem
--global, todas as pastas e ficheiros que o comando escreveria ficam restritos ao workspace: quando a pasta de skills de um assistente, ou uma pasta no caminho até ela, é uma ligação que leva para fora do workspace, o comando indica a ligação e para onde leva, não escreve nada em lado nenhum e termina com um código diferente de zero — a condição descrita em A path the operation writes leads through a link out of the directory it must stay inside (Um caminho que a operação escreve leva, através de uma ligação, para fora do diretório dentro do qual tem de permanecer). Uma ligação que permanece dentro do workspace é seguida na escrita.
Cada destino é verificado antes de qualquer escrita, pelo que uma recusa para um assistente deixa também a pasta de todos os outros assistentes como estava. Os ficheiros na pasta da skill que a skill não escreve são deixados intactos.
Assistentes que não conhece
--agent aceita apenas os identificadores da tabela acima, sendo cada um o identificador que a ferramenta aberta de linha de comandos para skills usa para o mesmo assistente. Qualquer outro identificador é recusado pelo nome, com a lista dos que conhece. Um assistente que não esteja listado pode ainda assim usar o Aggrega: ligue-o ao servidor MCP conforme descrito em Ligar o servidor MCP, e alcança as mesmas ferramentas e o mesmo material de referência para os quais a skill aponta.
Exemplos
Instalar a skill para o Claude Code neste projeto:
aggrega skills install --agent claude-codeInstalá-la para o Gemini CLI e o Cursor em todos os seus projetos:
aggrega skills install --agent gemini-cli --agent cursor --globalInstalá-la em todos os seus projetos para os assistentes nesta máquina:
aggrega skills install --globalAtualizar uma cópia instalada para o binário para o qual acabou de atualizar:
aggrega skills install --agent claude-codeListar o que conhece
aggrega skills list imprime as skills incorporadas neste binário com as respetivas descrições e, em seguida, cada assistente que aggrega skills install conhece, com a respetiva pasta de projeto e pasta por utilizador. Não escreve nada.
aggrega skills list