Solana Game Skill for Claude Code

Enhance your Solana game development with this Claude Code skill addon for Unity and React Native.

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)

SkillDescription
unity-sdk.mdSolana.Unity-SDK integration, wallet connection, NFT loading
csharp-patterns.mdC# coding standards for Unity
mobile.mdMobile Wallet Adapter, Expo, offline-first
react-native-patterns.mdReact Native patterns
game-architecture.mdOn-chain vs off-chain state design
playsolana.mdPSG1 console, PlayDex, PlayID
payments.mdIn-game economy, purchases, Arcium rollups
testing.mdUnity Test Framework, Jest, React Native
resources.mdGaming-focused SDK links

Core Skills (from solana-dev-skill)

SkillDescription
frontend-framework-kit.mdReact hooks, wallet connection
kit-web3-interop.mdKit ↔ web3.js boundary patterns
security.mdSecurity checklist (programs + clients)
programs-anchor.mdAnchor framework patterns
programs-pinocchio.mdHigh-performance Pinocchio
idl-codegen.mdIDL generation, client codegen
testing.mdLiteSVM, 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

Featureinstall.shinstall-custom.sh
Interactive promptsMinimal (Y/n)Full menu
Location choiceDefault onlyPersonal/Project/Custom
Core skill handlingAlways installsDetects existing
CLAUDE.md placement~/.claude/Choose location
Best forAutomation, scriptsManual 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

LayerChoice
EngineUnity 6000+ LTS
SDKSolana.Unity-SDK 3.1.0+
Runtime.NET 9 / C# 13
PlatformsDesktop, WebGL, PSG1
WalletPhantom, Solflare, InGame, Web3Auth

Mobile Games (React Native)

LayerChoice
FrameworkReact Native 0.76+
BuildExpo SDK 52+
WalletMobile Wallet Adapter 2.x
StateZustand 5.x
StorageMMKV 3.x

Web Frontends

LayerChoice
FrameworkNext.js 15 (App Router)
SDK@solana/kit + @solana/react-hooks
StateZustand + React Query

Agents

AgentModelPurpose
game-architectopusGame design, architecture, token economics
unity-engineersonnetUnity/C# implementation
mobile-engineersonnetReact Native, MWA, offline-first
solana-guidesonnetEducation, tutorials
tech-docs-writersonnetDocumentation

Commands

CommandPurpose
/build-unityBuild Unity projects (WebGL, Desktop, PSG1)
/test-dotnetRun .NET/C# tests
/build-react-nativeBuild React Native projects
/test-react-nativeRun React Native tests
/quick-commitQuick 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

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