Preflight Google Play releases, validate edits, and verify listing completeness with gpd. Use when shipping to production or troubleshooting a failed release.
Install
npx skillscat add rudrankriyam/app-store-connect-cli-skills/gpd-submission-health Install via the SkillsCat registry.
SKILL.md
GPD Submission Health
Use this skill to reduce Play Console submission failures and validate readiness.
Preconditions
- Auth configured and package name resolved.
- Build uploaded and available for the target track.
- Store listing metadata and assets updated.
Pre-submission checklist
1. Validate edit (if using edit lifecycle)
gpd publish edit validate EDIT_ID --package com.example.app2. Confirm release status
gpd publish status --package com.example.app --track productionCheck:
- Release status is expected (
draft,inProgress, orcompleted). - Version code matches the uploaded build.
3. Verify store listing metadata
gpd publish listing get --package com.example.app
gpd publish details get --package com.example.app4. Verify screenshots and assets
gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish assets spec5. Upload deobfuscation mapping (if needed)
gpd publish deobfuscation upload mapping.txt --package com.example.app --type proguard --version-code 123Submit to production
gpd publish release --package com.example.app --track production --status inProgress --version-code 123Common submission issues
Release not in valid state
Check:
- Version code uploaded and attached to the track.
- Edit validation passes.
- Required store listing fields present for all locales.
Missing screenshots or assets
Use:
gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish images upload icon icon.png --package com.example.app --locale en-USPolicy declarations not complete
Some policy/compliance items must be completed in Play Console UI. Confirm in the console if CLI operations pass but submission is blocked.
Notes
- Use
gpd publish edit validatebefore committing large changes. - Use
--dry-runwhere available before destructive actions.