メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.magicblock.gg/llms.txt

Use this file to discover all available pages before exploring further.

MagicBlock Dev Skill リポジトリ

リポジトリ、インストール手順、skill のソースファイルをご覧ください。

​
これは何か

MagicBlock Dev Skill は AI 開発 skill であり、実証済みの MagicBlock 開発パターンを複数の AI コーディングエージェントで再利用可能なワークフローとしてパッケージ化したものです。プロンプトのたびに同じ統合の詳細を説明し直す必要はなく、この skill がコーディングエージェントに対し MagicBlock 上で構築するための構造化されたガイダンスを与えます。 以下のような取り組みを行うチームを想定しています:
  • Ephemeral Rollups の統合
  • 委任および委任解除のフロー
  • Solana + MagicBlock のデュアルコネクション アーキテクチャ
  • 高性能なトランザクションルーティング
  • 定期的な自動トランザクションのための Cranks
  • 検証可能なランダム性のための VRF
  • Magic Actions — ER commit にアトミックに連結されるベースレイヤー命令
  • lamportsDelegatedTransferIx を使った委任アカウントへの lamports トップアップ
  • Commit スポンサーシップ、および magic_fee_vault でデフォルトの 10 commit 上限を引き上げる方法
  • Private payments — Payments API を介した入金、送金、出金、swaps、プライベート読み取り用の challenge/login bearer トークンフローを含む
  • Anchor および TypeScript ベースの統合

​
サポートされている Agent

この skill は単一のインストーラーで多くの AI コーディングエージェントに対応します。お使いのエージェントを選んでください:
Agentインストール先
Claude Code~/.claude/skills/magicblock/
Claude.ai(chat / desktop)Skills UI で dist/magicblock.zip をアップロード
Codex~/.codex/skills/magicblock/
Cursor.cursor/rules/magicblock.mdc
Windsurf.windsurf/rules/magicblock.md
Cline.clinerules/magicblock.md
Continue.continue/rules/magicblock.md
クロスツール標準プロジェクトルートの AGENTS.md
Chat 専用(DeepSeek、ChatGPT default など)dist/system-prompt.md をシステムプロンプトに貼り付け

​
インストール方法

​
Claude Code でのクイックインストール

npx add-skill https://github.com/magicblock-labs/magicblock-dev-skill

​
手動インストール

git clone https://github.com/magicblock-labs/magicblock-dev-skill
cd magicblock-dev-skill
./install.sh
デフォルトでは、./install.sh は Claude Code と Codex の個人用 skill ディレクトリに同時にインストールします。

​
特定のエージェントを指定する

グローバル / ユーザー単位のターゲット: 
./install.sh --claude
./install.sh --codex
プロジェクトスコープのターゲット(常に現在のディレクトリにインストール): 
./install.sh --cursor       # .cursor/rules/magicblock.mdc
./install.sh --windsurf     # .windsurf/rules/magicblock.md
./install.sh --cline        # .clinerules/magicblock.md
./install.sh --continue     # .continue/rules/magicblock.md
./install.sh --agents-md    # ./AGENTS.md
組み合わせ: 
./install.sh --all          # 現在のプロジェクトに全てインストール
./install.sh --project      # Claude + Codex をプロジェクト内の .claude / .codex にインストール
./install.sh --path /custom/path/magicblock

​
Claude.ai へのアップロード

./build.sh
その後、Claude.ai の Settings → Capabilities → Skills から dist/magicblock.zip をアップロードしてください。

​
Chat 専用プラットフォーム(DeepSeek、ChatGPT default、Claude.ai default)

./build.sh
cat dist/system-prompt.md
出力をプラットフォームのシステムプロンプト、custom instructions、または project context フィールドに貼り付けてください。

​
エージェントでの利用

インストール後、MagicBlock や Ephemeral Rollups に関するヘルプを求めたときに skill が自動的に有効化されます。
  • Claude Code では /magicblock で直接呼び出せます
  • Codex では名前で明示的に指定できます:use the magicblock skill
  • Cursor / Windsurf / Cline / Continue では、MagicBlock のトピックに触れたときにルールの説明文がコンテキストに応じて発火します
  • Chat 専用プラットフォームでは、システムプロンプトで一度ロードすればセッション中ずっと有効です
プロンプト例: 
Add delegation hooks to my player account
Change my roll_dice function to use VRF
Set up a crank that updates game state every 100ms
Add a Magic Action that updates my onchain leaderboard after every commit
Top up my delegated fee payer with lamports
Build a private USDC transfer flow using the Payments API
Help me integrate MagicBlock into my Anchor program

​
この Skill が提供するもの

この skill は単純なプロンプトテンプレートにとどまりません。メインのエントリポイントと参考資料が、MagicBlock 固有の実装詳細にエージェントを導きます。例えば:
  • ベースレイヤー接続を使うべきか、ephemeral rollup 接続を使うべきかの判断
  • MagicIntentBundleBuilder(SDK 0.11+)を使った委任、commit、委任解除フローの正しい組み立て方
  • #[ephemeral]、#[delegate]、#[commit] の典型的な Anchor パターン
  • Magic Actions: MagicIntentBundleBuilder.add_post_commit_actions(...) を使って ER トランザクション内でベースレイヤー命令をスケジュールし、commit の確定後にアトミックに実行する
  • lamportsDelegatedTransferIx による委任アカウントへの lamports トップアップ(ベースレイヤーで一回限りの lamports PDA を投げ、ER 側で入金される)
  • magic_fee_vault PDA と委任 fee payer を intent bundle に付与してデフォルトの 10 commit スポンサー上限を引き上げる方法
  • Private Ephemeral Rollups(PER)パターン — permission アカウントを保護対象アカウントと一緒に委任し、メンバー更新を ER 上で実行する
  • Private Payments API のワークフロー、プライベート残高を読むための challenge → login → bearer トークンフロー、および公開/プライベートの swap モードを含む
  • リアルタイムアプリやゲームに向けた VRF と crank の設定
  • MagicBlock 開発に必要な環境変数、バージョン、依存関係
skill 全体、ソースファイル、インストール手順については、MagicBlock Dev Skill リポジトリをご覧ください。