android-emulator-skill

Q: How do I install android-emulator-skill?

Run npx skills add https://github.com/new-silvermoon/awesome-android-agent-skills --skill android-emulator-skill in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/android-emulator-skill/ (personal) or .claude/skills/android-emulator-skill/ (project).

by new-silvermoonMobile

Production-ready scripts for Android app testing, building, and automation. Provides semantic UI navigation, build automation, log monitoring, and emulator lifecycle management. Optimized for AI agents with minimal token output.

Installs: 552
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/new-silvermoon/awesome-android-agent-skills --skill android-emulator-skill

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads android-emulator-skill automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Android Emulator Skill

Build, test, and automate Android applications using accessibility-driven navigation and structured data instead of pixel coordinates.

Quick Start

# 1. Check environment (use .sh on macOS/Linux, .ps1 on Windows)
bash scripts/emu_health_check.sh
# or on Windows: .\scripts\emu_health_check.ps1

# 2. Launch app
python scripts/app_launcher.py --launch com.example.app

# 3. Map screen to see elements
python scripts/screen_mapper.py

# 4. Tap button
python scripts/navigator.py --find-text "Login" --tap

# 5. Enter text
python scripts/navigator.py --find-type EditText --enter-text "user@example.com"

All scripts support --help for detailed options and --json for machine-readable output.

Production Scripts

Build & Development

build_and_test.py - Build Android projects, run tests, parse results
- Wrapper around Gradle
- Support for assemble, install, and connectedCheck
- Parse build errors and test results
- Options: --task, --clean, --json
log_monitor.py - Real-time log monitoring with intelligent filtering
- Wrapper around adb logcat
- Filter by tag, priority, or PID
- Deduplicate repeated messages
- Options: --package, --tag, --priority, --duration, --json

Navigation & Interaction

screen_mapper.py - Analyze current screen and list interactive elements
- Dump UI hierarchy using uiautomator
- Parse XML to identify buttons, text fields, etc.
- Options: --verbose, --json
navigator.py - Find and interact with elements semantically
- Find by text (fuzzy matching), resource-id, or class name
- Interactive tapping and text entry
- Options: --find-text, --find-id, --tap, --enter-text, --json
gesture.py - Perform swipes, scrolls, and other gestures
- Swipe up/down/left/right
- Scroll lists
- Options: --swipe, --scroll, --duration, --json
keyboard.py - Key events and hardware buttons
- Input key events (Home, Back, Enter, Tab)
- Type text via ADB
- Options: --key, --text, --json
app_launcher.py - App lifecycle management
- Launch apps (adb shell am start)
- Terminate apps (adb shell am force-stop)
- Install/Uninstall APKs
- List installed packages
- Options: --launch, --terminate, --install, --uninstall, --list, --json

Emulator Lifecycle Management

emulator_manage.py - Manage Android Virtual Devices (AVDs)
- List available AVDs
- Boot emulators
- Shutdown emulators
- Options: --list, --boot, --shutdown, --json
emu_health_check - Verify environment is properly configured
- Use emu_health_check.sh on macOS/Linux and emu_health_check.ps1 on Windows
- Check ADB, Emulator, Java, Gradle, ANDROID_HOME
- List connected devices

Common Patterns

Auto-Device Detection: Scripts target the single connected device/emulator if only one is present, or require -s <serial> if multiple are connected.

Output Formats: Default is concise human-readable output. Use --json for machine-readable output.

Requirements

Android SDK Platform-Tools (adb, fastboot)
Android Emulator
Java / OpenJDK
Python 3

Key Design Principles

Semantic Navigation: Find elements by text, resource-id, or content-description.

Token Efficiency: Concise default output with optional verbose and JSON modes.

Zero Configuration: Works with standard Android SDK installation.

FAQ

What does the android-emulator-skill skill do?

How do I install android-emulator-skill?

Run npx skills add https://github.com/new-silvermoon/awesome-android-agent-skills --skill android-emulator-skill in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/android-emulator-skill/ (personal) or .claude/skills/android-emulator-skill/ (project).

Which AI agents can use android-emulator-skill?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is android-emulator-skill safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains android-emulator-skill?

It is published by new-silvermoon in new-silvermoon/awesome-android-agent-skills. It has 552 recorded installs.