Details

仕組み

Last updated March 4, 2026

Metaplex Skillはプログレッシブディスクロージャーを使用して、AIエージェントに必要なコンテキストだけを提供します。トークン使用量を低く抑えながら、すべてのMetaplexプログラムの包括的なカバレッジを提供します。

概要

Metaplex Skillは2層のプログレッシブディスクロージャーアーキテクチャを使用して、トークン使用量を最小限に抑えながらAIエージェントに正確なMetaplex知識を提供します。

  • 軽量なルーターファイル(SKILL.md)がタスクを特定のリファレンスファイルにマッピング
  • エージェントは現在のタスクに関連するファイルのみを読み取り
  • リファレンスファイルはCLIコマンド、SDKパターン、概念的基盤をカバー
  • アーキテクチャはすべてのMetaplexプログラムをカバーしながらコンテキストを小さく保持

アーキテクチャ

スキルには2つのレイヤーがあります:

  1. SKILL.md — エージェントが最初に読む軽量なルーターファイル。すべてのプログラムの概要、ツール選択ガイド、タスクを特定のリファレンスファイルにマッピングするタスクルーターテーブルが含まれています。

  2. リファレンスファイル — CLIセットアップ、プログラム固有のCLIコマンド、SDKパターン、概念的基盤をカバーする詳細ファイル。エージェントは現在のタスクに関連するファイルのみを読み取ります。

エージェントがMetaplex Skillを使用する方法

エージェントにMetaplexタスクを実行するよう依頼すると:

  1. エージェントがSKILL.mdを読み、タスクタイプを識別
  2. タスクルーターテーブルがエージェントを関連するリファレンスファイルに誘導
  3. エージェントはそれらのファイルのみを読み、正確なコマンドとコードでタスクを実行

例えば、*「devnetでCore NFTを作成して」*と依頼すると、エージェントはSKILL.mdを読み、これをCLI Coreタスクとして識別し、cli.md(共通セットアップ)とcli-core.md(Core固有コマンド)を読みます。

リファレンスファイル

スキルにはアプローチとプログラム別に整理されたリファレンスファイルが含まれています:

CLIリファレンス

これらのファイルは各プログラムのmplx CLIコマンドをカバーします。

ファイル内容
cli.md共通CLIセットアップ、設定、ツールボックスコマンド
cli-core.mdCore NFTとコレクションのCLIコマンド
cli-token-metadata.mdToken Metadata NFT/pNFTのCLIコマンド
cli-bubblegum.md圧縮NFT(cNFT)のCLIコマンド
cli-candy-machine.mdCandy MachineセットアップとデプロイのCLIコマンド
cli-genesis.mdGenesisトークンローンチのcliコマンド

SDKリファレンス

これらのファイルは各プログラムのUmiとKit SDKオペレーションをカバーします。

ファイル内容
sdk-umi.mdUmi SDKセットアップと共通パターン
sdk-core.mdUmi経由のCore NFTオペレーション
sdk-token-metadata.mdUmi経由のToken Metadataオペレーション
sdk-bubblegum.mdUmi経由の圧縮NFTオペレーション
sdk-genesis.mdUmi経由のGenesisトークンローンチオペレーション
sdk-token-metadata-kit.mdKit SDK経由のToken Metadataオペレーション

コンセプト

これらのファイルはアカウント構造やプログラムIDなどの共有知識をカバーします。

ファイル内容
concepts.mdアカウント構造、PDA、プログラムID

タスクルーター

SKILL.mdのタスクルーターは、各タスクタイプをエージェントが読むべきファイルにマッピングします:

タスクタイプ読み込まれるファイル
CLIオペレーション(共通セットアップ)cli.md
CLI: Core NFT/コレクションcli.md + cli-core.md
CLI: Token Metadata NFTcli.md + cli-token-metadata.md
CLI: 圧縮NFT(Bubblegum)cli.md + cli-bubblegum.md
CLI: Candy Machine(NFTドロップ)cli.md + cli-candy-machine.md
CLI: トークンローンチ(Genesis)cli.md + cli-genesis.md
CLI: ファンジブルトークンcli.md(ツールボックスセクション)
SDKセットアップ(Umi)sdk-umi.md
SDK: Core NFTsdk-umi.md + sdk-core.md
SDK: Token Metadatasdk-umi.md + sdk-token-metadata.md
SDK: 圧縮NFT(Bubblegum)sdk-umi.md + sdk-bubblegum.md
SDK: Candy Machine(ミント/ガード)sdk-umi.md
SDK: Kit使用のToken Metadatasdk-token-metadata-kit.md
SDK: トークンローンチ(Genesis)sdk-umi.md + sdk-genesis.md
アカウント構造、PDA、コンセプトconcepts.md

注意事項

  • スキルはAIコーディングエージェント向けに設計されており、人間が読むドキュメントとしてレンダリングされない場合があります
  • リファレンスファイルはSkillリポジトリと並行してメンテナンスされ、デベロッパーハブとは独立して更新される場合があります
  • Agent Skillsフォーマットをサポートしないエージェントでも、手動インストールによりスキルを使用できます