solana-mobile Skill: Scaffold and Debug Solana Android Apps

Makes Claude scaffold and troubleshoot Solana Android apps with the solana-mobile CLI, Expo and React Native.

Installs: 13.1K; on skills.sh
Stars: 8; on GitHub
Files: 3; besides SKILL.md
Updated: Oct 2026; last repo commit

solana-mobile makes Claude use the solana-mobile CLI instead of hand-written setup. It creates a project from a template, checks the Android toolchain, manages emulators and connected devices, runs a local validator the device can reach, and tests a wallet without an app.

It starts when you ask to create a Solana mobile app, pick a template, add Solana to an Expo app, check the Android toolchain, or produce a development build. Claude runs npx solana-mobile@latest commands on your machine. SKILL.md has one fixed rule: Mobile Wallet Adapter needs a development build, and Expo Go will not work.

Good for

Expo and React Native developers starting a Solana Android app
Developers adding Solana to an existing Expo app
Developers debugging an Android emulator, device or build

Install solana-mobile

Claude Code

Copy this prompt.

Install the solana-mobile skill in Claude Code. Run this command:

npx -y skills add solana-mobile/solana-mobile-skills --skill solana-mobile

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skill has Claude run npx and edit your project, so there is no Claude app upload route. The README says it needs an Expo React Native project, an Android development build (Expo Go does not work) and an Android development environment, and that npx solana-mobile@latest doctor checks the environment.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Scaffold, configure, and troubleshoot Solana Mobile apps for Android using the solana-mobile CLI, Expo, and React Native. Use when creating a new Solana mobile app, picking a template, adding Solana to an existing Expo app, checking the Android toolchain, managing Android emulators or connected devices, installing a wallet APK for testing, running a local validator the device can reach, or producing a development build.

Sections in SKILL.md

Non-negotiable constraint
First: work out which situation you are in
Create a new project
Choosing a template
After scaffolding
Check the environment
Manage Android emulators
Prepare a fresh emulator
Work with a connected device
Run a local validator
Test a wallet without an app
Reference material
Related skills
Links

Key facts

Author: Solana Mobile
License: Apache-2.0
Installs on skills.sh: 13,096 (Nov 2, 2026)
GitHub stars: 8 (Nov 2, 2026)
skills.sh audits: Gen Agent Trust Hub pass; Socket pass; Snyk pass (Nov 2, 2026)
Last repo commit: Oct 21, 2026
What installs: 4 files including SKILL.md and 3 reference files. It bundles no scripts.
Needs: Node.js to run npx, an Expo project, a development build and an Android environment; Docker only if localnet has to start a container
Works in: Claude Code, Codex, OpenCode, Cline, Amp and other agents the skills installer supports

What it includes

Routes to create, add-to-existing-app, doctor, the wallet skill or playground.
Work out the situation first
Scaffolds a project from a template; prompts unless you name the project and template.
Runs code · create
Picks an expo-kit-* template; expo-kit-wallet is the best default.
Choose a template
Reports on the local Android and Node toolchain with recommendations.
Runs code · doctor
Creates, starts, stops, tunes and deletes Android emulators and system images.
Delete · emulator (emu)
Boots it with --tune, then installs the test wallet with device install fakewallet.
Runs code · Prepare a fresh emulator
Lists devices, installs APKs, opens URLs and tunes devices over adb.
Runs code · device
Serves a validator and forwards its ports to devices; may start a Docker container.
Runs code · localnet
Serves a wallet test page on the device and streams each wallet call to the terminal.
Runs code · playground
Wraps an existing web app in an Android WebView shell.
Runs code · webshell
Maintains a template repository; SKILL.md marks it for template authors only.
Runs code · templates

From the official docs

Permissions

Medium risk

This skill makes Claude run commands and write code in your project. Work on a branch and read the diff before you build.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs the newest published CLI each time
SKILL.md tells Claude to keep @latest so the runner does not reuse an older cached version. Claude therefore runs whatever solana-mobile version is published at that moment. github.com
create scaffolds files and installs a second skill
create writes a new project and installs dependencies unless --skip-install is passed. SKILL.md also says create installs the Solana Foundation solana-dev skill into .agents/skills/solana-dev/ of the project. github.com
emu and device commands change your devices
emu can create, delete and tune emulators and device install runs adb install on a connected phone or emulator. references/cli.md also shows device tune --all --yes and emu tune -y, which apply device tweaks without asking. Name the target device in anything unattended. github.com
It downloads wallet APKs and may start Docker
Catalog APKs are downloaded from GitHub releases and cached under ~/.cache/solana-mobile/apks/. localnet start can start a Docker container and removes a stopped container of its own first. github.com
prebuild --clean discards manual native edits
The troubleshooting reference suggests npx expo prebuild --clean, which regenerates android/ and ios/ from configuration and discards manual edits. Commit your changes first. github.com
templates sync --force can overwrite another repo
The templates sync subcommand takes --force, which syncs even when the target repo has uncommitted changes and may overwrite or remove files there. It is meant for template authors. github.com
The install command uses npx -y
The README's install command is npx -y skills add. The -y flag answers npx's own prompt to download the skills package with yes. Drop -y if you want to see that prompt. github.com
The CLI checks npm for a newer version
In the solana-mobile CLI source, version-check.ts fetches registry.npmjs.org for the latest release of the package to show an update notice. The code skips this check in CI, without a terminal, under tests and for preview builds. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode is documented.
Talks to	npm registry (npx solana-mobile@latest). github.com releases (catalog wallet APKs)
Scopes	Runs npx solana-mobile@latest, adb and Docker-backed commands on your machine Writes new project files and can create or delete emulators

Questions

How do I install solana-mobile?

Use the install box above. The skills CLI with a skill flag installs just solana-mobile; the repo has 7 skills in total. Skills land in .agents/skills/, and the README says a skills-lock.json records the source and a content hash of each skill.

Is solana-mobile safe to use?

It bundles no scripts, but it makes Claude run npx solana-mobile@latest and adb on your machine, and a local validator may start a Docker container. Those commands can create projects, install apps and create or delete emulators. Our advice: work on a git branch, use a test emulator for emu and device commands, and read each command before it runs.

Is solana-mobile official?

It is published in Solana Mobile's own repo, solana-mobile/solana-mobile-skills, and plugin.json lists Solana Mobile as the author.

Does solana-mobile work in the Claude app?

We list no Claude app upload for it, because SKILL.md has the agent run npx and adb commands in your project. The README lists Claude Code, Codex, OpenCode, Cline, Amp and other agents the skills installer supports. Our advice: use it in Claude Code or Codex.

Do I need a development build or Expo Go?

A development build. SKILL.md says Mobile Wallet Adapter depends on native Android modules that Expo Go does not bundle, so wallet connection fails there. Android is the only platform with wallet support, and iOS builds run without it.

Which template should I pick?

expo-kit-wallet, which SKILL.md calls the best default because wallet connect, sign and send are already wired. It lists expo-web3js-* templates only for continuing an existing @solana/web3.js codebase or when you ask for one by name.

solana-mobile vs solana-dev?

Use solana-mobile for Android app setup, emulators and the CLI. The README sends general Solana work, such as Anchor or Pinocchio programs, Codama client generation, testing and security review, to the Solana Foundation's solana-dev skill. create installs solana-dev into every scaffolded project.

Information

updated Nov 2, 2026

Repository: solana-mobile/solana-mobile-skills
Folder: skills/solana-mobile

solana-mobile/solana-mobile-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

solana-mobile-skills README · github.com
solana-mobile SKILL.md · github.com
plugin.json · github.com
solana-mobile cli.md · github.com
solana-mobile troubleshooting.md · github.com
solana-mobile-cli version-check.ts · github.com