aggrega skills
Instalar a skill do Aggrega em um 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 | Grava 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 ele pode instalá-las |
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 | Padrã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 lista cada identificador e a pasta em que cada um grava. Obrigatório sem —global; com —global e nenhum informado, a skill é instalada para os assistentes encontrados nesta máquina. |
--global | false | Instala na pasta de skills por usuário de cada assistente no seu diretório pessoal, que ele lê em todo projeto, em vez de na pasta de skills do projeto na raiz do seu 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 ele faz
aggrega skills install grava a skill do Aggrega na pasta de skills de cada assistente de IA que você nomeia com --agent ou, com --global e sem --agent, de cada um que ele encontra nesta máquina. Uma skill é uma pasta que contém um arquivo SKILL.md no formato aberto Agent Skills: um breve bloco de frontmatter que nomeia a skill e diz quando usá-la, seguido de instruções. Um assistente que lê skills a carrega quando sua solicitação corresponde, e assim sabe como instalar o Aggrega, como se conectar ao aggrega mcp, como iniciar um workspace e como executar o ciclo de autoria descrito em Escrever arquivos do Aggrega.
A skill não carrega nenhuma cópia de qualquer schema ou contrato de entidade. Ela instrui o assistente a pedir ao binário cada resposta estrutural — as ferramentas MCP onde o servidor está conectado, caso contrário a linha de comando aggrega — e a ler a documentação publicada para saber o que as coisas significam. A skill é embutida no binário, então a cópia que ela grava corresponde à versão que você tem instalada.
aggrega skills install --agent claude-codeInstalled the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggregaOnde a skill fica
Sem --global, a skill vai para a pasta de skills de projeto do assistente na raiz do seu workspace, onde o assistente procura as skills do projeto e onde você faz commit delas. O workspace é aquele que todo comando encontra — o que --workspace-root nomeia, ou o encontrado a partir do diretório em que você executa o comando, de modo que executá-lo a partir de uma subpasta ainda instala na raiz — e um diretório que nenhum workspace marca é sua própria raiz. Com --global, ela vai para a pasta de skills por usuário do assistente no seu diretório pessoal, que o assistente lê em todo projeto. A tabela na descrição acima mostra as duas pastas para cada assistente; cada uma é a pasta que a própria documentação desse assistente indica, e ~ representa seu diretório pessoal.
Vários assistentes leem a pasta compartilhada .agents/skills. Nomear mais de um deles grava a skill ali uma única vez e nomeia todos eles na única linha que relata isso:
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 sua própria pasta de configuração está no seu diretório pessoal, ou seu comando está no seu 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 àquele assistente, de modo que encontrá-lo nunca vale por outro: a pasta compartilhada .agents/skills não encontra ninguém, e .gemini, onde o Gemini CLI e o Antigravity guardam arquivos, 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 fica em outro lugar do seu sistema é encontrado pelo seu comando, ou nomeado com --agent.
O comando imprime cada assistente que encontrou e o que o encontrou, e então 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/aggregaEm um terminal, ele pergunta primeiro. Depois das linhas que nomeiam o que encontrou, ele pede que você confirme: pressione Enter para instalar para esses, ou digite os identificadores de outros assistentes, separados por espaços ou vírgulas, para adicioná-los. Quando não encontrou nenhum, ele pede os identificadores em vez disso, e uma resposta vazia não grava nada. Quando a entrada padrão não é um terminal — um script, um assistente executando o comando para você, ou a própria ferramenta do assistente para isso —, ele não pergunta nada e instala para os assistentes que encontrou. Quando não encontra nenhum e nenhum é informado, ele não grava nada, avisa e sai com código diferente de zero.
Nomear qualquer --agent pula a busca: o comando instala para os assistentes que você nomeou e nenhum outro. Uma instalação de projeto, sem --global, sempre os nomeia: ela é para os assistentes que as pessoas do projeto usam, o que esta máquina não informa.
Instalar de novo, e o que é recusado
Todo arquivo que o comando grava carrega uma linha de comentário, logo após o frontmatter, dizendo que ele vem da skill embutida no binário aggrega e que instalar de novo o substitui. Essa linha é como o comando distingue a própria cópia da sua:
- Uma cópia que carrega a linha é substituída. Executar o comando de novo após atualizar o Aggrega leva a skill à nova versão, e a linha que ele imprime diz
Replacedem vez deInstalled. - Um arquivo sem a linha é recusado. Um
SKILL.mdjá presente no destino que o comando não gravou é seu, então o comando nomeia o caminho dele, não grava nada em lugar nenhum e termina com código diferente de zero. Mova o arquivo para outro lugar ou remova-o e execute o comando de novo. Para manter alterações suas, mantenha-as em uma skill com outro nome. - Uma pasta alcançada por um link que leva para fora do workspace é recusada. Sem
--global, toda pasta e todo arquivo que o comando gravaria ficam restritos ao workspace: quando a pasta de skills de um assistente, ou uma pasta no caminho até ela, é um link que leva para fora do workspace, o comando nomeia o link e para onde ele leva, não grava nada em lugar nenhum e termina com 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 grava leva, por um link, para fora do diretório em que deve permanecer). Um link que permanece dentro do workspace é seguido na gravação.
Todo destino é verificado antes que qualquer coisa seja gravada, então uma recusa para um assistente também deixa a pasta de todos os outros assistentes como estava. Os arquivos na pasta da skill que a skill não grava são deixados intactos.
Assistentes que ele não conhece
--agent aceita apenas os identificadores da tabela acima, cada um sendo o identificador que a ferramenta de linha de comando aberta para skills usa para o mesmo assistente. Qualquer outro identificador é recusado pelo nome, com a lista dos que ele conhece. Um assistente que não está listado ainda pode usar o Aggrega: conecte-o ao servidor MCP como descreve Conectar o servidor MCP, e ele alcança as mesmas ferramentas e o mesmo material de referência para os quais a skill aponta.
Exemplos
Instale a skill para o Claude Code neste projeto:
aggrega skills install --agent claude-codeInstale-a para o Gemini CLI e o Cursor em todos os seus projetos:
aggrega skills install --agent gemini-cli --agent cursor --globalInstale-a em todos os seus projetos para os assistentes nesta máquina:
aggrega skills install --globalAtualize uma cópia instalada para o binário para o qual você acabou de atualizar:
aggrega skills install --agent claude-codeListar o que ele conhece
aggrega skills list imprime as skills embutidas neste binário com suas descrições e, depois, cada assistente que aggrega skills install conhece, com sua pasta de projeto e sua pasta por usuário. Ele não grava nada.
aggrega skills list