A skill do Aggrega
A skill do Aggrega ensina um assistente de IA a instalar e usar o Aggrega. Ela é uma pasta chamada aggrega que contém um arquivo SKILL.md no formato aberto Agent Skills, que muitos assistentes leem de uma pasta de skills própria e carregam quando sua solicitação diz respeito ao Aggrega.
Há duas formas de fornecê-la a um assistente. Um assistente que instala plugins a recebe como parte do plugin do Aggrega, que também conecta o assistente ao servidor MCP do Aggrega, em uma única etapa: veja Instalar o plugin. Qualquer assistente que lê skills de uma pasta pode ter a skill gravada ali pelo binário aggrega: veja Instalar apenas a skill.
Instalar o plugin
O repositório aggrega-ai/aggrega-skills contém a skill e também é um plugin para os assistentes abaixo. Instalar o plugin adiciona a skill do Aggrega e conecta o assistente ao servidor MCP do Aggrega, que o próprio assistente então inicia como aggrega mcp, então nem aggrega skills install nem as etapas de Conectar o servidor MCP são necessários para esse assistente.
O plugin não instala o binário aggrega. Instale-o primeiro, como descreve Instalar o binário, para que o assistente encontre aggrega no PATH quando iniciar o servidor.
Claude Code
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsDentro do Claude Code, o equivalente é /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.
Codex
codex plugin marketplace add aggrega-ai/aggrega-skillscodex plugin add aggrega@aggregaO primeiro comando adiciona o repositório como um marketplace de plugins chamado aggrega; o segundo instala a partir dele o plugin aggrega.
GitHub Copilot
No GitHub Copilot CLI:
copilot plugin marketplace add aggrega-ai/aggrega-skillscopilot plugin install aggrega@aggregaO Visual Studio Code com o GitHub Copilot encontra os plugins que o GitHub Copilot CLI instalou e também os usa. Para instalar o plugin pelo próprio Visual Studio Code, execute Chat: Install Plugin from Source na paleta de comandos e informe o endereço do repositório, https://github.com/aggrega-ai/aggrega-skills.
Gemini CLI
gemini extensions install https://github.com/aggrega-ai/aggrega-skillsO Gemini CLI instala o plugin como uma de suas extensões.
Antigravity
agy plugin install https://github.com/aggrega-ai/aggrega-skillsCursor
O Cursor carrega um plugin de uma pasta dentro de ~/.cursor/plugins/local/. Coloque o repositório ali e depois execute Developer: Reload Window na paleta de comandos:
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggregaKiro
O Kiro instala o plugin como um power. No painel Powers, escolha Add Custom Power, depois Import power from GitHub, digite o endereço do repositório, https://github.com/aggrega-ai/aggrega-skills, e escolha Install. O Kiro inicia e para o servidor MCP do plugin junto com o power.
OpenClaw
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skillsO OpenClaw pergunta duas vezes antes de instalar um plugin de uma origem que ele mesmo não revisou. Primeiro ele para e pede que você revise a origem e execute o comando novamente com --force; depois pede seu consentimento para o que o plugin traz — aqui, a skill e um servidor MCP — com --accept-capabilities. Depois de revisar o repositório, execute:
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities--force também substitui um plugin de mesmo nome que já esteja instalado, então verifique openclaw plugins list antes se você já instalou um chamado aggrega.
A pasta em que o servidor trabalha
As ferramentas do Aggrega trabalham em um workspace, e uma chamada que não indica nenhum é respondida no workspace que o servidor encontra a partir da pasta em que foi iniciado. Alguns assistentes iniciam o servidor de um plugin na própria pasta do plugin, e não no seu projeto — o Codex faz isso. A skill diz ao assistente para verificar em qual workspace o servidor responde, com a ferramenta config-show, antes de trabalhar em um projeto, e para informar a pasta do projeto como workspace_root em cada chamada que o aceita quando os dois forem diferentes — pelo caminho completo, porque um workspace_root relativo é lido a partir do workspace em que o servidor já responde.
Instalar apenas a skill
Para instalar a skill sem o plugin, use o binário aggrega, que grava a cópia embutida nele. Instale-a para os assistentes da sua máquina, em todos os seus projetos:
aggrega skills install --globalInstale-a para um assistente no projeto em que você está, informando o nome do assistente:
aggrega skills install --agent claude-codeListe os assistentes para os quais ela pode ser instalada, com a pasta que cada um lê:
aggrega skills listO comando de instalação também pode adicioná-la enquanto instala o binário: Adicionar a skill do assistente durante a instalação informa a opção. Instalada dessa forma, a skill vem sem a conexão com o servidor: conecte o assistente ao servidor como descreve Conectar o servidor MCP.
O que a skill diz ao seu assistente
A skill diz ao assistente como instalar o Aggrega, como conectá-lo ao servidor aggrega mcp, como iniciar um workspace e como executar o ciclo de criação — scaffold, validate, build — que Criar arquivos do Aggrega descreve. Ela não traz nenhuma cópia de nenhum schema ou contrato de entidade: encaminha o assistente ao binário para toda resposta estrutural — as ferramentas MCP onde o servidor está conectado, a linha de comando aggrega nos demais casos — e à documentação publicada para o significado das coisas.
A skill e o servidor MCP fazem trabalhos diferentes, e um assistente funciona melhor com os dois. A skill são instruções que o assistente lê; o servidor, que o plugin ou Conectar o servidor MCP conecta, são as ferramentas que ele chama. Um assistente que não instala nenhum plugin e não está na lista de --agent pula a skill e ainda assim alcança as mesmas ferramentas e o mesmo material de referência pelo servidor.
Onde ela é instalada
O plugin guarda a skill na pasta em que o assistente guarda seus plugins. aggrega skills install a grava em outro lugar: sem --global, na pasta de skills de projeto do assistente, na raiz do seu workspace, onde as skills do projeto são versionadas; com --global, na pasta de skills por usuário do assistente no seu diretório home, que o assistente lê em todos os projetos. Com --global e sem --agent, o comando procura os assistentes na sua máquina, exibe cada um que encontrou e o que o encontrou e, em um terminal, pergunta antes de gravar. aggrega skills informa as pastas de cada assistente, o que encontra cada um e o que o comando se recusa a sobrescrever.
Manter a skill atualizada
Uma skill que veio com o plugin é atualizada junto com o plugin, pela forma própria do assistente de atualizar seus plugins; um plugin clonado na pasta local do Cursor é atualizado com git pull nessa pasta, seguido de Developer: Reload Window. O plugin conecta o servidor que o binário aggrega do seu PATH executa, então as ferramentas e o material de referência acompanham o binário que você tem instalado.
A skill também é embutida no binário aggrega, então a cópia que aggrega skills install grava corresponde à versão que você tem instalada. Depois de atualizar o Aggrega — o comando do instalador atualiza o binário no lugar —, execute novamente o mesmo comando aggrega skills install para levar essa cópia à nova versão.