메인 콘텐츠로 건너뛰기

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을 두 개인 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 리포지토리에서 확인하세요.