aggrega skills
Instalar la skill de Aggrega en un asistente de IA
Sinopsis
aggrega skillsDescripción
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 | Descripción |
|---|---|
aggrega skills install | Escribe la skill de Aggrega en la carpeta de skills de un asistente de IA |
aggrega skills list | Enumera las skills que incluye este binario y los asistentes para los que puede instalarlas |
Descripción 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 | Predeterminado | Descripción |
|---|---|---|
--agent | [] | Asistente para el que instalar la skill, por identificador (por ejemplo claude-code, codex, cursor o gemini-cli). Repetible; la ayuda enumera cada identificador y la carpeta en la que escribe cada uno. Obligatorio sin —global; con —global y sin ninguno indicado, la skill se instala para los asistentes encontrados en esta máquina. |
--global | false | Instala en la carpeta de skills por usuario de cada asistente, en tu directorio personal, que el asistente lee en todos los proyectos, en lugar de en la carpeta de skills del proyecto en la raíz de tu espacio de trabajo. |
Descripción 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.Qué hace
aggrega skills install escribe la skill de Aggrega en la carpeta de skills de cada asistente de IA que nombras con --agent o, con --global y sin --agent, de cada uno que encuentra en esta máquina. Una skill es una carpeta que contiene un archivo SKILL.md en el formato abierto Agent Skills: un breve bloque de frontmatter que nombra la skill y dice cuándo usarla, seguido de instrucciones. Un asistente que lee skills la carga cuando tu petición coincide, de modo que sabe cómo instalar Aggrega, cómo conectarse a aggrega mcp, cómo iniciar un workspace y cómo seguir el ciclo de autoría descrito en Escribir archivos de Aggrega.
La skill no lleva ninguna copia de ningún esquema ni contrato de entidad. Indica al asistente que pida al binario cada respuesta estructural — las herramientas MCP donde el servidor está conectado y, si no, la línea de comandos aggrega — y que lea la documentación publicada para saber qué significan las cosas. La skill está integrada en el binario, así que la copia que escribe coincide con la versión que tienes instalada.
aggrega skills install --agent claude-codeInstalled the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggregaDónde se coloca la skill
Sin --global, la skill va a la carpeta de skills del proyecto del asistente en la raíz de tu espacio de trabajo, donde el asistente busca las skills del proyecto y donde tú las confirmas. El espacio de trabajo es el que encuentra cada comando — el que nombra --workspace-root, o el que se encuentra a partir del directorio en el que ejecutas el comando, de modo que ejecutarlo desde una subcarpeta instala igualmente en la raíz — y un directorio que ningún espacio de trabajo marca es su propia raíz. Con --global, va a la carpeta de skills por usuario del asistente en tu directorio personal, que el asistente lee en todos los proyectos. La tabla de la descripción anterior da ambas carpetas para cada asistente; cada una es la carpeta que nombra la propia documentación de ese asistente, y ~ representa tu directorio personal.
Varios asistentes leen la carpeta compartida .agents/skills. Nombrar más de uno de ellos escribe la skill allí una sola vez y los nombra a todos en la única línea que lo notifica:
aggrega skills install --agent codex --agent zed --globalInstalled the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggregaLos asistentes de esta máquina
Con --global y sin --agent, el comando instala la skill para los asistentes que encuentra en esta máquina. Un asistente se considera encontrado cuando su propia carpeta de configuración está en tu directorio personal, o su comando está en tu PATH; la columna found by de la tabla de la descripción anterior indica ambos para cada asistente. Una carpeta o un comando solo se usa donde pertenece únicamente a ese asistente, de modo que encontrarlo nunca vale por otro: la carpeta compartida .agents/skills no encuentra a nadie, y .gemini, donde Gemini CLI y Antigravity guardan archivos, no encuentra a ninguno de los dos; Gemini CLI se encuentra por su comando gemini, y cada producto Antigravity por su propia carpeta bajo .gemini. Un asistente cuya configuración está en otro lugar de tu sistema se encuentra por su comando, o se nombra con --agent.
El comando imprime cada asistente que encontró y lo que lo encontró, y luego 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/aggregaEn una terminal, primero pregunta. Tras las líneas que nombran lo que encontró, te pide que confirmes: pulsa Intro para instalar para esos, o escribe los identificadores de otros asistentes, separados por espacios o comas, para añadirlos. Si no encontró ninguno, pide en su lugar los identificadores, y una respuesta vacía no escribe nada. Cuando la entrada estándar no es una terminal —un script, un asistente que ejecuta el comando por ti o la propia herramienta del asistente para ello—, no pregunta nada e instala para los asistentes que encontró. Si no encuentra ninguno y no se le indica ninguno, no escribe nada, lo informa y termina con un código distinto de cero.
Nombrar cualquier --agent omite la búsqueda: el comando instala para los asistentes que nombraste y para ningún otro. Una instalación de proyecto, sin --global, siempre los nombra: es para los asistentes que usan las personas del proyecto, algo que esta máquina no indica.
Instalar de nuevo, y lo que rechaza
Cada archivo que escribe el comando lleva una línea de comentario, justo después del frontmatter, que dice que procede de la skill integrada en el binario aggrega y que instalar de nuevo lo sustituye. Esa línea es la forma en que el comando distingue su propia copia de la tuya:
- Una copia que lleva la línea se sustituye. Ejecutar de nuevo el comando después de actualizar Aggrega lleva la skill a la nueva versión, y la línea que imprime dice
Replaceden lugar deInstalled. - Un archivo sin la línea se rechaza. Un
SKILL.mdque ya está en el destino y que el comando no escribió es tuyo, así que el comando nombra su ruta, no escribe nada en ninguna parte y sale con un código distinto de cero. Aparta el archivo o elimínalo y luego vuelve a ejecutar el comando. Para conservar cambios propios, guárdalos en una skill con otro nombre. - Se rechaza una carpeta a la que se llega mediante un enlace que sale del espacio de trabajo. Sin
--global, cada carpeta y cada archivo que escribiría el comando se ciñen al espacio de trabajo: cuando la carpeta de skills de un asistente, o una carpeta en el camino hacia ella, es un enlace que sale del espacio de trabajo, el comando nombra el enlace y adónde lleva, no escribe nada en ninguna parte y sale con un código distinto de cero — la condición descrita en A path the operation writes leads through a link out of the directory it must stay inside (Una ruta que escribe la operación sale, a través de un enlace, del directorio dentro del cual debe permanecer). Un enlace que permanece dentro del espacio de trabajo se sigue al escribir.
Cada destino se comprueba antes de escribir nada, de modo que un rechazo para un asistente deja también la carpeta de cualquier otro asistente tal como estaba. Los archivos de la carpeta de la skill que la skill no escribe se dejan como están.
Asistentes que no conoce
--agent solo acepta los identificadores de la tabla anterior, cada uno de ellos el identificador que usa la herramienta abierta de línea de comandos para skills para el mismo asistente. Cualquier otro identificador se rechaza por su nombre, con la lista de los que conoce. Un asistente que no figura en la lista puede usar Aggrega igualmente: conéctalo al servidor MCP como describe Conectar el servidor MCP, y llegará a las mismas herramientas y al mismo material de referencia a los que remite la skill.
Ejemplos
Instala la skill para Claude Code en este proyecto:
aggrega skills install --agent claude-codeInstálala para Gemini CLI y Cursor en todos tus proyectos:
aggrega skills install --agent gemini-cli --agent cursor --globalInstálala en todos tus proyectos para los asistentes de esta máquina:
aggrega skills install --globalPon una copia instalada al nivel del binario al que acabas de actualizar:
aggrega skills install --agent claude-codeEnumerar lo que conoce
aggrega skills list imprime las skills integradas en este binario con sus descripciones y, a continuación, cada asistente que conoce aggrega skills install, con su carpeta de proyecto y su carpeta por usuario. No escribe nada.
aggrega skills list