simulators — Claude Code skill: what it does, how to install
simulators is a Claude Code skill that launches and tests mobile apps in local iOS and Android simulators. It runs during screen and animation testing for Expo and React Native projects.
no license ★ 149 updated 2026-11-17
npx skills add 0xdaniell/macbox --skill simulators -a claude-codeWhat simulators does
The skill builds, automates, and verifies mobile interfaces on local emulators without remote cloud fees. The mac-sim CLI operates iOS simulators inside a macbox macOS virtual machine over SSH, while android-sim handles local Android emulators sized for Pixel 9. Each project checkout reserves its own isolated emulator session until shut down.
It inspects screen trees with identifier references like @e12, triggers taps or swipes, captures uncompressed screenshots, and records interaction clips. The companion sim-fps utility checks recordings for 60 fps consistency and dropped frames across layout changes. Builds can run in development mode or via MODE=release to reproduce production conditions.
Running iOS targets requires a configured macbox VM with working SSH access. Android testing relies on local emulator tools already installed on the host.
What it helps with
- run Expo and React Native builds on local iOS and Android emulators
- measure screen animations and transitions for stable 60 fps playback
- capture lossless simulator screenshots at native device pixel scale
- dispatch taps and gestures using screen tree node identifiers
Example prompts for the agent
- Launch the app on the iOS simulator and capture a screenshot of the home screen.
- Record a ten-second clip of the checkout flow and check the frame rate.
- Open the Android emulator and tap the sign-in button using element refs.
How to install simulators
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill simulators -a claude-code2Manually: put the files in place
~/.claude/skills/simulators/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/simulators/
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill simulators -a codex2Manually: put the files in place
.agents/skills/simulators/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill simulators -a cursor2Manually: put the files in place
.cursor/skills/simulators/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 0xdaniell/macbox src/skills/simulators2Manually: put the files in place
.github/skills/simulators/SKILL.md1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill simulators -a gemini-cli2Platform CLI
gemini skills install https://github.com/0xdaniell/macbox --path src/skills/simulatorsManually: put the files in place
.devin/skills/simulators/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about simulators
How to install simulators in Claude Code?
Run the command npx skills add 0xdaniell/macbox --skill simulators -a claude-code.
What does the simulators skill do?
The skill boots local mobile emulators, installs app builds, simulates user touch events, and measures display frame rates.
What is required to run simulators?
iOS emulation requires a macbox macOS virtual machine accessible via SSH, while Android testing requires local emulator tooling installed on the system.