A skill do Aggrega
A skill do Aggrega ensina um assistente de IA a instalar e utilizar o Aggrega. É uma pasta chamada aggrega que contém um ficheiro SKILL.md no formato aberto Agent Skills, que muitos assistentes leem a partir de uma pasta de skills própria e carregam quando o pedido diz respeito ao Aggrega.
Há duas formas de a disponibilizar a um assistente. Um assistente que instala plugins recebe-a como parte do plugin do Aggrega, que também liga o assistente ao servidor MCP do Aggrega, num único passo: consulte Instalar o plugin. Qualquer assistente que leia skills de uma pasta pode ter a skill escrita aí pelo binário aggrega: consulte 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. A instalação do plugin adiciona a skill do Aggrega e liga o assistente ao servidor MCP do Aggrega, que o próprio assistente inicia depois como aggrega mcp, pelo que nem aggrega skills install nem os passos de Ligar 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-skillsNo 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 utiliza. Para instalar o plugin a partir do próprio Visual Studio Code, execute Chat: Install Plugin from Source na paleta de comandos e indique 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 das suas extensões.
Antigravity
agy plugin install https://github.com/aggrega-ai/aggrega-skillsCursor
O Cursor carrega um plugin a partir de uma pasta dentro de ~/.cursor/plugins/local/. Coloque aí o repositório 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, introduza 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 juntamente 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 não reviu ele próprio. Primeiro, para e pede que se reveja a origem e se volte a executar o comando com --force; depois, pede consentimento para aquilo que o plugin traz — neste caso, a skill e um servidor MCP — com --accept-capabilities. Depois de rever o repositório, execute:
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities--force também substitui um plugin com o mesmo nome que já esteja instalado, pelo que convém verificar primeiro openclaw plugins list caso já tenha sido instalado antes um chamado aggrega.
A pasta em que o servidor trabalha
As ferramentas do Aggrega trabalham num workspace, e uma chamada que não indique 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 projeto — o Codex fá-lo. A skill indica ao assistente que verifique em que workspace o servidor responde, com a ferramenta config-show, antes de trabalhar num projeto, e que indique a pasta do projeto como workspace_root em cada chamada que o aceite, quando as duas 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, utilize o binário aggrega, que escreve a cópia nele incorporada. Instale-a para os assistentes do computador, em todos os projetos:
aggrega skills install --globalInstale-a para um assistente no projeto atual, indicando o assistente:
aggrega skills install --agent claude-codeListe os assistentes para os quais pode ser instalada, com a pasta que cada um lê:
aggrega skills listO comando de instalação também a pode adicionar, enquanto instala o binário: Adicionar a skill do assistente durante a instalação indica a opção. Instalada desta forma, a skill vem sem a ligação ao servidor: ligue o assistente ao servidor como descreve Ligar o servidor MCP.
O que a skill diz ao assistente
A skill indica ao assistente como instalar o Aggrega, como o ligar ao servidor aggrega mcp, como iniciar um workspace e como executar o ciclo de criação — scaffold, validate, build — que Criar ficheiros do Aggrega descreve. Não contém nenhuma cópia de qualquer schema ou contrato de entidade: remete o assistente para o binário em cada resposta estrutural — as ferramentas MCP onde o servidor está ligado, a linha de comandos aggrega nos restantes casos — e para a documentação publicada quanto ao significado das coisas.
A skill e o servidor MCP fazem trabalhos diferentes, e um assistente funciona melhor com ambos. A skill são instruções que o assistente lê; o servidor, que o plugin ou Ligar o servidor MCP liga, são as ferramentas que chama. Um assistente que não instala nenhum plugin e não está na lista de --agent dispensa a skill e chega, mesmo assim, às mesmas ferramentas e ao mesmo material de referência através do servidor.
Onde é instalada
O plugin guarda a skill na pasta em que o assistente guarda os seus plugins. aggrega skills install escreve-a noutro local: sem --global, na pasta de skills de projeto do assistente, na raiz do workspace, onde se faz commit das skills do projeto; com --global, na pasta de skills por utilizador do assistente, no diretório pessoal, que o assistente lê em todos os projetos. Com --global e sem --agent, o comando procura os assistentes no computador, imprime cada um dos que encontrou e o que o encontrou e, num terminal, pede confirmação antes de escrever. aggrega skills indica as pastas de cada assistente, o que encontra cada um e o que o comando se recusa a substituir.
Manter a skill atualizada
Uma skill que veio com o plugin é atualizada com o plugin, através da forma própria do assistente de atualizar os seus plugins; um plugin clonado na pasta local do Cursor é atualizado com git pull nessa pasta, seguido de Developer: Reload Window. O plugin liga o servidor que o binário aggrega do PATH executa, pelo que as ferramentas e o material de referência acompanham o binário instalado.
A skill também está incorporada no binário aggrega, pelo que a cópia que aggrega skills install escreve corresponde à versão instalada. Depois de atualizar o Aggrega — o comando do instalador atualiza o binário no próprio local —, volte a executar o mesmo comando aggrega skills install para levar essa cópia à nova versão.