kmp-android-cli

Integrates Google's official android CLI with Kotlin Multiplatform project module graphs and CI pipelines.

2|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/ronjunevaldoz/kmp-agent-skills --skill kmp-android-cli-ronjunevaldoz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kmp-android-cli
Source: https://github.com/ronjunevaldoz/kmp-agent-skills/tree/main/skills/kmp-android-cli
Command: npx skills add https://github.com/ronjunevaldoz/kmp-agent-skills --skill kmp-android-cli-ronjunevaldoz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying Google's official android CLI to a Kotlin Multiplatform project is confusing because the CLI's examples assume a single-module Android app, while a KMP project has a multi-module 6-layer graph. This Skill explains which CLI commands apply to a KMP project, which do not (like android create), and how to wire the CLI into CI. ## Core Features & Use Cases - KMP-aware CLI usage: Shows how to run android describe and android run against the Android target inside a multi-module KMP graph instead of guessing APK output paths. - Boundary guidance: Clarifies that android create must not be used on an already-scaffolded KMP project, and defers all command syntax to the official upstream android-cli skill. - CI wiring: Provides a GitHub Actions smoke-test workflow using emulator creation, SDK installation, and instrumented tests without Android Studio dependencies. - Use Case: You scaffolded a KMP app and want to deploy the Android target to an emulator from the terminal. This Skill tells you to run android describe to locate the APK, then android run to deploy and launch it. ## Quick Start Ask the agent to locate the Android target's APK in your KMP project with android describe and deploy it to a running emulator using android run.

Frequently Asked Questions about kmp-android-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a KMP Android target on an emulator from the terminal?▼

Run android describe with your KMP project root to get the exact APK output path, then pass that path to android run to deploy and launch. This replaces manually chaining gradlew installDebug with adb shell am start commands.

Should I use android create to add Android to a Kotlin Multiplatform project?▼

No. android create scaffolds a fresh Android-only project from a template and has no concept of a KMP multi-module graph. Use a KMP feature-scaffold workflow to add the Android target to an existing project instead.

Does the android CLI work in CI without Android Studio?▼

Yes, the stable commands like android emulator, android sdk, describe, and run work headless in CI runners. The android studio subcommands require a running Android Studio instance, so gate them behind android studio check or avoid them in CI.

Where is the official android CLI command reference documented?▼

The canonical reference is the official android-cli skill maintained by Google at github.com/android/skills, installable via android skills add android-cli. This Skill intentionally defers all flag syntax to that upstream source to avoid stale copies.

Why is my guessed APK output path wrong in a KMP project?▼

APK output paths inside multi-module Gradle builds are not guaranteed stable across AGP versions. Always read the path from android describe output instead of hardcoding androidApp/build/outputs/apk/debug paths.