Google Play Console CLI Skills

A collection of Agent Skills for shipping with the Google Play Console CLI (gplay). These skills are designed for zero-friction automation around Android builds, releases, metadata, in-app purchases, and signing.

Skills follow the Agent Skills format.

Installation

Install this skill pack:

npx skills add tamtom/gplay-cli-skills

Updating

Check for updates and pull the latest versions:

npx skills check          # check for available updates
npx skills update         # update all skills to latest versions

Available Skills

gplay-cli-usage

Guidance for running gplay commands (flags, pagination, output, auth).

Use when:

• You need the correct gplay command or flag combination
• You want JSON-first output and pagination tips for automation

gplay-gradle-build

Build, sign, and package Android apps with Gradle before uploading.

Use when:

• You need to create an APK or AAB for upload
• You're setting up CI/CD build pipelines
• You need to configure signing configs
• You're troubleshooting ProGuard/R8 issues

gplay-release-flow

End-to-end release workflows for internal, beta, and production tracks.

Use when:

• You want to upload, release, and rollout in one flow
• You need the manual sequence for fine-grained control
• You're releasing to multiple tracks

gplay-metadata-sync

Metadata and localization sync (including Fastlane format).

Use when:

• You are updating Play Store metadata or localizations
• You need to validate character limits before upload
• You need to sync with Fastlane directory structure

gplay-iap-setup

In-app products, subscriptions, base plans, offers, and bulk subscription localization.

Use when:

• You are setting up in-app purchases or subscriptions
• You need to create subscription offers or pricing
• You're managing monetization products
• You need to bulk-localize subscription display names/descriptions across locales

gplay-review-management

Review monitoring, filtering, and automated responses.

Use when:

• You want to monitor and respond to user reviews
• You need to filter reviews by rating or territory
• You're setting up automated review responses

gplay-rollout-management

Staged rollout orchestration and monitoring.

Use when:

• You want to release to a percentage of users first
• You need to halt, resume, or complete rollouts
• You're implementing gradual rollout strategies

gplay-purchase-verification

Server-side purchase verification for in-app products and subscriptions.

Use when:

• You need to verify purchase tokens from your backend
• You're implementing receipt validation
• You need to check subscription status

gplay-ppp-pricing

Region-specific pricing using purchasing power parity (PPP).

Use when:

• You want to set localized prices based on purchasing power per country
• You need PPP multipliers for IAPs or subscriptions across regions
• You're migrating existing subscribers to new regional prices

gplay-testers-orchestration

Beta testing groups and tester management.

Use when:

• You manage multiple testing groups
• You need to add/remove testers
• You're setting up closed testing tracks

gplay-migrate-fastlane

Fastlane metadata migration to gplay format.

Use when:

• You want to migrate from Fastlane supply to gplay CLI
• You need to import existing Fastlane metadata directories

gplay-preflight

Offline compliance and hygiene scanning of an AAB or APK — no credentials, no API calls. Nine scanners over a fully decoded AndroidManifest.xml.

Use when:

• You're about to upload a build and want to catch rejections first
• You need a CI gate that runs before any Play credentials are available
• You're diagnosing an install failure, a Play rejection, or a 16 KB page alignment problem

gplay-submission-checks

Pre-submission validation for Google Play releases.

Use when:

• You're preparing a release and want to catch issues before submitting
• You need to validate metadata, screenshots, bundle integrity, or policy compliance

gplay-screenshot-automation

Upload and validate Play Store screenshots with gplay.

Use when:

• You need to upload or replace screenshots across locales and device types
• You need to validate screenshot dimensions before a release

gplay-user-management

Developer account user and grant management.

Use when:

• You need to manage developer account users and permissions
• You need to create, update, or delete app-level permission grants

gplay-vitals-monitoring

App vitals monitoring for crashes, performance, and errors.

Use when:

• You need to check app stability, crash rates, or ANR rates
• You want to monitor startup, rendering, or battery performance metrics

gplay-reports-download

Financial and statistics report listing and downloading from GCS.

Use when:

• You need to list or download financial reports (earnings, sales, payouts)
• You need to download statistics reports (installs, ratings, crashes)
• You want to automate monthly report collection

Usage

Skills are automatically available once installed. The agent will use them when relevant tasks are detected.

Examples:

Build and upload my Android app to Google Play internal track

Release build v1.2.3 to production with 10% staged rollout

Set up in-app subscription with monthly and yearly base plans

Sync Fastlane metadata from ./metadata and upload to Play Store

Respond to all 1-star reviews from the last week

Download last month's earnings report for my developer account

Skill Structure

Each skill contains:

• SKILL.md - Instructions for the agent
• scripts/ - Helper scripts for automation (optional)
• references/ - Supporting documentation (optional)

Development

Every gplay command and flag used in a skill is validated against the CLI's generated command reference (GPLAY.md) so the skills can't drift from the real CLI surface:

# Validate against the current CLI on main
python3 scripts/check-commands.py

# Or against a local checkout of the CLI
python3 scripts/check-commands.py --reference ../play-console-cli/GPLAY.md

CI runs this on every push and pull request (.github/workflows/check-commands.yml).

License

MIT