コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

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 skill
tells an assistant how to install Aggrega, how to connect it to the aggrega MCP
server, 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 to
this binary for every structural question and to the published documentation
for every conceptual one.
The skill is built into this binary, so the copy it installs matches the
version you have.

サブコマンド

コマンド説明
aggrega skills installAI アシスタントのスキルフォルダーに 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 root
of your workspace — the one found from the directory you run the command in, or
named 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 goes
into 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, and
nothing is written.
--agent may be given more than once. Where several of the named assistants read
the same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants found
on this machine: each one whose configuration folder is in your home directory
or whose command is on your PATH, as the table below names them. The command
prints each assistant it found and what found it. At a terminal it then asks
before writing: press Enter to install for those, or type the identifiers of
other assistants to add them. Where standard input is not a terminal it
installs for the assistants found without asking. Where it finds none and is
given none, it writes nothing and says so. A project installation is for the
assistants a project's people use rather than those on one machine, so it
always names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every file
written carries a comment line saying where it comes from. Running the command
again replaces a copy carrying that line, which is how a newer aggrega brings
the skill up to its own version. A file at the target that does not carry it
was not written by this command, so the command refuses, names the file and
writes nothing; move it aside or remove it, then run the command again. Every
target is checked before anything is written, so a refusal leaves every folder
as it was.
The assistants it installs for, the folders each one reads, and what finds each
on this machine — its configuration folder in your home directory, or its
command 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 Aggrega
through its MCP server: connect it to "aggrega mcp" as
https://aggrega.ai/docs/install/ describes.

aggrega skills install のフラグ

フラグデフォルト説明
--agent[]スキルをインストールするアシスタントを識別子で指定します(例: claude-code、codex、cursor、gemini-cli)。繰り返し指定できます。ヘルプにはすべての識別子と、それぞれが書き込むフォルダーが表示されます。—global なしでは必須です。—global を指定してアシスタントを 1 つも指定しない場合は、このマシンで見つかったアシスタントにスキルがインストールされます。
--globalfalseワークスペースのルートにあるプロジェクトスキルフォルダーではなく、ホームディレクトリにある各アシスタントのユーザー単位のスキルフォルダーにインストールします。アシスタントはこのフォルダーをすべてのプロジェクトで読みます。

aggrega skills list の説明

List the skills built into this binary, and the assistants "aggrega skills
install" can write them for, with the project folder and the per-user folder
each 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 コマンドライン)。また、物事の意味については公開されているドキュメントを読むよう指示します。スキルはバイナリに組み込まれているため、書き込まれるコピーはインストールしているバージョンと一致します。

Terminal window
aggrega skills install --agent claude-code
Installed the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggrega

スキルの配置先

--global がない場合、スキルはワークスペースのルートにあるアシスタントのプロジェクトスキルフォルダーに置かれます。アシスタントはそこでプロジェクトのスキルを探し、スキルはそこでコミットされます。ワークスペースは、すべてのコマンドが見つけるものと同じです。つまり --workspace-root が指定するもの、またはコマンドを実行したディレクトリから見つかるものであり、サブフォルダーから実行してもルートにインストールされます。どのワークスペースにも示されていないディレクトリは、それ自体がルートになります。--global の場合は、ホームディレクトリにあるアシスタントのユーザー単位のスキルフォルダーに置かれ、アシスタントはこれをすべてのプロジェクトで読みます。上の説明にある表には、すべてのアシスタントについて両方のフォルダーが示されています。それぞれはそのアシスタント自身のドキュメントが示すフォルダーであり、~ はホームディレクトリを表します。

いくつかのアシスタントは共有の .agents/skills フォルダーを読みます。それらのうち複数を指定すると、スキルはそこに 1 回だけ書き込まれ、それを報告する 1 行にそのすべてのアシスタントが示されます:

Terminal window
aggrega skills install --agent codex --agent zed --global
Installed 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 で指定します。

コマンドは、見つかった各アシスタントと、それが何によって見つかったかを表示してから、インストールします:

Terminal window
aggrega skills install --global
Found Claude Code (claude-code), from the folder /home/you/.claude
Found Codex (codex), from the command /usr/local/bin/codex
Installed the aggrega skill for Claude Code at /home/you/.claude/skills/aggrega
Installed 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 用にスキルをインストールします:

Terminal window
aggrega skills install --agent claude-code

すべてのプロジェクトで Gemini CLI と Cursor 用にインストールします:

Terminal window
aggrega skills install --agent gemini-cli --agent cursor --global

このマシン上のアシスタント向けに、すべてのプロジェクトにインストールします:

Terminal window
aggrega skills install --global

インストール済みのコピーを、アップグレードしたばかりのバイナリに合わせて更新します:

Terminal window
aggrega skills install --agent claude-code

認識しているものの一覧

aggrega skills list は、このバイナリに組み込まれたスキルを説明とともに出力し、続いて aggrega skills install が認識するすべてのアシスタントを、そのプロジェクトフォルダーとユーザー単位のフォルダーとともに出力します。何も書き込みません。

Terminal window
aggrega skills list