> ## 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

> AI 코딩 에이전트를 위한 MagicBlock Ephemeral Rollups 개발 skill입니다. 위임, Magic Actions, cranks, VRF, lamports 충전, commit 스폰서십, swaps를 포함한 private payments, 듀얼 커넥션 아키텍처 같은 MagicBlock 특화 패턴을 포함합니다.

<CardGroup cols={1}>
  <Card title="MagicBlock Dev Skill 리포지토리" icon="browser" href="https://github.com/magicblock-labs/magicblock-dev-skill" iconType="duotone">
    리포지토리, 설치 단계, skill의 소스 파일을 확인해보세요.
  </Card>
</CardGroup>

## 무엇인가

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 기반 통합

## 설치

### 빠른 설치

```bash theme={null}
npx add-skill https://github.com/magicblock-labs/magicblock-dev-skill
```

### 수동 설치

```bash theme={null}
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`

### 특정 에이전트 지정

전역 / 사용자 단위 대상:

```bash theme={null}
./install.sh --claude
./install.sh --codex
```

프로젝트 스코프 대상(항상 현재 디렉토리에 설치):

```bash theme={null}
./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
```

조합:

```bash theme={null}
./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 수동 빌드

```bash theme={null}
./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로 한 번 로드합니다.

예시:

```text theme={null}
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 리포지토리](https://github.com/magicblock-labs/magicblock-dev-skill)에서 확인하세요.