Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

aggrega skills

Instalar a skill do Aggrega em um assistente de IA

Sinopse

aggrega skills

Descriçã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 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.

Subcomandos

ComandoDescrição
aggrega skills installGrava a skill do Aggrega na pasta de skills de um assistente de IA
aggrega skills listLista 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 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 de aggrega skills install

FlagPadrãoDescriçã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.
--globalfalseInstala 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 skills
install" can write them for, with the project folder and the per-user folder
each 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.

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

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

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

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

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

Em 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 Replaced em vez de Installed.
  • Um arquivo sem a linha é recusado. Um SKILL.md já 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:

Terminal window
aggrega skills install --agent claude-code

Instale-a para o Gemini CLI e o Cursor em todos os seus projetos:

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

Instale-a em todos os seus projetos para os assistentes nesta máquina:

Terminal window
aggrega skills install --global

Atualize uma cópia instalada para o binário para o qual você acabou de atualizar:

Terminal window
aggrega skills install --agent claude-code

Listar 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.

Terminal window
aggrega skills list