/plugin

sidebar_position: 4

plugin

対応ツール全体で完全な native plugin を管理します。Capability チェックは、インストール対応とフォーマット検出を区別します。まずは [Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) から始めてください。

skillshare plugin                         # インタラクティブマネージャー
skillshare plugin add                     # Source → plugin → targets → review
skillshare plugin discover ./my-plugin --json
skillshare plugin add ./my-plugin --target claude --target codex --no-tui
skillshare plugin add ./my-plugin --no-tui   # Skillshare で管理だけして、target は後で選ぶ
skillshare plugin import review@team --from claude --no-tui
skillshare plugin list --json
skillshare plugin inspect review --json
skillshare plugin disable review --target codex --no-tui
skillshare sync plugins --dry-run --json
skillshare sync plugins --no-tui
skillshare plugin enable review --target codex --no-tui
skillshare plugin check review --json
skillshare plugin update review --target claude --no-tui
skillshare plugin remove review --no-tui

`enable` と `disable` は **Skillshare の sync 選択**を変更するものであり、Agent 側のネイティブな enabled 状態を変更するものではありません。Target の選択を外すとその選択が保存されます。次の `sync plugins` で、定義自体は残したままその管理下インストールが削除されます。再び選択すると、次の sync で再インストールできるようになります。管理外の plugin には影響しません。

`--target` なしの `add`（またはインタラクティブな選択で何も選ばない場合）は、plugin をどこにもインストールせずに Skillshare で管理します。後から同じ source と `--name` で target を追加するか、dashboard でその plugin の行から選べます。その時点の source がインストールされます。このような plugin は最後の target を外しても管理下に残ります。`--target` なしの `remove NAME` で Skillshare から削除します。

コマンド

| コマンド | 動作 | |---|---| | `list` | 設定済みのバインディングとネイティブインストール状態。ターミナルではインタラクティブマネージャー | | `discover SOURCE` | ローカルディレクトリ、`owner/repo`、または HTTPS Git リポジトリを検査 | | `add [SOURCE]` | plugin 全体とその target アダプタを選択してインストール | | `import [NATIVE-ID]` | 再インストールや有効化を行わずに既存のインストールを取り込む | | `inspect NAME` | 管理下の 1 つの package を検査 | | `sync [NAME]` | 選択済みの target を整合させ、未完了のネイティブ操作を再試行 | | `check [NAME]` | Source の内容を記録済みのダイジェストと比較。更新は行わない | | `update [NAME]` | Source の変更を確認し、対応するネイティブ更新操作を使用 | | `enable / disable [NAME]` | 次の sync に target を含める / 除外する | | `remove [NAME]` | 管理下のバインディングをアンインストールし、その定義を削除 |

引数なしのコマンドはターミナルで不足している入力をプロンプトします。非インタラクティブな変更コマンドには明示的な入力が必要です。`sync` と `check` はすべての package を対象に動作できます。`sync --all` は plugin を含み**ません** — `sync plugins` を明示的に使ってください。

オプション

| オプション | 意味 | |---|---| | `--target TARGET` | 繰り返し指定可能な選択: `claude`、`codex`、`cursor`、`antigravity`（エイリアス `agy`）、`antigravity-cli`、`copilot`、`grok`、`pi`、`opencode`、または [Agent の別のアカウント](#accounts)の名前。下の capability 表を参照 | | `--plugin NAME` | source のマーケットプレイスから 1 つの plugin を選択 | | `--name NAME` | 追加またはインポート時の論理的な package 名 | | `--from TARGET` | Claude、Codex、Antigravity CLI、Copilot、Grok、Pi、OpenCode、または [Agent の別のアカウント](#accounts)からインポート | | `--dry-run`, `-n` | Skillshare または Agent の設定を変更せずにプレビュー | | `--source-ref REF` | `discover`、`add`、`update` 用の git ブランチ、タグ、またはコミット。リモート source のみ | | `--entry PATH` | package ルートからの相対パスで明示的にビルド済みの OpenCode JS/TS エントリを指定（`discover` と `add`） | | `--revision ID` | プレビュー以降に source、設定、またはネイティブインベントリが変わっていた場合に適用を拒否 | | `--json` | 機械可読な出力。TUI を無効化 | | `--no-tui` | インタラクティブメニューを無効化。`tui: false` でも同様 | | `--global`, `-g` | global Skillshare config とネイティブユーザースコープ | | `--project`, `-p` | project config。Claude、Antigravity、Pi、または OpenCode（global へのフォールバックはなし） |

JSON 出力には source パスとネイティブ識別子が含まれます。source URL に認証情報を含めないでください。ある変更操作が失敗しても、target 単位では成功した結果が返る場合があります。いずれかの target が失敗すると CLI は非ゼロ終了コードを返します。再試行する前に結果を確認してください。

Target 対応表

| Target | フォーマット | Global | Project | Update | |---|---|:---:|:---:|---| | Claude Code | `.claude-plugin/plugin.json` | Yes | Yes | ネイティブ update | | Codex | `.codex-plugin/plugin.json` または Agent Plugins ルートマニフェスト | Yes | No | 未対応 | | Cursor | `.cursor-plugin/plugin.json` または Agent Plugins ルートマニフェスト | Yes | No | reviewed されたローカルコピーを置き換え | | Antigravity Desktop | 明示的な name を持つルート `plugin.json` | Yes | Yes | reviewed されたローカルコピーを置き換え | | Pi | `pi` resources を持つ `package.json`、または `pi-package` キーワードと慣例的な resource フォルダ | Yes | Yes（ネイティブな project trust が必要） | 管理下 source スナップショットを更新 | | OpenCode | SDK 依存を持つ `package.json`、`.opencode/plugins/` エントリ、または明示的な `--entry` | Yes | Yes | 管理下 source スナップショットを更新 |

| Antigravity CLI | `agy` に受け入れられるネイティブルートマニフェストまたは Claude マニフェスト | Yes | No | enable 状態を保持しつつネイティブに update | | GitHub Copilot CLI | `.plugin/plugin.json`、`.github/plugin/plugin.json`、Claude マニフェスト、または Agent Plugins ルートマニフェスト | Yes | No | reviewed された source を更新（ネイティブな enabled 状態がわかっており enabled の場合のみ） | | Grok Build | `.grok-plugin/plugin.json` または Claude マニフェスト | インポート/削除のみ。インストールにはネイティブな trust が必要 | No | ネイティブに update | | Kimi Code | `kimi.plugin.json` または `.kimi-plugin/plugin.json` | 検出のみ | No | 自動化されていない | | Hermes | `.hermes-plugin/plugin.yaml` | 検出のみ | No | 自動化されていない | | Devin | `.devin-plugin/plugin.json` | 検出のみ | No | 自動化されていない |

Kimi の非インタラクティブなライフサイクル、Hermes のプロファイルインベントリ/同意、Devin のローカルインベントリ/trust/クラウド区別は、これらのアダプタではまだ検証されていません。フォーマットは discovery 中に表示されますが、インストールは理由付きで無効化されています。source が target を宣言していても、Skillshare がそれを管理できることを意味しません。 `list --json` と `discover --json` には、許可された操作を含む `targetDefinitions` が含まれます。discovery ではさらに、各フォーマットの version、コンポーネント、entry、検証上の問題を示す `targetInfo` も公開されます。壊れたマニフェストはその target に限定され、不正なカタログは有効なフォーマットを隠すことなく警告として報告されます。

Agent の別のアカウント {#accounts}

[Agent の別のアカウント](/docs/reference/targets/configuration#agent-config-dir)として宣言された Target は、`claude`、`codex`、`pi` については plugin の Target でもあります。Skillshare は `CLAUDE_CONFIG_DIR`、`CODEX_HOME`、`PI_CODING_AGENT_DIR` を通じて、そのアカウントの config ディレクトリに対して Agent 自身の CLI を実行します。

targets:
  claude-work:
    agent: claude
    config_dir: ~/.claude-work

skillshare plugin add owner/repo --target claude-work
skillshare plugin import demo@market --from claude-work

アカウントは、所属する Agent の操作をそのまま引き継ぎ、自分の名前で独自のバインディングを保持します。そのため、一方のアカウントにだけ plugin をインストールすることもできます。アカウントは global スコープにのみ存在します。project の plugin は、1 つのアカウントではなく project に属します。`--target` と `--from` はアカウント名を受け付け、ターミナルのピッカーとダッシュボードの Plugins ページでは Agent と並んで一覧