OMMX のエージェントプラグインとスキルを取得・導入する

OMMX のエージェントプラグインとスキルを取得・導入する#

注釈

現在同梱されている OMMX スキルはモックで、OMMX の利用方法を説明する本文は 含まれていません。

インストールした OMMX に付属するプラグインやスキルを取得し、 コーディングエージェントに導入します。まず OMMX CLI のインストールと実行 に従って、ommx コマンドを利用できる 状態にしてください。以下では Python パッケージに付属する CLI を uv run で 実行します。cargo-binstall で単体の実行ファイルをインストールした場合は、 uv run ommx を ommx に置き換えます。

以下のシェル例は POSIX 系シェルを想定しています。

プラグイン・マーケットプレイス・スキルのパスを取得する#

uv run ommx plugin path
uv run ommx plugin marketplace path
uv run ommx skill path

いずれも絶対ディレクトリパスを標準出力に 1 行で表示します。

コマンド

ディレクトリの内容

plugin path

plugin.json、.claude-plugin/plugin.json、skills/

plugin marketplace path

.claude-plugin/marketplace.json、plugins/ommx/

skill path

ommx/SKILL.md

プラグイン名・スキル名は省略可能な位置引数です。

uv run ommx plugin path ommx
uv run ommx skill path ommx

plugin path ommx は plugin path と同じプラグインを返します。 skill path ommx は親ディレクトリではなく個別のスキルディレクトリを返します。 同梱名は ommx です。

プロジェクトへのプラグイン導入#

同梱内容には Agent Plugins 1.0 の manifest と Claude Code 用メタデータが含まれます。Claude Code のローカルマーケットプレイス 経由で local スコープに導入するには、次のように実行します。

claude plugin marketplace add --scope local "$(uv run ommx plugin marketplace path)"
claude plugin install --scope local ommx@ommx

local スコープでは、端末固有のマーケットプレイスのパスとプラグインの有効化設定を .claude/settings.local.json に保存し、このプロジェクトで自分だけが利用します。

Claude Code の 1 セッションだけで使う場合は、起動時にプラグインのパスを指定します。

claude --plugin-dir "$(uv run ommx plugin path)"

Cursor CLI でも、1 セッションの起動時にプラグインを指定できます。

agent --plugin-dir "$(uv run ommx plugin path)"

新しいセッションで、設定したプラグインから OMMX スキルが検出されることを確認します。 Claude Code では /ommx:ommx という名前になります。マーケットプレイスの形式と 導入時の動作は Claude Code のドキュメント を参照してください。

スキル単体の導入#

.agents/skills を検出するエージェントでは、プロジェクトのルートでリンクを作成します。

mkdir -p .agents/skills
ln -s "$(uv run ommx skill path ommx)" .agents/skills/ommx

新しいセッションを開始し、ommx がスキル一覧に表示され、読み込み元がこのプロジェクトの SKILL.md であることを確認します。スキルディレクトリ全体をコピーすることもできます。

mkdir -p .agents/skills
cp -R "$(uv run ommx skill path ommx)" .agents/skills/ommx

既存の .agents/skills/ommx ディレクトリがない状態で実行してください。 親ディレクトリを受け取るスキルマネージャーには skill path の出力を渡せます。 例えば次のように実行します。

gh skill install "$(uv run ommx skill path)" ommx --from-local --scope project

選択を求められたら利用するエージェントを選び、新しいセッションでプロジェクトスコープと 読み込み元のパスを確認します。環境固有のリンクやコピーには、.gitignore に .agents/skills/ommx を追加してください。チームでコピーを Git 共有する場合は OMMX 依存バージョンと合わせて更新します。

バージョン・キャッシュ・更新#

プラグインの manifest は、Python 経由で起動した場合も、ommx --version で表示される Rust CLI と同じバージョンになります。OMMX の Rust SDK と Python SDK のバージョンは 独立して管理されています。

OMMX は bundle 全体を Rust 実行ファイルと Python wheel に埋め込みます。パス取得 コマンドは、manifest のバージョンを含む全ファイルの内容から識別したサブディレクトリへ、 OS の OMMX キャッシュ内に展開します。ソースのチェックアウトやネットワークアクセスは 不要で、Artifact の Local Registry も開きません。配置先を選ぶ場合は OMMX_PLUGIN_CACHE_DIR に、改行を含まない UTF-8 のパスで書き込み可能なディレクトリを 指定します。キャッシュ内のファイルは生成物であり、ファイルの削除や内容の変更は 次の実行時に復元されます。

OMMX を更新したらパスを再取得します。リンク先が変わった場合はシンボリックリンクを 作り直し、コピーの場合はスキルディレクトリ全体を置き換えてください。Claude Code の ローカルマーケットプレイスでは、local スコープの登録を解除して新しいパスを登録し、 プラグインを再インストールします。Rust CLI のバージョンが変わらない場合も、この手順で 新しい内容を取り込めます。

claude plugin marketplace remove --scope local ommx
claude plugin marketplace add --scope local "$(uv run ommx plugin marketplace path)"
claude plugin install --scope local ommx@ommx

--plugin-dir の場合は新しいパスでセッションを起動します。エージェントが更新後の スキルを読み込んでいることを確認します。キャッシュを削除した場合は、リンクや マーケットプレイス設定を使う前にパス取得コマンドを再実行して bundle を復元してください。

目次