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

MagicBlock Dev Skill リポジトリ

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

​
これは何か

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

​
インストール

​
クイックインストール

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 は skill を次の 2 つの個人用 skill ディレクトリにインストールします。
  • ~/.claude/skills/magicblock
  • ${CODEX_HOME:-~/.codex}/skills/magicblock

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

グローバル / ユーザー単位のターゲット: 
./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
Cursor、Windsurf、Cline、Continue、AGENTS.md の単一ファイルターゲットは dist/ artifact から生成されます。dist/ がない場合、install.sh は自動で ./build.sh を実行します。

​
dist artifact を手動でビルドする

./build.sh
生成されるもの:
  • dist/AGENTS.md - 完全に展開された skill(SKILL.md とすべての references)
  • dist/system-prompt.md - Chat 専用プラットフォーム向けの短縮版 SKILL.md と reference URL
  • dist/magicblock.cursor.mdc - .mdc frontmatter 付きの Cursor rule
  • dist/magicblock.zip - Claude.ai アップロード用に圧縮された skill/ フォルダ

​
利用

MagicBlock や Ephemeral Rollups について質問すると、この skill は自動的に有効化されます。
  • Claude Code では /magicblock でも直接呼び出せます。
  • Codex では名前で明示的に指定できます。例: use the magicblock skill
  • Cursor / Windsurf / Cline / Continue では、MagicBlock のトピックに触れたときにルールの説明文がコンテキストに応じて発火します。
  • Chat 専用プラットフォームでは、dist/system-prompt.md をシステムプロンプト、custom instructions、または project context として一度ロードします。
例: 
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 リポジトリをご覧ください。