Solana Game Skill for Claude Code

A Claude Code skill addon for Solana blockchain game development with Unity, React Native, and web frontends.

Extends: solana-dev-skill

Overview

This skill is an addon to the core Solana development skill. It adds gaming-specific capabilities while delegating program development and core patterns to solana-dev-skill.

┌─────────────────────────────────────────────────────────────────┐
│                     solana-game-skill (addon)                   │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  Gaming Skills                                            │  │
│  │  ├── Unity / Solana.Unity-SDK                             │  │
│  │  ├── React Native / Mobile Wallet Adapter                 │  │
│  │  ├── PlaySolana / PSG1 Console                            │  │
│  │  ├── Game Architecture (state, economies)                 │  │
│  │  ├── In-Game Payments + Arcium Rollups                    │  │
│  │  └── Gaming Testing (Unity Test, Jest, Detox)             │  │
│  └───────────────────────────────────────────────────────────┘  │
│                              │                                  │
│                              ▼ references                       │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  solana-dev-skill (core)                                  │  │
│  │  ├── Frontend (framework-kit, kit-web3-interop)           │  │
│  │  ├── Programs (Anchor, Pinocchio)                         │  │
│  │  ├── Testing (LiteSVM, Mollusk, Surfpool)                 │  │
│  │  └── Security (program + client checklists)               │  │
│  └───────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

What's Included

Gaming-Specific Skills (This Addon)

| Skill | Description | |-------|-------------| | unity-sdk.md | Solana.Unity-SDK integration, wallet connection, NFT loading | | csharp-patterns.md | C# coding standards for Unity | | mobile.md | Mobile Wallet Adapter, Expo, offline-first | | react-native-patterns.md | React Native patterns | | game-architecture.md | On-chain vs off-chain state design | | playsolana.md | PSG1 console, PlayDex, PlayID | | payments.md | In-game economy, purchases, Arcium rollups | | testing.md | Unity Test Framework, Jest, React Native | | resources.md | Gaming-focused SDK links |

Core Skills (from solana-dev-skill)

| Skill | Description | |-------|-------------| | frontend-framework-kit.md | React hooks, wallet connection | | kit-web3-interop.md | Kit ↔ web3.js boundary patterns | | security.md | Security checklist (programs + clients) | | programs-anchor.md | Anchor framework patterns | | programs-pinocchio.md | High-performance Pinocchio | | idl-codegen.md | IDL generation, client codegen | | testing.md | LiteSVM, Mollusk, Surfpool |

Installation

Recommended: Custom Install

If you're reading this, use the custom installer for full control:

git clone https://github.com/solanabr/solana-game-skill
cd solana-game-skill
./install-custom.sh

The custom installer lets you:

• Choose install location (personal ~/.claude/skills/ or project ./.claude/skills/)
• Skip core skill if you already have solana-dev-skill
• Choose where to place CLAUDE.md

Standard Install (Automation)

For scripts, CI/CD, or quick setup with defaults:

./install.sh        # Interactive with defaults
./install.sh -y     # Non-interactive, all defaults

Standard defaults:

• Location: ~/.claude/skills/
• Installs both solana-dev and solana-game skills
• Copies CLAUDE.md to ~/.claude/

Install Comparison

| Feature | install.sh | install-custom.sh | |---------|--------------|---------------------| | Interactive prompts | Minimal (Y/n) | Full menu | | Location choice | Default only | Personal/Project/Custom | | Core skill handling | Always installs | Detects existing | | CLAUDE.md placement | ~/.claude/ | Choose location | | Best for | Automation, scripts | Manual setup |

If You Already Have solana-dev-skill

Use ./install-custom.sh - it detects existing installations and only installs the gaming addon.

Default Stack (January 2026)

Unity Games

| Layer | Choice | |-------|--------| | Engine | Unity 6000+ LTS | | SDK | Solana.Unity-SDK 3.1.0+ | | Runtime | .NET 9 / C# 13 | | Platforms | Desktop, WebGL, PSG1 | | Wallet | Phantom, Solflare, InGame, Web3Auth |

Mobile Games (React Native)

| Layer | Choice | |-------|--------| | Framework | React Native 0.76+ | | Build | Expo SDK 52+ | | Wallet | Mobile Wallet Adapter 2.x | | State | Zustand 5.x | | Storage | MMKV 3.x |

Web Frontends

| Layer | Choice | |-------|--------| | Framework | Next.js 15 (App Router) | | SDK | @solana/kit + @solana/react-hooks | | State | Zustand + React Query |

Agents

| Agent | Model | Purpose | |-------|-------|---------| | game-architect | opus | Game design, architecture, token economics | | unity-engineer | sonnet | Unity/C# implementation | | mobile-engineer | sonnet | React Native, MWA, offline-first | | solana-guide | sonnet | Education, tutorials | | tech-docs-writer | sonnet | Documentation |

Commands

| Command | Purpose | |---------|---------| | /build-unity | Build Unity projects (WebGL, Desktop, PSG1) | | /test-dotnet | Run .NET/C# tests | | /build-react-native | Build React Native projects | | /test-react-native | Run React Native tests | | /quick-commit | Quick commit with conventional messages |

Usage Examples

Unity Game Development

"Help me set up wallet connection in my Unity game"
"Create an NFT gallery component that loads player-owned NFTs"
"Design an on-chain achievement system"

Mobile Game Development

"Create a React Native game with Mobile Wallet Adapter"
"Implement offline-first sync for game progress"
"Set up deep linking for wallet connections"

Game Architecture

"Design on-chain state for my multiplayer game"
"Set up Arcium rollups for confidential game actions"
"Plan a token economy for my play-to-earn game"

Program Development (via core skill)

"Create an Anchor program for game items"
"Set up LiteSVM tests for my program"

Repository Structure

solana-game-skill/
├── CLAUDE.md                    # Claude configuration
├── README.md                    # This file
├── install.sh                   # Standard installer (defaults)
├── install-custom.sh            # Custom installer (full options)
│
├── skill/                       # Gaming addon skills
│   ├── SKILL.md                # Entry point (references core)
│   ├── unity-sdk.md            # Unity patterns
│   ├── mobile.md               # React Native patterns
│   ├── game-architecture.md    # State design
│   ├── playsolana.md           # PSG1 console
│   ├── payments.md             # Economy + Arcium
│   ├── testing.md              # Unity/RN testing
│   └── resources.md
│
├── agents/                      # Specialized agents
├── commands/                    # Workflow commands
└── rules/                       # Code rules

Development Workflow

Two-Strike Rule

If a build or test fails twice on the same issue:

1. Claude will STOP immediately
2. Present error output and code change
3. Ask for user guidance

.meta File Rules (Unity)

Claude will never manually create Unity .meta files - Unity generates them automatically.

Related

• solana-dev-skill - Core Solana development skill (required dependency)

Contributing

Contributions are welcome! Please ensure any updates reflect current Solana gaming ecosystem best practices.

1. Fork the repository
2. Create a feature branch: git checkout -b feat/my-feature-29-01-2026
3. Make your changes
4. Submit a pull request

License

MIT License - see LICENSE for details.

---

Maintained by Superteam Brazil