Skip to content

aggrega-ai/aggrega

unversioned · a80867a48ee9Apache-2.0

Gives your assistant the aggrega skill and the tools of the aggrega MCP server it connects; the aggrega binary must already be on your PATH.

Aggrega skills

Skills that teach an AI assistant to install and use Aggrega, the ahead-of-time compiler that turns declarative Aggregate, Component, Recipe, Manifest and Release files into provider-native artifacts. Each skill follows the open Agent Skills format, so any assistant that reads that format can load it.

SkillWhat it does
aggregaWork with Aggrega, the ahead-of-time compiler that turns declarative Aggregate, Component, Recipe, Manifest and Release files into provider-native artifacts for targets such as Helm, Docker Compose and Terraform. Use this skill when the user asks to install Aggrega, connect the aggrega MCP server, start or work in an Aggrega workspace, write or edit an Aggrega entity file, validate or build a Release, find a catalog entity, or understand an Aggrega error. It carries no schema of its own. It sends every structural question to the aggrega binary, through its MCP tools when they are connected and through the aggrega command line otherwise, and every conceptual question to the Aggrega documentation.

Install the plugin

This repository is also a plugin for the assistants that install plugins. Installing it adds the aggrega skill and connects the assistant to the aggrega MCP server, which the assistant starts as aggrega mcp. The plugin does not install the aggrega binary: install it first, as the install page describes, so the assistant finds aggrega on the PATH.

Claude Code:

claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills

Inside Claude Code, the same is /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.

Codex:

codex plugin marketplace add aggrega-ai/aggrega-skills
codex plugin add aggrega@aggrega

GitHub Copilot CLI:

copilot plugin marketplace add aggrega-ai/aggrega-skills
copilot plugin install aggrega@aggrega

Gemini CLI:

gemini extensions install https://github.com/aggrega-ai/aggrega-skills

Antigravity:

agy plugin install https://github.com/aggrega-ai/aggrega-skills

Cursor loads a plugin from a folder beneath ~/.cursor/plugins/local/. Put the repository there, then run Developer: Reload Window from the command palette:

git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega

Install a skill

To install the skill alone and connect the MCP server yourself, with the open skills command-line tool, from your project:

npx skills add aggrega-ai/aggrega-skills

With Aggrega itself, which writes the copy built into the binary you have installed, so the skill matches that version:

aggrega skills install --agent <assistant>

--agent takes an assistant's identifier and may be repeated; --global installs into the assistant's per-user skill folder instead of the current project's. The assistants it knows are:

--agentAssistantProject folderPer-user folder
ampAmp.agents/skills~/.config/amp/skills
antigravityAntigravity.agents/skills~/.gemini/config/skills
antigravity-cliAntigravity CLI.agents/skills~/.gemini/antigravity-cli/skills
claude-codeClaude Code.claude/skills~/.claude/skills
clineCline.cline/skills~/.cline/skills
codexCodex.agents/skills~/.agents/skills
cursorCursor.cursor/skills~/.cursor/skills
gemini-cliGemini CLI.gemini/skills~/.gemini/skills
github-copilotGitHub Copilot.github/skills~/.copilot/skills
gooseGoose.agents/skills~/.agents/skills
opencodeOpenCode.opencode/skills~/.config/opencode/skills
windsurfWindsurf.devin/skills~/.codeium/windsurf/skills
zedZed.agents/skills~/.agents/skills

An assistant that is not listed can still use Aggrega through its MCP server: connect it to aggrega mcp as the install page describes.

Where these files come from

Every file in this repository — the skills and the plugin manifests beside them — is generated from the source of the aggrega binary, aggrega-ai/aggrega-cli, and a tag here names the Aggrega release the files were generated from. A change to a skill or a manifest is made there; an edit made here is replaced the next time the files are generated.

License

The Aggrega skills and plugin are released under the Apache License, Version 2.0; the full text is in the LICENSE file.