SkillAgentSearch skills...

developer-device-platform-device-run

Runs automated, non-interactive jobs on remote Android devices with Developer Device Platform (DDP) Device Run using `gcloud beta device-run sessions`: native Android executables or shell scripts (for example CLI tools, custom runners, test harnesses or benchmarks) and Android instrumentation tests,…

Install / Use

npx skills add google/skills --skill developer-device-platform-device-run

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

90/100

Category

Automation

Supported Platforms

Universal

Tags

Our assessment of developer-device-platform-device-run

developer-device-platform-device-run scores 90/100 on our quality scale, 1181st of 2,790 Automation skills we index (top 43%).

Its SKILL.md is 11 KB long, well organised into 9 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 20,340 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
13/20
Description
15/15
Adoption
18/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so developer-device-platform-device-run is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

developer-device-platform-device-run compared with similar skills

All 4 of these similar skills score higher than developer-device-platform-device-run; compare them before choosing.

SkillScoreStarsUpdatedFormat
developer-device-platform-device-run (this skill)by google9020.3k54d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install developer-device-platform-device-run?
Run npx skills add google/skills --skill developer-device-platform-device-run. The install tabs above show the steps for each supported agent.
Which AI agents does developer-device-platform-device-run work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is developer-device-platform-device-run safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is developer-device-platform-device-run still maintained?
The repository was last updated about 2 months ago, so developer-device-platform-device-run is actively maintained.

name: developer-device-platform-device-run description: >- Runs automated, non-interactive jobs on remote Android devices with Developer Device Platform (DDP) Device Run using gcloud beta device-run sessions: native Android executables or shell scripts (for example CLI tools, custom runners, test harnesses or benchmarks) and Android instrumentation tests, on one or many devices, then waits for completion and collects per-device outputs and logs. Use when running a binary or test suite on remote devices without an interactive connection. Don't use it for interactive device reservations, adb tunnels or screen streaming (use developer-device-platform-basics), or for local devices. metadata: version: "1.0.0" category: CloudInfrastructureAndServices

Developer Device Platform: Device Run

Device Run executes a job on remote DDP devices and returns its artifacts (logs, pulled files) to a Cloud Storage bucket. One session fans out to one job per requested device.

[!WARNING] Developer Device Platform (DDP) is currently in Preview. The gcloud beta device-run commands might change without notice.

When to use this skill

The user wants to... | Use :--------------------------------------------------------- | :-- Run a native binary or shell script on remote devices | This skill (android-executable) Run an Android instrumentation test APK on remote devices | This skill (instrumentation) Reserve a device, connect with adb, stream the screen | developer-device-platform-basics Extend or cancel an interactive device lease | developer-device-platform-basics Work with a device connected over USB | Neither (not DDP)

The setup below is complete; this skill doesn't depend on another skill for authentication, project selection or API enablement.

Requests this skill does not handle

For interactive use (reserve a device, adb, screen streaming, leases):

  • If developer-device-platform-basics is installed: do not submit a Device Run session; switch to developer-device-platform-basics, and note that interactive reservations are also billed to the active project.
  • If developer-device-platform-basics is not installed: reply in a single message without calling any tools (no commands, searches, file reads or scheduling), then stop:
    1. Say that Device Run is for non-interactive batch jobs, so you will not submit a Device Run session.
    2. Point the user to an interactive Device Streaming reservation with the developer-device-platform-basics skill (or https://docs.cloud.google.com/device-streaming/docs/overview.md.txt), and suggest installing the skill.
    3. Warn that an interactive reservation is also billed to the active Google Cloud project.

Keep answers fast

Prefer this skill and gcloud beta device-run ... --help over broad web searches for Device Run syntax. If gcloud or the beta component is not installed, fall back to the official documentation at https://docs.cloud.google.com/developer-device-platform/device-run.md.txt and https://docs.cloud.google.com/sdk/gcloud/reference/beta/device-run. For dry runs, show the commands instead of running them.

Usage Attribution

MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read and follow the instructions in Usage Attribution.

Setup

Run these checks once per environment. Do not assume tools are installed, and do not install or update software without the user's approval.

  1. gcloud CLI: Check that gcloud is installed and has Device Run commands:

    gcloud --version
    gcloud beta device-run sessions submit android-executable --help >/dev/null
    

    If gcloud is missing, point the user to https://docs.cloud.google.com/sdk/docs/install-sdk.md.txt. If the beta component or the Device Run commands are missing, ask the user before running gcloud components install beta or gcloud components update.

  2. Authentication: Check the active account. On a Compute Engine or other remote VM, the active account may be the VM's default service account (...@...iam.gserviceaccount.com), which often lacks the scopes Device Run and billing calls need (No service account scopes specified). If there is no active account, or only such a service account, ask the user to sign in. --update-adc also updates Application Default Credentials in the same flow; add --no-launch-browser in SSH or remote terminals:

    gcloud auth list --filter=status:ACTIVE --format="value(account)"
    gcloud auth login --update-adc
    
  3. Project: Use the user's active project, or the one they name. Never hardcode a project, and don't change the active project without asking.

    export PROJECT_ID=$(gcloud config get project)
    # Only if the user asks to switch:
    gcloud config set project PROJECT_ID
    
  4. Billing: Device Run is billed to the project. Check that billing is enabled; if it isn't, stop and tell the user.

    gcloud billing projects describe "${PROJECT_ID}" \
      --format="value(billingEnabled)"
    
  5. Enable the Device Run API (if not already enabled; ask first):

    gcloud services enable devicerun.googleapis.com --project="${PROJECT_ID}"
    
  6. IAM roles: The user needs roles/devicerun.admin, roles/serviceusage.serviceUsageConsumer and roles/viewer on the project. To read inputs from a bucket in another project, grant the DDP service agent roles/storage.objectViewer on that bucket (see https://docs.cloud.google.com/developer-device-platform/device-run/share-storage.md.txt).

  7. Bucket: Sessions store inputs and outputs in Cloud Storage. Without --bucket-name, gcloud uses or creates gs://${PROJECT_ID}-devicerun. For project IDs that contain :, . or google, gcloud replaces them (with -, - and elgoog) before adding -devicerun; read the actual bucket from the Result files URI printed by submit or describe. A bucket named explicitly with --bucket-name MUST already exist. Pass the bucket name only (no gs://, no path). Inputs and outputs under gs://<bucket>/automation/ are kept until you delete them or a Cloud Storage lifecycle rule expires them, and storage is billed meanwhile.

Core workflow

  1. Pick devices. Users usually name devices the way they are sold ("Pixel 10", "Galaxy S22"), while --device needs a catalog ID such as frankel-36 (codename + Android API level). Resolve names to IDs from the live catalog with device_selection.md; never guess an ID from memory. If a device is offered on several Android versions and the user didn't name one, list the versions, recommend one, and let the user pick one, several (one job each) or all; never pick silently. Before submitting, show the user the resolved ID, the device name and the Android version, and call out any other choice you made for them (physical vs virtual, variant).

  2. Stage inputs. --executable, --test, --target-app and the source side of --other-files-to-push accept gs:// paths or local paths. Local files are uploaded automatically into a fresh automation/inputs/<timestamp>/ folder, so prefer local paths for files that change between runs (scripts, freshly built binaries). Upload large, reused files (models, datasets) to the bucket once and reference them by gs:// path.

  3. Confirm cost. Explicit user confirmation required. Device Run sessions are billed to the active Google Cloud project. Before submitting, tell the user the project (${PROJECT_ID}), the devices, the number of jobs, and the timeout, warn that this incurs charges, and STOP until they approve. Include this billing warning in every answer that shows a submit command, even when you only explain the steps or the user will run the command themselves.

  4. Submit. Pick the submit type:

  5. Wait. For runs longer than a few minutes, submit with --async and follow session_lifecycle.md.

  6. Collect results. Download and map artifacts to devices with results.md.

  7. Report one row per device: device ID, job folder (job-NNN), result, key outputs, and the gs:// path of the session folder. Call out failed, timed-out or cancelled jobs explicitly instead of dropping them.

Rules

  • Always set the timeout. --executable-timeout (or --instrumentation-timeout) defaults to 5m; the valid range is 1m to 3h. Estimate the run time and set it explicitly.
  • Arguments are comma-separated. Each element of --executable-args becomes one argument. Rewrite space-separated command lines. If a value contains a comma, use the ^SEP^ prefix (see android_executable.md).
  • No shell in the direct call. With a binary as --executable there is no shell: set environment variables with --executable-env-vars, not export.
  • Do not overwrite shared inputs. DDP fetches inputs when a job starts. Never overwrite a gs:// script or binary that a pending session uses; use local paths (auto-uploaded) or a unique gs:// path per run.
  • Label sessions with --labels (for example purpose=smoke,build=1234) so they are easy to find later.
  • Poll politely. Never poll in a tight loop; poll every 30 to 60 seconds and report progress (see session_lifecycle.md).
  • Cancel on request. If the user wants to stop, cancel the session (see session_lifecycle.md) and tell the user it was cancelled.
  • Do not use the Device Streaming API (devicestreaming.googleapis.com, deviceSessions) to run batch jobs; that is for interactive leases.

Reference index

Related Skills

View on GitHub
GitHub Stars20.3k
CategoryAutomation
Updated1mo ago
Forks1.7k

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions