Agent skill

Run Jetpack Android App

by wordpress-mobile in wordpress-mobile/WordPress-Android

Builds the Jetpack debug app with Gradle and installs it on a connected Android device or an emulator started from an available AVD.

GPL-2.0Auto-check passedMobile

Install Run Jetpack Android App

skills CLI
$ npx skills add wordpress-mobile/WordPress-Android --skill run-app -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wordpress-mobile/WordPress-Android run-app --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wordpress-mobile/WordPress-Android.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/run-app .claude/skills/run-app && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
run-app
GitHub stars
3.2k
Token cost
~886 tokens
SKILL.md length
409 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
GPL-2.0

At a glance

Builds the Jetpack debug app with Gradle and installs it on a connected Android device or an emulator started from an available AVD.

  • Works in 6 steps: Build the app → Check for connected devices → Determine which device to target → …
  • Running the Jetpack Android app on a connected phone or emulator
  • SKILL.md covers Steps and Important Rules
  • Calls adb

What it does

The default target is the Jetpack debug variant, built with `./gradlew assembleJetpackDebug`; the WordPress variant is built with `assembleWordPressDebug` only when you explicitly ask for it. The agent then lists devices with `adb devices -l`: one device is used automatically, several are shown for you to pick from, and none leads to the emulator path.

With no device connected, available AVDs are listed through `emulator -list-avds` and you choose one. The device list is saved before launch so the new emulator's serial can be identified afterward, the agent waits for the device, polls `sys.boot_completed` every two seconds until boot finishes, and suggests connecting a device or creating an AVD in Android Studio when none exists. Finally it finds the built APK dynamically, excluding androidTest builds, and installs it with `adb install -r`.

When your agent uses it

  • Running the Jetpack Android app on a connected phone or emulator
  • Launching the app after a code change to check it by hand
  • Starting an emulator when no device is attached

Example prompts

  • “Run the app on my emulator.”
  • “Build and launch the WordPress variant on my connected phone.”
  • “Launch the app on a device, and start an emulator if nothing is plugged in.”

Requirements

  • A checkout of the WordPress-Android repository with its Gradle wrapper
  • Android SDK tools `adb` and `emulator`
  • A connected device or at least one AVD

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Build the app
  2. Check for connected devices
  3. Determine which device to target
  4. Handle no connected devices
  5. Install and launch the app
  6. Report the result

What it can do on your machine

Read from SKILL.md and the folder at commit ceafcdc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • adb

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Run Jetpack Android App loads about 886 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 409 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~886

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wordpress-mobile/WordPress-Android at commit ceafcdc, republished under its GPL-2.0 licence (© wordpress-mobile). 409 words, ~886 tokens.

Download SKILL.mdSave it as .claude/skills/run-app/SKILL.md (or your agent's skills folder).
name
run-app
description
Build and run the Jetpack Android app on a device or emulator. This skill should be used when the user asks to run the app, launch the app, or invokes /run-app.

Run App

Build and run the Jetpack debug variant on a connected Android device or emulator. By default this skill builds and runs the Jetpack app. Only build the WordPress app if the user explicitly asks for it.

Steps

1. Build the app

By default, build the Jetpack debug variant:

bash
./gradlew assembleJetpackDebug

If the user explicitly asks for the WordPress app instead, run:

bash
./gradlew assembleWordPressDebug
2. Check for connected devices

List all connected/running devices and emulators:

bash
adb devices -l

Parse the output to identify running devices. Ignore the header line and any lines that do not contain a device serial.

3. Determine which device to target
  • One device connected: use it automatically.
  • Multiple devices connected: present the list to the user with AskUserQuestion and let them pick which device to use.
  • No devices connected: go to step 4.
4. Handle no connected devices

List available (offline) AVDs:

bash
emulator -list-avds
  • AVDs available: present the list to the user with AskUserQuestion and let them pick one. Before starting the emulator, snapshot the current device list so you can identify the new serial afterwards:

    bash
    adb devices -l          # snapshot before
    emulator -avd <avd_name> &
    adb wait-for-device

    After wait-for-device returns, poll until the device has finished booting:

    bash
    adb [-s <serial>] shell getprop sys.boot_completed

    Repeat every 2 seconds until the output is 1. Then run adb devices -l again and diff against the earlier snapshot to resolve the new emulator's serial for subsequent -s flags.

  • No AVDs available: warn the user that no devices or emulators are available and suggest they connect a device or create an AVD through Android Studio.

Show full SKILL.md (170 more words)Show less
5. Install and launch the app

Find the built APK dynamically (the exact filename may change across Gradle versions):

Jetpack (default):

bash
APK=$(find WordPress/build/outputs/apk/jetpack/debug \
  -name '*.apk' ! -name '*androidTest*' | head -1)

WordPress (only if the user explicitly requested it):

bash
APK=$(find WordPress/build/outputs/apk/wordpress/debug \
  -name '*.apk' ! -name '*androidTest*' | head -1)

Install the APK on the target device (use -s <serial> when multiple devices are present):

bash
adb [-s <serial>] install -r "$APK"

Then launch the app. The debug build type appends .prealpha to the application ID, so use the correct package name:

  • Jetpack debug: adb [-s <serial>] shell monkey -p com.jetpack.android.prealpha -c android.intent.category.LAUNCHER 1
  • WordPress debug: adb [-s <serial>] shell monkey -p org.wordpress.android.prealpha -c android.intent.category.LAUNCHER 1
6. Report the result

Tell the user whether the app was successfully installed and launched, or report any errors encountered during the process.

Important Rules

  • Always build before installing to ensure the APK is up to date.
  • When multiple devices are connected, NEVER pick one silently — always ask the user.
  • When starting an emulator, run it in the background so it does not block the agent.
  • If the build fails, report the error and do NOT attempt to install a stale APK.

© wordpress-mobile, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/run-app of wordpress-mobile/WordPress-Android.

Open the folder on GitHubat commit ceafcdc

Compare with similar skills

Run Jetpack Android App next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Run Jetpack Android App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Jetpack Android App this skillwordpress-mobile/WordPress-Android3.2k—~886Automated safety check: PassGPL-2.0
Orca Android Emulator Controlstablyai/orca87k—~558Automated safety check: PassApache-2.0
Android CLI (acli)ErikHellman/cli-for-android119—~709Automated safety check: PassMIT
Warpdroid UI TestWarp-net/warpnet157—~3.5kAutomated safety check: PassCustom licence
Capturing Preview Screenshots In CIskydoves/android-testing-skills333—~4.5kAutomated safety check: NotesApache-2.0
Android Debuggingrcosteira79/android-skills150—~2.6kAutomated safety check: PassMIT

Similar skills

  • Android device and emulator control from inside Orca over adb, with the live device view in Orca's emulator pane. Use when driving an adb-connected emulator…

    87k GitHub stars~558 tokensUpdated today
    MobileAuto-check passed
  • Android CLI (acli)

    ErikHellman/cli-for-android

    Drives Android devices, emulators, SDK packages and Gradle builds through the acli command, with JSON output and per-device targeting.

    119 GitHub stars~709 tokensUpdated 6 mo ago
    MobileAuto-check passed
  • Warpdroid UI Test

    Warp-net/warpnet

    A skill your agent uses whenever a warpdroid (Android client) change or bug needs to be verified by actually driving the app's visual UI — any task phrased as "test the warpdroid UI", "click through…

    157 GitHub stars~3.5k tokensUpdated today
    MobileAuto-check passed
  • Capturing Preview Screenshots In CI

    skydoves/android-testing-skills

    A skill your agent uses to render every Jetpack Compose @Preview as a screenshot on a real Android device or emulator and publish a browsable HTML catalog from CI.

    333 GitHub stars~4.5k tokensUpdated 4 mo ago
    MobileAuto-check: notes
  • Android Debugging

    rcosteira79/android-skills

    Android and KMP debugging techniques for crashes, ANRs, memory leaks, R8 traces, Gradle failures and Compose recomposition, built on finding the root cause first.

    150 GitHub stars~2.6k tokensUpdated 18 days ago
    MobileAuto-check passed
  • Android Dev

    OpenMinis/MinisSkills

    在 Minis 的 ARM64 Alpine PRoot 中从零诊断、安装并验证 Android 构建环境,以及创建、构建、签名验证、安装和启动原生 Android App;覆盖 Java/Kotlin/Gradle/SDK/AAPT2、APK、ADB/无线调试/Shizuku,以及条件式 JNI/NDK。用户提到 Android…

    440 GitHub stars~1.9k tokensUpdated 2 days ago
    MobileAuto-check passed

More from wordpress-mobile/WordPress-Android

  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    Auto-check: notes
  • Android Code Quality Checker

    wordpress-mobile/WordPress-Android

    Runs detekt, checkstyle, and Android lint together, reads their reports, and proposes approved fixes grouped by file.

    3.2k GitHub stars~587 tokensUpdated today
    Auto-check passed

Categories

Questions about Run Jetpack Android App

What does Run Jetpack Android App do?

Builds the Jetpack debug app with Gradle and installs it on a connected Android device or an emulator started from an available AVD. /gradlew assembleJetpackDebug`; the WordPress variant is built with `assembleWordPressDebug` only when you explicitly ask for it. The agent then lists devices with `adb devices -l`: one device is used automatically, several are shown for you to pick from, and none leads to the emulator path.

When should I use Run Jetpack Android App?

Run Jetpack Android App fits situations like: running the Jetpack Android app on a connected phone or emulator; launching the app after a code change to check it by hand; starting an emulator when no device is attached.

How do I install Run Jetpack Android App in Claude Code?

Run `npx skills add wordpress-mobile/WordPress-Android --skill run-app -a claude-code`. Or copy the skill folder (.claude/skills/run-app in wordpress-mobile/WordPress-Android) into .claude/skills/run-app in your project. Claude Code loads it when a task matches its description.

How do I install Run Jetpack Android App in Codex?

Run `npx skills add wordpress-mobile/WordPress-Android --skill run-app -a codex`. Or copy the skill folder (.claude/skills/run-app in wordpress-mobile/WordPress-Android) into .agents/skills/run-app in your project. Codex loads it when a task matches its description.

Can I use Run Jetpack Android App in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wordpress-mobile/WordPress-Android --skill run-app -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-app, .gemini/skills/run-app, .github/skills/run-app and .opencode/skills/run-app in your project.

What does Run Jetpack Android App need to run?

Going by SKILL.md and its folder, Run Jetpack Android App needs the command-line tools its instructions call (adb). Our summary lists: A checkout of the WordPress-Android repository with its Gradle wrapper; Android SDK tools `adb` and `emulator`; A connected device or at least one AVD.

Does Run Jetpack Android App access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run Jetpack Android App safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Run Jetpack Android App use?

Run Jetpack Android App is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Jetpack Android App use?

About 886 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Run Jetpack Android App?

Skills that share tags, products or a category with Run Jetpack Android App: Orca Android Emulator Control (stablyai/orca, 87k stars), Android CLI (acli) (ErikHellman/cli-for-android, 119 stars), Warpdroid UI Test (Warp-net/warpnet, 157 stars) and Capturing Preview Screenshots In CI (skydoves/android-testing-skills, 333 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Jetpack Android App?

wordpress-mobile (a GitHub organization) maintains it in wordpress-mobile/WordPress-Android, which has 3,153 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: wordpress-mobile/WordPress-Android on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.