solanabr Solana Game Development Skill
Extends: solana-dev-skill - Core Solana development (programs, frontend, testing, security)
What This Skill Is For
Use this skill when the user asks for:
Unity Game Development
- Unity game development with Solana integration
- Wallet connection in Unity (Phantom, Solflare, InGame, Web3Auth)
- NFT loading, display, and game asset integration
- Transaction building and signing in C#
- PlaySolana/PSG1 console development
Mobile Game Development (React Native)
- React Native mobile games with Solana
- Mobile Wallet Adapter integration
- Offline-first game architecture
- Deep linking with Solana wallets
- Cross-platform iOS/Android development
Web Frontend (Gaming Context)
- Next.js/React frontends with Solana
- Wallet connection with framework-kit
- NFT galleries and game UIs
- Transaction UX patterns
Game Architecture
- On-chain vs off-chain game state
- Player progression and achievements
- Token economics and in-game currencies
- Multiplayer architecture with blockchain validation
Program Development (Delegate to Core Skill)
- For Anchor programs → programs-anchor.md
- For Pinocchio programs → programs-pinocchio.md
- For IDL/codegen → idl-codegen.md
Default Stack Decisions (Opinionated)
1) Unity Games: Unity 6000+ LTS
- Solana.Unity-SDK 3.1.0+ via UPM
- Modern Input System, UI Toolkit
- .NET 9 / C# 13
- Assembly definitions for organization
2) Mobile Games: React Native 0.76+ with Expo
- Mobile Wallet Adapter 2.x
- Zustand 5.x for state
- MMKV 3.x for storage
- TanStack Query 5.x for RPC data
3) Web: framework-kit first
- @solana/client + @solana/react-hooks
- @solana/kit for transactions
- Next.js 15 with App Router
4) Testing
- Unity: Edit Mode + Play Mode tests
- React Native: Jest + RNTL + Detox
- Web: Vitest + React Testing Library
- Programs: LiteSVM, Mollusk, Surfpool (see core skill)
5) Platform Targets
- Default: Desktop (Windows/macOS) and WebGL
- Mobile: When explicitly specified
- PSG1: When explicitly targeting PlaySolana
Operating Procedure
1. Classify the Task Layer
| Layer | Examples | Skill File(s) |
|---|---|---|
| Unity/C# | Game mechanics, UI, wallet | unity-sdk.md, csharp-patterns.md |
| Mobile/RN | Mobile apps, MWA, offline | mobile.md, react-native-patterns.md |
| Web/Frontend | Next.js, React, wallet | frontend-framework-kit.md |
| Game Architecture | On-chain state, economics | game-architecture.md |
| Program/Anchor | On-chain game logic | programs-anchor.md |
| Program/Pinocchio | High-perf programs | programs-pinocchio.md |
2. Pick the Right Agent
| Task Type | Agent | Model |
|---|---|---|
| High-level design | game-architect | opus |
| Unity code | unity-engineer | sonnet |
| Mobile code | mobile-engineer | sonnet |
| Learning/tutorials | solana-guide | sonnet |
| Documentation | tech-docs-writer | sonnet |
3. Apply Platform-Specific Patterns
Unity:
- Use WalletService pattern with events
- TransactionBuilder for building transactions
- NFTService with texture caching
- Async/await for all blockchain operations
React Native:
- Mobile Wallet Adapter for wallet connection
- Zustand stores for game state
- MMKV for offline persistence
- Network-aware sync patterns
Web:
- framework-kit hooks for wallet/balance
- React Query for RPC data
- Zustand for app state
- Kit types for transactions
4. Add Tests
- Unity: Edit Mode for logic, Play Mode for MonoBehaviours
- React Native: Component tests, hook tests, E2E
- Web: Component tests, hook tests
- Programs: LiteSVM/Mollusk (see testing.md)
- Two-strike rule: If test fails twice, STOP and ask
5. Deliverables
When implementing changes, provide:
- Exact files changed with clear diffs
- Package dependencies (manifest.json, package.json)
- Build/test commands
- Platform considerations
Progressive Disclosure (Read When Needed)
Gaming-Specific Skills (This Addon)
Unity & C#
- unity-sdk.md - Solana.Unity-SDK integration patterns
- csharp-patterns.md - C# coding standards and patterns
Mobile
- mobile.md - Mobile Wallet Adapter, Expo, offline-first
- react-native-patterns.md - React Native patterns
Game Systems
- game-architecture.md - On-chain vs off-chain, state design
- playsolana.md - PSG1 console, PlayDex, PlayID
- payments.md - Commerce, token transfers, in-game economy, Arcium rollups
Gaming Testing
- testing.md - Unity Test Framework, Jest, React Native testing
Reference
- resources.md - Curated links to SDKs and documentation
Core Solana Dev Skills (from solana-dev-skill)
These are provided by solana-dev-skill - install if not present
Web Frontend
- frontend-framework-kit.md - React hooks, wallet connection
- kit-web3-interop.md - Kit ↔ web3.js boundary patterns
Program Development
- programs-anchor.md - Anchor framework patterns
- programs-pinocchio.md - Pinocchio high-performance programs
- idl-codegen.md - IDL generation and client codegen
Core Testing & Security
- testing.md - LiteSVM, Mollusk, Surfpool
- security.md - Security checklist (programs + clients)
- payments.md - Core payment patterns
- resources.md - Core Solana resources
Task Routing Guide
| User asks about... | Primary skill file(s) |
|---|---|
| Unity wallet connection | unity-sdk.md |
| Unity NFT loading | unity-sdk.md |
| Unity transaction building | unity-sdk.md, csharp-patterns.md |
| C# async patterns | csharp-patterns.md |
| React Native mobile game | mobile.md, react-native-patterns.md |
| Mobile Wallet Adapter | mobile.md |
| Offline sync | mobile.md |
| Web wallet connection | solana-dev → frontend-framework-kit.md |
| Kit vs web3.js | solana-dev → kit-web3-interop.md |
| Game state architecture | game-architecture.md |
| PSG1 console | playsolana.md |
| PlayDex achievements | playsolana.md |
| In-game purchases | payments.md |
| Arcium rollups | payments.md |
| Testing Unity | testing.md |
| Testing React Native | testing.md, react-native-patterns.md |
| Security review | solana-dev → security.md |
| DeFi integration | solana-dev → payments.md |
| Token standards | solana-dev → payments.md |
| Anchor program | solana-dev → programs-anchor.md |
| Pinocchio program | solana-dev → programs-pinocchio.md |
| Program testing | solana-dev → testing.md |
Commands
| Command | Description |
|---|---|
| /build-unity | Build Unity projects (WebGL, Desktop, PSG1) |
| /test-dotnet | Run .NET/C# tests (Unity Test Framework) |
| /build-react-native | Build React Native projects |
| /test-react-native | Run React Native tests |
| /quick-commit | Quick commit with conventional messages |
Agents
| Agent | Purpose |
|---|---|
| game-architect | Game design, architecture, on-chain state, token economics |
| unity-engineer | Unity/C# implementation, wallet, NFT, transactions |
| mobile-engineer | React Native, MWA, offline-first, deep linking |
| solana-guide | Education, tutorials, concept explanations |
| tech-docs-writer | README files, API docs, integration guides |