About

Imported from krutikjain/android-agent-skills (skills/android-emulator-automation/SKILL.md). Install upstream with npx skills add krutikjain/android-agent-skills --skill android-emulator-automation. Copyright stays with the author.

Android Emulator Automation

Name: android-emulator-automation
Author: krutikjain

When To Use

Use this skill when the request is about: android emulator automation, adb semantic ui automation, uiautomator dump and tap.
Primary outcome: Use semantic ADB and UIAutomator workflows to inspect, launch, and interact with Android apps from agents.
Reach for this skill when an agent needs to launch an APK, inspect the current screen, or perform a deterministic interaction without writing Espresso or Compose UI tests.
Handoff skills when the scope expands:
android-testing-ui
android-permissions-activity-results

Workflow

Verify the Android SDK, adb, the target device or emulator, and boot completion before attempting interaction.
Install or launch the target app with explicit package awareness so the request stays tied to the right artifact.
Dump the current UI hierarchy and prefer semantic selectors such as text, content description, or resource ID over raw coordinates.
Perform the smallest interaction that proves the workflow and re-dump the screen when state changes matter.
Hand off long-lived regression coverage to UI tests once the automation path is understood.

Guardrails

Prefer semantic selectors to pixel coordinates; only fall back to coordinates when the UI tree is missing the required metadata.
Treat automation as an inspection and smoke tool, not a replacement for deterministic UI tests.
Verify device state, package name, and boot completion before issuing input commands.
Keep the scripts safe for CI by avoiding destructive shell commands or device-wide settings changes.

Anti-Patterns

Hard-coding coordinates when text or resource IDs are available.
Running emulator commands before the device is boot-complete.
Treating flaky one-off automation as proof of a stable UI workflow.
Mixing app install, interaction, and log scraping into one opaque script with no intermediate output.

Examples

Happy path

Scenario: Build the Compose fixture, install it on an emulator, and dump the current OrbitTasks screen.
Command: bash skills/android-emulator-automation/scripts/run_examples.sh

Edge case

Scenario: Launch a preinstalled app and target a single semantic control without relying on screen coordinates.
Command: python3 skills/android-emulator-automation/scripts/navigator.py --find-text "Blocked" --tap

Failure recovery

Scenario: Confirm the device is discoverable and UIAutomator can dump the hierarchy before chasing a selector bug.
Command: python3 skills/android-emulator-automation/scripts/device_health.py --json

Done Checklist

The target package, device serial, and current screen are explicit.
Semantic selectors were preferred over coordinates.
The automation path is reproducible in local development and CI.
The request hands off to UI testing when the workflow needs regression coverage.

Official References

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/krutikjain-android-agent-skills-android-emulator-automation/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

krutikjain-android-agent-skills-android-emulator-automation.ocm.jsonjson

{
  "ocm": "1",
  "id": "krutikjain-android-agent-skills-android-emulator-automation",
  "kind": "skill",
  "name": "android-emulator-automation",
  "description": "Use semantic ADB and UIAutomator workflows to inspect, launch, and interact with Android apps from agents.",
  "publisher": "krutikjain",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "android",
      "adb",
      "uiautomator",
      "emulator",
      "automation",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use semantic ADB and UIAutomator workflows to inspect, launch, and interact with Android apps from agents."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/krutikjain/android-agent-skills",
      "path": "skills/android-emulator-automation/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/krutikjain/android-agent-skills/blob/HEAD/skills/android-emulator-automation/SKILL.md",
      "key": "krutikjain/android-agent-skills/skills/android-emulator-automation/SKILL.md"
    }
  },
  "instructions": "# Android Emulator Automation\n\n## When To Use\n- Use this skill when the request is about: android emulator automation, adb semantic ui automation, uiautomator dump and tap.\n- Primary outcome: Use semantic ADB and UIAutomator workflows to inspect, launch, and interact with Android apps from agents.\n- Reach for this skill when an agent needs to launch an APK, inspect the current screen, or perform a deterministic interaction without writing Espresso or Compose UI tests.\n- Handoff skills when the scope expands:\n- `android-testing-ui`\n- `android-permissions-activity-results`\n\n## Workflow\n1. Verify",
  "cost": {
    "context_tokens": 843
  }
}

Fetch it by URL: GET /api/v1/registry/krutikjain-android-agent-skills-android-emulator-automation/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.