aggrega skills
Aggrega のスキルを AI アシスタントにインストールします
概要
aggrega skills説明
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.サブコマンド
| コマンド | 説明 |
|---|---|
aggrega skills install | AI アシスタントのスキルフォルダーに Aggrega スキルを書き込みます |
aggrega skills list | このバイナリが同梱するスキルと、それらをインストールできるアシスタントを一覧表示します |
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.aggrega skills install のフラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--agent | [] | スキルをインストールするアシスタントを識別子で指定します(例: claude-code、codex、cursor、gemini-cli)。繰り返し指定できます。ヘルプにはすべての識別子と、それぞれが書き込むフォルダーが表示されます。—global なしでは必須です。—global を指定してアシスタントを 1 つも指定しない場合は、このマシンで見つかったアシスタントにスキルがインストールされます。 |
--global | false | ワークスペースのルートにあるプロジェクトスキルフォルダーではなく、ホームディレクトリにある各アシスタントのユーザー単位のスキルフォルダーにインストールします。アシスタントはこのフォルダーをすべてのプロジェクトで読みます。 |
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.動作
aggrega skills install は、--agent で指定した各 AI アシスタントのスキルフォルダーに、または --global を指定して --agent を指定しない場合はこのマシンで見つかった各アシスタントのスキルフォルダーに、Aggrega スキルを書き込みます。スキルとは、オープンな Agent Skills 形式の SKILL.md ファイルを格納したフォルダーです。このファイルは、スキルの名前といつ使うかを示す短いフロントマターブロックと、それに続く指示で構成されます。スキルを読むアシスタントは、リクエストが一致したときにそれを読み込むため、Aggrega のインストール方法、aggrega mcp への接続方法、ワークスペースの始め方、そしてAggrega ファイルの作成で説明するオーサリングループの実行方法を把握できます。
スキルはスキーマやエンティティ契約のコピーを一切持ちません。アシスタントに対し、構造に関するすべての答えをバイナリに問い合わせるよう指示します(サーバーが接続されている場合は MCP ツール、そうでない場合は aggrega コマンドライン)。また、物事の意味については公開されているドキュメントを読むよう指示します。スキルはバイナリに組み込まれているため、書き込まれるコピーはインストールしているバージョンと一致します。
aggrega skills install --agent claude-codeInstalled the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggregaスキルの配置先
--global がない場合、スキルはワークスペースのルートにあるアシスタントのプロジェクトスキルフォルダーに置かれます。アシスタントはそこでプロジェクトのスキルを探し、スキルはそこでコミットされます。ワークスペースは、すべてのコマンドが見つけるものと同じです。つまり --workspace-root が指定するもの、またはコマンドを実行したディレクトリから見つかるものであり、サブフォルダーから実行してもルートにインストールされます。どのワークスペースにも示されていないディレクトリは、それ自体がルートになります。--global の場合は、ホームディレクトリにあるアシスタントのユーザー単位のスキルフォルダーに置かれ、アシスタントはこれをすべてのプロジェクトで読みます。上の説明にある表には、すべてのアシスタントについて両方のフォルダーが示されています。それぞれはそのアシスタント自身のドキュメントが示すフォルダーであり、~ はホームディレクトリを表します。
いくつかのアシスタントは共有の .agents/skills フォルダーを読みます。それらのうち複数を指定すると、スキルはそこに 1 回だけ書き込まれ、それを報告する 1 行にそのすべてのアシスタントが示されます:
aggrega skills install --agent codex --agent zed --globalInstalled the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggregaこのマシン上のアシスタント
--global を指定して --agent を指定しない場合、コマンドはこのマシンで見つかったアシスタントにスキルをインストールします。アシスタントは、そのアシスタント自身の設定フォルダーがホームディレクトリにある場合、またはそのコマンドが PATH 上にある場合に、見つかったとみなされます。上記の説明にある表の found by 列に、すべてのアシスタントについてその両方が示されています。フォルダーやコマンドは、そのアシスタントだけに属する場合にのみ使われるため、それが見つかっても別のアシスタントが見つかったことにはなりません。共有の .agents/skills フォルダーではどのアシスタントも見つからず、Gemini CLI と Antigravity の両方がファイルを置く .gemini ではそのどちらも見つかりません。Gemini CLI はその gemini コマンドによって見つかり、各 Antigravity 製品は .gemini の下にあるそれぞれ専用のフォルダーによって見つかります。設定がシステムの別の場所にあるアシスタントは、そのコマンドによって見つかるか、--agent で指定します。
コマンドは、見つかった各アシスタントと、それが何によって見つかったかを表示してから、インストールします:
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/aggregaターミナルでは最初に確認します。 見つかったものを示す行の後で、確認を求めます。Enter キーを押すとそれらのアシスタントにインストールし、ほかのアシスタントの識別子をスペースまたはカンマで区切って入力すると、それらを追加します。1 つも見つからなかった場合は、代わりに識別子の入力を求め、空の回答では何も書き込みません。標準入力がターミナルではない場合(スクリプト、ユーザーの代わりにコマンドを実行するアシスタント、またはそのためのアシスタント自身のツール)は、何も確認せず、見つかったアシスタントにインストールします。1 つも見つからず、1 つも指定されていない場合は、何も書き込まず、その旨を伝え、0 以外のコードで終了します。
--agent を 1 つでも指定すると検索は行われません。コマンドは指定したアシスタントにだけインストールし、それ以外にはインストールしません。--global を指定しないプロジェクトへのインストールでは、常にアシスタントを指定します。プロジェクトのメンバーが使うアシスタント向けのものであり、それはこのマシンからはわからないためです。
再インストールと拒否されるもの
コマンドが書き込むすべてのファイルには、フロントマターの直後に 1 行のコメントがあり、それが aggrega バイナリに組み込まれたスキルに由来すること、および再インストールすると置き換えられることを示しています。この行によって、コマンドは自身のコピーとユーザーのコピーを区別します:
- この行を持つコピーは置き換えられます。 Aggrega をアップグレードした後にコマンドを再度実行すると、スキルが新しいバージョンに更新され、出力される行には
InstalledではなくReplacedと表示されます。 - この行を持たないファイルは拒否されます。 書き込み先にすでにあり、コマンドが書き込んだものではない
SKILL.mdはユーザーのものであるため、コマンドはそのパスを示し、どこにも何も書き込まず、ゼロ以外の終了コードで終了します。そのファイルを別の場所に移動するか削除してから、コマンドを再度実行してください。独自の変更を残したい場合は、別の名前のスキルに保持してください。 - ワークスペースの外へ通じるリンクを経由して到達するフォルダーは拒否されます。
--globalがない場合、コマンドが書き込むすべてのフォルダーとファイルはワークスペース内に制約されます。アシスタントのスキルフォルダー、またはそこへ至る途中のフォルダーがワークスペースの外へ通じるリンクである場合、コマンドはそのリンクと行き先を示し、どこにも何も書き込まず、ゼロ以外の終了コードで終了します。これは A path the operation writes leads through a link out of the directory it must stay inside(操作が書き込むパスが、リンクを通じて、とどまるべきディレクトリの外へ通じています) で説明する条件です。ワークスペース内にとどまるリンクは、そのリンクを通じて書き込まれます。
何かを書き込む前にすべての書き込み先が確認されるため、あるアシスタントについて拒否された場合、他のすべてのアシスタントのフォルダーも元のまま残ります。スキルのフォルダー内にある、スキルが書き込まないファイルには手を触れません。
認識されないアシスタント
--agent は上の表にある識別子のみを受け付けます。各識別子は、オープンなスキル用コマンドラインツールが同じアシスタントに使う識別子です。それ以外の識別子は名前を示して拒否され、既知の識別子の一覧が表示されます。一覧にないアシスタントでも Aggrega を使用できます。MCP サーバーの接続の説明に従って MCP サーバーに接続すれば、スキルが示すのと同じツールとリファレンス資料にアクセスできます。
例
このプロジェクトで Claude Code 用にスキルをインストールします:
aggrega skills install --agent claude-codeすべてのプロジェクトで Gemini CLI と Cursor 用にインストールします:
aggrega skills install --agent gemini-cli --agent cursor --globalこのマシン上のアシスタント向けに、すべてのプロジェクトにインストールします:
aggrega skills install --globalインストール済みのコピーを、アップグレードしたばかりのバイナリに合わせて更新します:
aggrega skills install --agent claude-code認識しているものの一覧
aggrega skills list は、このバイナリに組み込まれたスキルを説明とともに出力し、続いて aggrega skills install が認識するすべてのアシスタントを、そのプロジェクトフォルダーとユーザー単位のフォルダーとともに出力します。何も書き込みません。
aggrega skills list