MagicBlock Dev Skill

May 14, 2026 · View on GitHub

MagicBlock Ephemeral Rollups development skill for AI coding agents. The skill packages MagicBlock-specific patterns (delegation, Magic Actions, cranks, VRF, lamports top-up, commit sponsorship, private payments with swaps, dual-connection architecture) into a reusable workflow that activates automatically when you ask for MagicBlock or Ephemeral Rollups help.

Installation

Quick install

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

Manual install

git clone https://github.com/magicblock-labs/magicblock-dev-skill
cd magicblock-dev-skill
./install.sh

By default, ./install.sh installs the skill to both personal skill directories:

  • ~/.claude/skills/magicblock
  • ${CODEX_HOME:-~/.codex}/skills/magicblock

Targeting specific agents

Global / per-user targets:

./install.sh --claude
./install.sh --codex

Project-scoped targets (always install into the current directory):

./install.sh --cursor       # writes .cursor/rules/magicblock.mdc
./install.sh --windsurf     # writes .windsurf/rules/magicblock.md
./install.sh --cline        # writes .clinerules/magicblock.md
./install.sh --continue     # writes .continue/rules/magicblock.md
./install.sh --agents-md    # writes ./AGENTS.md

Combined:

./install.sh --all          # everything for the current project
./install.sh --project      # Claude + Codex into .claude/.codex inside the project
./install.sh --path /custom/path/magicblock

The single-file targets (Cursor, Windsurf, Cline, Continue, AGENTS.md) are generated from dist/ artifacts; install.sh runs ./build.sh automatically if dist/ is missing.

Building dist/ artifacts manually

./build.sh

Produces:

  • dist/AGENTS.md — full flattened skill (SKILL.md + all references)
  • dist/system-prompt.md — trimmed SKILL.md + reference URLs (for chat-only platforms)
  • dist/magicblock.cursor.mdc — Cursor-formatted rule with .mdc frontmatter
  • dist/magicblock.zip — zipped skill/ folder for Claude.ai upload

What This Skill Covers

  • MagicBlock Ephemeral Rollups integration
  • Delegating/undelegating Solana accounts
  • High-performance, low-latency transaction flows
  • Crank scheduling (recurring automated transactions)
  • VRF (Verifiable Random Function) for provable randomness
  • Magic Actions — base-layer instructions chained to an ER commit
  • Topping up delegated accounts with lamports via lamportsDelegatedTransferIx
  • Dual-connection architecture (base layer + ephemeral rollup)
  • Gaming and real-time app development on Solana
  • Private payments (deposits, transfers, withdrawals, and swaps via the Payments API, with optional bearer-token auth for private reads)
  • Commit sponsorship and lifting the 10-commit default with magic_fee_vault

Usage

The skill activates automatically when you ask about MagicBlock or Ephemeral Rollups.

  • In Claude Code, you can also invoke it directly with /magicblock.
  • In Codex, you can mention it explicitly by name, for example: use the magicblock skill.
  • In Cursor / Windsurf / Cline / Continue, the rule's description triggers contextually when you mention MagicBlock topics.
  • For chat-only platforms, the skill is loaded once via the system prompt and persists for the session.

Examples:

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

License

MIT