plugin-store

事前依存関係の確認（Plugin Store CI によって自動挿入）

初回使用前に、セッションごとに一度実行してください。これらのチェックにより、必要なツールがインストールされていることを確認します。

onchainos CLI と Skills のインストール（自動挿入）

# 1. Install onchainos CLI — pin to latest release tag, verify SHA256
#    of the installer before executing (no curl|sh from main).
if ! command -v onchainos >/dev/null 2>&1; then
  set -e
  LATEST_TAG=$(curl -sSL --max-time 5 \
    "https://api.github.com/repos/okx/onchainos-skills/releases/latest" \
    | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
  if [ -z "$LATEST_TAG" ]; then
    echo "ERROR: failed to resolve latest onchainos release tag (network or rate limit)." >&2
    echo "       Manual install: https://github.com/okx/onchainos-skills" >&2
    exit 1
  fi

  ONCHAINOS_TMP=$(mktemp -d)
  curl -sSL --max-time 30 \
    "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" \
    -o "$ONCHAINOS_TMP/install.sh"
  curl -sSL --max-time 30 \
    "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" \
    -o "$ONCHAINOS_TMP/installer-checksums.txt"

  EXPECTED=$(awk '$2 ~ /install\.sh$/ {print $1; exit}' "$ONCHAINOS_TMP/installer-checksums.txt")
  if command -v sha256sum >/dev/null 2>&1; then
    ACTUAL=$(sha256sum "$ONCHAINOS_TMP/install.sh" | awk '{print $1}')
  else
    ACTUAL=$(shasum -a 256 "$ONCHAINOS_TMP/install.sh" | awk '{print $1}')
  fi
  if [ -z "$EXPECTED" ] || [ "$EXPECTED" != "$ACTUAL" ]; then
    echo "ERROR: onchainos installer SHA256 mismatch — refusing to execute." >&2
    echo "       expected=$EXPECTED  actual=$ACTUAL  tag=$LATEST_TAG" >&2
    rm -rf "$ONCHAINOS_TMP"
    exit 1
  fi

  sh "$ONCHAINOS_TMP/install.sh"
  rm -rf "$ONCHAINOS_TMP"
  set +e
fi

# 2. Install onchainos skills (enables AI agent to use onchainos commands)
npx skills add okx/onchainos-skills --yes --global

# 3. Install plugin-store skills (enables plugin discovery and management)
npx skills add okx/plugin-store --skill plugin-store --yes --global

---

Plugin Store

Claude Code、Cursor、OpenClaw 間で Skills と MCP サーバーをインストール、アンインストール、更新するための CLI マーケットプレイスです。また、あらゆる開発者がプラグインを投稿できるオープンソースのコミュニティプラットフォームでもあります。

事前チェック

最初の plugin-store コマンドを実行する前に、セッションごとに一度実行してください。定型的な出力をユーザーに表示しないでください。

1. バイナリのバージョンを確認

plugin-store --version 2>/dev/null || ~/.local/bin/plugin-store --version 2>/dev/null || ~/.cargo/bin/plugin-store --version 2>/dev/null

• 表示されたバージョンが ≥ 0.3.0（このスキルの metadata.version）の場合：バイナリは最新です。ステップ 2 に進んでください。
• バイナリが 存在しない、または古い 場合：インストーラーを実行してください。

手動インストール —
https://github.com/okx/plugin-store/releases にアクセスし、お使いのプラットフォーム用のバイナリをダウンロードしてください。同じリリースの checksums.txt と照合して検証し、PATH 上に配置してください（例：~/.local/bin/plugin-store）。

オフライン時の代替手段： ローカルにバイナリがすでに存在する場合は、それを使用してください。インストールされておらず、ネットワークに接続できない場合は処理を停止し、接続を確認するようユーザーに依頼してください。

2. Skill の更新を確認（リモートバージョンの確認）

GitHub から最新の Skill バージョンを取得します（タイムアウト 5 秒、ノンブロッキング）：

curl -sSL --max-time 5 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/plugin-store/SKILL.md" 2>/dev/null | head -20 | grep 'version:' | head -1

リモートの metadata.version とローカルバージョン（0.3.0）を比較してください。

リモートバージョンがローカルより新しい場合、次の通知をユーザーに表示してください。

📦 Plugin Store Skill の新しいバージョンが利用できます（現在: 0.3.0、最新: X.Y.Z）

更新しますか？更新コマンド：

plugin-store install plugin-store --agent claude-code --skill-only

⚠️ 注意：更新後、新しい Skill をコンテキストに反映するには現在のセッションを再起動する必要があります。

その後、ユーザーの応答を待ってください：

• ユーザーが「はい」／「確認」／「更新」と答えた場合 → インストールコマンドを実行し、次のように伝えてください：「Skill が更新されました。新しいバージョンを読み込むには、現在のセッションを再起動（終了して再度開始）してください。」
• ユーザーが「いいえ」／「スキップ」／「後で」と答えた場合 → 現在のバージョンで続行し、このセッション中に再度確認しないでください。
• curl が失敗またはタイムアウトした場合 → 何も表示せず、現在のバージョンで続行してください。

バージョンが一致する場合、またはリモートに接続できない場合は、何も表示せずにスキップしてください。

3. コマンド失敗時に自動再インストールしない

エラーを報告し、plugin-store self-update の実行、または https://github.com/okx/plugin-store の確認を提案してください。

4. onchainos-skills をインストール（サイレント、ノンブロッキング）

npx skills add okx/onchainos-skills --yes 2>/dev/null || true

これは、Skill Routing が使用するサブスキル（okx-dex-token、okx-dex-swap など）をインストールします。失敗しても処理を妨げないでください。

---

利用可能なプラグイン

必ず plugin-store list を実行して現在のプラグイン一覧を取得してください。ハードコードされた表を参照しないでください。

plugin-store list

出力を解析し、見やすい表（名前、カテゴリ、ダウンロード数、説明）にしてユーザーに提示してください。レジストリは動的に更新されるため、これが唯一の信頼できる情報源です。

---

スキルの振り分け

ユーザーの意図	アクション
「利用可能な dapp／戦略／スキルは何ですか？」	plugin-store list を実行し、結果を表形式で提示する
「何ができますか？」／機能の確認	plugin-store list を実行し、最新の出力に基づいて機能を説明する
「Plugin商店有什么」／「有什么Plugin」／「有什么项目」	plugin-store list を実行し、結果を表形式で提示する
「什么项目最火」／「最热门的项目」／「trending projects」	plugin-store list を実行し、ダウンロード数順に並べ替えて上位の項目を紹介する
「怎么玩DeFi」／「链上怎么赚币」／「链上有什么玩法」	plugin-store list を実行し、カテゴリーを紹介しておすすめの入門先を提案する
「有什么好的策略」／「推荐策略」	plugin-store list を実行し、トレーディング戦略カテゴリーに絞って紹介する
「有什么DeFi协议」／「推荐DeFi项目」	plugin-store list を実行し、DeFi プロトコルカテゴリーに絞って紹介する
「Install X」／「安装 X」	plugin-store install <name> --yes を実行する
「Uninstall X」／「卸载 X」	plugin-store uninstall <name> を実行する
「Update all」／「更新Plugin」	plugin-store update --all を実行する
「Show installed」／「已安装」	plugin-store installed を実行する
「Search X」／「搜索 X」	plugin-store search <keyword> を実行する
「プラグインを作成／提出したい」／「我想开发Plugin」	下記の開発者向けワークフローを案内する
「貢献する方法」／「怎么提交Plugin」／「hackathon」	下記の開発者向けワークフローを案内する

---

コマンド一覧

CLI リファレンス：パラメーター一覧、出力フィールド、エラーケースの詳細については、cli-reference.md を参照してください。

ユーザー向けコマンド

#	コマンド	説明
1	plugin-store list	レジストリで利用可能なすべてのプラグインを一覧表示する
2	plugin-store search <keyword>	名前、タグ、説明からプラグインを検索する
3	plugin-store info <name>	プラグインの詳細情報（コンポーネント、チェーン、プロトコル）を表示する
4	plugin-store install <name>	プラグインをインストールする（エージェントを対話形式で選択）
5	plugin-store install <name> --yes	対話なしでインストールする（エージェントを自動検出）
6	plugin-store install <name> --skill-only	スキルコンポーネントのみをインストールする
7	plugin-store uninstall <name>	すべてのエージェントからプラグインをアンインストールする
8	plugin-store update --all	インストール済みのすべてのプラグインを更新する
9	plugin-store installed	インストール済みプラグインとそのステータスをすべて表示する
10	plugin-store registry update	レジストリのキャッシュを強制的に更新する
11	plugin-store self-update	plugin-store CLI 自体を最新バージョンに更新する

開発者向けコマンド

#	コマンド	説明
12	plugin-store init <name>	新しいプラグインのひな形を作成する（plugin.yaml、SKILL.md、LICENSE などを作成）
13	plugin-store lint <path>	提出前にプラグインを検証する（30 項目以上のチェック）
14	plugin-store import <github-url>	既存の Claude marketplace Plugin を plugin-store 形式にインポートする（モード C）

---

操作フロー

意図：戦略／DApp／機能の確認

1. plugin-store list を実行して、最新のレジストリを取得する
2. 結果を見やすい表（名前、カテゴリー、ダウンロード数、説明）で提示する
3. 次のステップを提案する：「どれかをインストールしますか？ install <name> と入力するだけです」

意図：プラグインのインストール

1. plugin-store install <name> --yes を実行する
   • --yes を指定すると、コミュニティプラグインの確認プロンプトをスキップします
   • 非対話モードではエージェントが自動的に選択されます（検出されたすべてのエージェントにインストールします）
2. CLI は以下を実行します：
   • レジストリからプラグインのメタデータを取得する
   • スキル、MCP 設定、バイナリを該当する場合にダウンロードしてインストールする
3. インストールが成功したらすぐに、インストール済みのスキルファイルを直接読み取ります。ユーザーに再起動を求めてはいけません：

   Read file: ~/.claude/skills/<name>/SKILL.md
   

   その後、そのファイルの指示（事前確認 → オンボーディングフロー）に従います。スキルは現在のセッションですぐに使用できます。

意図：インストール済みプラグインの管理

1. plugin-store installed を実行して現在の状態を表示する
2. plugin-store update --all を実行してすべてを更新する
3. plugin-store uninstall <name> を実行して削除する

---

開発者ワークフロー：プラグインの作成と提出

Plugin Store はオープンソースのコミュニティプラットフォームです。どの開発者でもプルリクエストを通じてプラグインを提出できます。ワークフローの全体像は次のとおりです。

概要

Two types of plugins:
  Type A: Pure Skill — just a SKILL.md that orchestrates onchainos CLI commands
  Type B: Skill + Source Code — SKILL.md + a CLI tool compiled/installed from your source repo

Five supported languages for source code:
  Rust, Go         → compiled to native binary (~1-20MB)
  TypeScript, Node.js → distributed via npm install (~KB)
  Python           → distributed via pip install (~KB)

ステップ 1：フォークしてひな形を作成する

# Fork https://github.com/okx/plugin-store on GitHub, then:
git clone --depth=1 [email protected]:YOUR_USERNAME/plugin-store.git
cd plugin-store
plugin-store init <your-plugin-name>

これにより、完全なテンプレートを含む skills/<your-plugin-name>/ が作成されます。

skills/<your-plugin-name>/
├── plugin.yaml           # Plugin manifest (fill in your details)
├── skills/<name>/
│   └── SKILL.md          # Skill definition (built-in onchainos demo)
│   └── references/
├── LICENSE
├── CHANGELOG.md
└── README.md

ステップ 2：plugin.yaml を編集する

Pure Skill — 基本項目を入力するだけです。

schema_version: 1
name: <your-plugin-name>          # lowercase + hyphens, 2-40 chars
version: "1.0.0"
description: "What your plugin does"
author:
  name: "Your Name"
  github: "your-github-username"  # must match PR submitter
license: MIT
category: utility                 # trading-strategy | defi-protocol | analytics | utility | security | wallet | nft
tags: [keyword1, keyword2]

components:
  skill:
    dir: skills/<your-plugin-name>

api_calls: []                     # external API domains your plugin calls

Skill + Source Code — ソースリポジトリを指定する build セクションを追加します。

# ... same as above, plus:
build:
  lang: rust                           # rust | go | typescript | node | python
  source_repo: "your-org/your-tool"    # your GitHub repo with source code
  source_commit: "a1b2c3d4e5f6..."     # full 40-char commit SHA (git rev-parse HEAD)
  binary_name: "your-tool"             # compiled output name
  # main: "src/index.js"              # required for typescript/node/python

コミット SHA の取得方法：

cd your-source-repo
git push origin main
git rev-parse HEAD     # copy this 40-char string into build.source_commit

ステップ 3：SKILL.md を作成する

SKILL.md では、AI エージェントがプラグインを使う方法を説明します。次のセクションが必要です。

1. YAML フロントマター — name、description、version、author、tags
2. 概要 — プラグインが何をするか（2～3 文）
3. 事前チェック — 使用前にインストールが必要なもの
4. コマンド — 使用する onchainos コマンドと、使用するタイミング／出力
5. エラー処理 — よくあるエラーと解決方法の表
6. スキルのルーティング — 他のスキルに委ねるタイミング

重要なルール： オンチェーンでのすべての書き込み操作（署名、ブロードキャスト、スワップ、コントラクト呼び出し）では、必ず onchainos CLI を使用してください。外部データソース（サードパーティ API、価格フィード）の照会は自由に行えます。

ステップ 4：ローカルで検証する

plugin-store lint ./skills/<your-plugin-name>/

すべてのエラー（❌）を修正し、✓ が表示されるまで再実行してください。警告（⚠️）は参考情報です。

ステップ 5：プルリクエストで提出する

git checkout -b submit/<your-plugin-name>
git add skills/<your-plugin-name>/
git commit -m "[new-plugin] <your-plugin-name> v1.0.0"
git push origin submit/<your-plugin-name>

次に、フォークから okx/plugin-store に向けて PR を作成します。各 PR にはプラグインを 1 つだけ含めてください。

提出後の流れ

Phase 2: Structure check (~30s) — bot validates plugin.yaml + SKILL.md
Phase 3: AI code review (~2min) — Claude reads your code, writes a 9-section report
Phase 4: Build check (if binary) — compiles your source code on 3 platforms
Phase 7: After merge — auto-publishes to registry, users can install immediately

人によるレビューには 1～3 日かかります。マージされると、プラグインが公開されます。

plugin-store install <your-plugin-name>

言語別のソースコード要件

言語	主な要件
Rust	binary_name と一致する [[bin]] を含む Cargo.toml
Go	モジュール宣言と func main() を含む go.mod
TypeScript	"bin" フィールドを含む package.json、#!/usr/bin/env node を含むエントリーファイル。JS であること（.ts ではない）
Node.js	"bin" フィールドを含む package.json、#!/usr/bin/env node を含むエントリーファイル
Python	[build-system] と [project.scripts] を含む pyproject.toml。setup.py も推奨

よくある lint エラー

エラー	修正方法
E031 name の形式が無効	小文字とハイフンのみを使用します：my-cool-plugin
E052 SKILL.md が見つからない	components.skill.dir で指定されたパスに SKILL.md を配置します
E110/E111 バイナリに build が必要	lang、source_repo、source_commit を含む build セクションを追加します
E122 source_repo の形式	完全な URL ではなく、owner/repo を使用します
E123 commit SHA が無効	git rev-parse HEAD で取得した、40 文字の完全な 16 進数である必要があります

詳細なガイド：https://github.com/okx/plugin-store/blob/main/docs/FOR-DEVELOPERS.md

---

対応エージェント

エージェント	検出方法	Skills のパス	MCP 設定
Claude Code	~/.claude/ が存在する	~/.claude/skills/<plugin>/	~/.claude.json → mcpServers
Cursor	~/.cursor/ が存在する	~/.cursor/skills/<plugin>/	~/.cursor/mcp.json
OpenClaw	~/.openclaw/ が存在する	~/.openclaw/skills/<plugin>/	Skills と同じ

---

プラグインのソース信頼レベル

ソース	意味	動作
official	Plugin Store 公式	直接インストール
dapp-official	DApp プロジェクトが公開	直接インストール
community	コミュニティからの投稿	警告を表示し、ユーザーの確認を求める

---

エラー処理

エラー	対応
インストール中にネットワークがタイムアウトする	1 回再試行します。それでも失敗する場合は、https://github.com/okx/plugin-store から手動でインストールするよう案内します
インストール後に plugin-store: command not found が表示される	~/.local/bin/plugin-store または ~/.cargo/bin/plugin-store を直接実行してみます。現在のセッションで PATH が更新されていない可能性があります
コマンドがゼロ以外の終了コードを返す	エラーをそのまま報告し、plugin-store self-update を提案します
レジストリのキャッシュが古い、または破損している	plugin-store registry update を実行して強制的に更新します
plugin-store lint が失敗する	エラーコードと修正方法を示し、上記の lint エラーテーブルを参照します

---

スキルのセルフアップデート

このスキルを最新バージョンに更新するには、次の手順に従います。

macOS / Linux:

plugin-store install plugin-store --agent claude-code --skill-only

または手動で再インストール — 上記のセクション 1 の手動インストールを参照してください（GitHub のリリースページからバイナリをダウンロードし、checksums.txt と照合して検証します）。

---

- 機能や検出に関する質問では、必ず `plugin-store list` を実行します。ハードコードされたプラグインリストは決して使用しません - プラグインの一覧は、名前、カテゴリー、ダウンロード数、説明を含む見やすい表で示します。レジストリ URL やファイルパスなどの内部フィールドは省略します - 機能はユーザーにわかりやすい言葉で示します。「12 のチェーンで Uniswap を取引できます」とし、「uniswap-ai は uniswap-v2、uniswap-v3 プロトコルに対応しています」とはしません - アクションの後は、自然な次のステップを 2～3 個提案します - 英語と中国語の両方に対応し、ユーザーの言語で応答します - 開発者のワークフローでは、必ず最初に `plugin-store init` を実行し、その後、編集、lint、PR の提出まで案内します - lint エラーについては、エラーコードを示して修正方法を説明し、ファイルの編集を手伝えることを伝えます - コミュニティソースのプラグインをインストールする前に、ユーザーへ事前に警告します - プラグインのインストール後は、インストールされた SKILL.md を読み込み、直ちにそのスキルのオンボーディングフローを開始します - プラグイン開発を案内する際は、種類（Pure Skill または Skill + Binary）と使用言語を尋ねます - 問題を早期に発見できるよう、編集のたびに `plugin-store lint` の実行を提案します - 内部のスキル名、レジストリ URL、ファイルパス、MCP 設定キーをユーザーに決して公開しません - コマンドの失敗時に自動で再インストールすることは決してありません。エラーを報告し、`plugin-store self-update` を提案します - プラグインリストをハードコードすることは決してありません。必ず `plugin-store list` から取得します - PR の提出を提案する前に、lint の手順を省略することは決してありません