android-emulator-skill
Provides production-ready automation scripts for Android app testing, builds, and emulator management.
Install
mkdir -p .claude/skills/android-emulator-skill && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10647" && unzip -o skill.zip -d .claude/skills/android-emulator-skill && rm skill.zipInstalls to .claude/skills/android-emulator-skill
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →Automate UI navigation
- →Monitor emulator logs
- →Manage emulator lifecycle
- →Perform gesture interactions
How it works
Uses accessibility-driven navigation and structured data to interact with Android applications.
Inputs & outputs
When to use android-emulator-skill
- →Building Android projects
- →Automating UI tests
- →Monitoring emulator logs
- →Navigating app UI automatically
About this skill
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 "[email protected]"
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
- Wrapper around
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
- Dump UI hierarchy using
-
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
- Launch apps (
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.shon macOS/Linux andemu_health_check.ps1on Windows - Check ADB, Emulator, Java, Gradle, ANDROID_HOME
- List connected devices
- Use
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.
When not to use it
- →Pixel-coordinate based testing
- →Non-Android environments
Prerequisites
Limitations
- →Requires Android SDK Platform-Tools
- →Concise default output
How it compares
Uses semantic navigation (text, resource-id) instead of fragile pixel coordinates.
Compared to similar skills
android-emulator-skill side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| android-emulator-skill (this skill) | 0 | 4mo | Review | Intermediate |
| android-kotlin | 7 | 4mo | No flags | Intermediate |
| testing-android-code | 6 | 3mo | No flags | Intermediate |
| trail-sense-android-tests | 1 | 2mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
android-kotlin
alinaqi
Android Kotlin development with Coroutines, Jetpack Compose, Hilt, and MockK testing
testing-android-code
bitwarden
This skill should be used when writing or reviewing tests for Android code in Bitwarden. Triggered by "BaseViewModelTest", "BitwardenComposeTest", "BaseServiceTest", "stateEventFlow", "bufferedMutableSharedFlow", "FakeDispatcherManager", "expectNoEvents", "assertCoroutineThrows", "createMockCipher", "createMockSend", "asSuccess", "Why is my Bitwarden test failing?", or testing questions about ViewModels, repositories, Compose screens, or data sources in Bitwarden.
trail-sense-android-tests
kylecorry31
Add UI automation tests to Trail-Sense Android app using AutomationLibrary. Use when asked to create, add, write, or implement automated tests, UI tests, integration tests, or androidTests for Trail Sense tools. Covers test class structure, AutomationLibrary functions, and testing patterns.
build-iphone-apps
glittercowboy
Build professional native iPhone apps in Swift with SwiftUI and UIKit. Full lifecycle - build, debug, test, optimize, ship. CLI-only, no Xcode. Targets iOS 26 with iOS 18 compatibility.
run-device-tests
dotnet
Build and run .NET MAUI device tests locally with category filtering. Supports iOS, MacCatalyst, Android on macOS; Android, Windows on Windows. Use TestFilter to run specific test categories.
agent-device
callstackincubator
Automates mobile and simulator interactions for iOS and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, pinching, or extracting UI info on mobile devices or simulators.