메인 콘텐츠로 건너뛰기

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