Agent-Skills.md

Agent Skills: Android Store Listing

Create feature graphic and complete store listing metadata

UncategorizedID: hitoshura25/claude-devtools/android-store-listing

Repository

hitoshura25/claude-devtools
hitoshura25License: Apache-2.0
21

Install this agent skill to your local

pnpm dlx add-skill https://github.com/hitoshura25/claude-devtools/tree/HEAD/skills/android-store-listing

Skill Files

Browse the full folder contents for android-store-listing.

Download Skill

Loading file tree…

skills/android-store-listing/SKILL.md

Skill Metadata

Name
android-store-listing
Description
Create feature graphic and complete store listing metadata

Android Store Listing

Create feature graphic and complete store listing metadata for Google Play Store.

Prerequisites

  • /devtools:android-fastlane-setup completed
  • /devtools:android-app-icon completed (for icon assets)

Inputs

| Input | Required | Default | Description | |-------|----------|---------|-------------| | app_name | Yes | - | App name | | tagline | Yes | - | Short tagline for feature graphic | | primary_color | No | #6200EE | Primary brand color (hex) | | description | No | Template | Full app description |

Play Store Asset Requirements

| Asset | Dimensions | Format | Required | |-------|------------|--------|----------| | App Icon | 512 x 512 px | PNG | Yes | | Feature Graphic | 1024 x 500 px | PNG/JPEG | Yes | | Phone Screenshots | 320-3840 px (16:9 or 9:16) | PNG/JPEG | 2-8 required | | 7" Tablet Screenshots | 320-3840 px (16:9 or 9:16) | PNG/JPEG | Up to 8 | | 10" Tablet Screenshots | 320-3840 px (16:9 or 9:16) | PNG/JPEG | Up to 8 | | Promo Video | YouTube URL | - | Optional |

Process

Step 1: Generate Store Listing Guide

Create docs/STORE_LISTING_GUIDE.md with comprehensive instructions.

Step 2: Feature Graphic Creation Options

The feature graphic (1024 x 500 px) is displayed at the top of your Play Store listing.

Option A: Canva (Easiest)

  1. Go to canva.com
  2. Create custom design: 1024 x 500 px
  3. Search templates for "app feature graphic" or "banner"
  4. Customize with app name and colors
  5. Download as PNG

Option B: Figma (More Control)

  1. Open Figma Community Template
  2. Duplicate to your account
  3. Customize the feature graphic frame
  4. Export as PNG at 1x

Option C: Simple Python Script Use scripts/generate-feature-graphic.py to create a basic feature graphic:

python3 scripts/generate-feature-graphic.py "App Name" "Tagline" "#6200EE"

This creates a simple text-based graphic. For production, use Canva or Figma for a more polished result.

Step 3: Feature Graphic Best Practices

✅ Do:

  • Use high contrast text
  • Keep text minimal (3-5 words)
  • Show your app's primary screen
  • Use your brand colors
  • Leave space for Play Store overlay

❌ Don't:

  • Include pricing or "free" text
  • Use excessive text
  • Make it too busy/cluttered
  • Use low-resolution images

Step 4: Update Metadata Files

Ensure all metadata files exist in fastlane/metadata/android/en-US/:

title.txt (Max 30 characters)

Your App Name

short_description.txt (Max 80 characters)

Short tagline that highlights main benefit

full_description.txt (Max 4000 characters)

Full description of your app.

Key Features:
• Feature 1 description
• Feature 2 description
• Feature 3 description
• Feature 4 description

Why Choose This App?
Explain what makes your app unique and valuable.

Download now and start [doing something valuable]!

changelogs/default.txt (Max 500 characters)

• New: [Feature name]
• Improved: [Enhancement description]
• Fixed: [Bug fix description]

video.txt (Optional)

https://www.youtube.com/watch?v=YOUR_VIDEO_ID

Step 5: Asset Validation

Run validation checks:

# Check icon dimensions
file fastlane/metadata/android/en-US/images/icon.png
# Expected: PNG image data, 512 x 512

# Check feature graphic dimensions
file fastlane/metadata/android/en-US/images/featureGraphic.png
# Expected: PNG image data, 1024 x 500

# Check screenshot count
ls fastlane/metadata/android/en-US/images/phoneScreenshots/ | wc -l
# Expected: 2-8 files

# Check metadata character limits
wc -c fastlane/metadata/android/en-US/title.txt
# Must be <= 30 characters

wc -c fastlane/metadata/android/en-US/short_description.txt
# Must be <= 80 characters

wc -c fastlane/metadata/android/en-US/full_description.txt
# Must be <= 4000 characters

Multi-Language Support

To add additional languages:

# Create locale directory
mkdir -p fastlane/metadata/android/de-DE/images/phoneScreenshots
mkdir -p fastlane/metadata/android/de-DE/changelogs

# Copy and translate metadata files
cp fastlane/metadata/android/en-US/*.txt fastlane/metadata/android/de-DE/
# Edit files with German translations

# Update Screengrabfile to capture additional locales
# In fastlane/Screengrabfile:
# locales(["en-US", "de-DE"])

# Run screenshot automation for all locales
bundle exec fastlane screenshots

Uploading to Play Store

Once all assets are ready:

# Upload metadata only (no build)
bundle exec fastlane upload_metadata

# Upload screenshots only
bundle exec fastlane upload_screenshots

# Full release (includes everything)
bundle exec fastlane deploy_internal

Verification

MANDATORY: Run these commands:

# Check all metadata files exist
ls -la fastlane/metadata/android/en-US/

# Check images exist
ls -la fastlane/metadata/android/en-US/images/

# Validate feature graphic
file fastlane/metadata/android/en-US/images/featureGraphic.png
# Should be: PNG image data, 1024 x 500

# Test metadata upload (dry run)
# bundle exec fastlane upload_metadata --skip_upload_images

Completion Criteria

  • [ ] docs/STORE_LISTING_GUIDE.md created with full instructions
  • [ ] Feature graphic at fastlane/metadata/android/en-US/images/featureGraphic.png
  • [ ] Feature graphic is 1024x500 PNG
  • [ ] All metadata files in fastlane/metadata/android/en-US/:
    • [ ] title.txt (max 30 chars)
    • [ ] short_description.txt (max 80 chars)
    • [ ] full_description.txt (max 4000 chars)
    • [ ] changelogs/default.txt
    • [ ] video.txt (empty is OK)

Outputs

| Output | Location | Description | |--------|----------|-------------| | Store listing guide | docs/STORE_LISTING_GUIDE.md | Complete setup instructions | | Feature graphic | fastlane/metadata/android/en-US/images/featureGraphic.png | 1024x500 banner | | Title | fastlane/metadata/android/en-US/title.txt | App title | | Short description | fastlane/metadata/android/en-US/short_description.txt | 80 char tagline | | Full description | fastlane/metadata/android/en-US/full_description.txt | Complete description | | Changelogs | fastlane/metadata/android/en-US/changelogs/default.txt | Release notes |

Troubleshooting

"Metadata upload fails"

Cause: Character limits exceeded or invalid format Fix: Validate all text files with wc -c

"Feature graphic rejected"

Cause: Wrong dimensions or contains prohibited content Fix: Ensure exactly 1024x500, no pricing/ratings/review text

"Screenshots not showing"

Cause: Wrong format or dimensions Fix: Ensure PNG/JPEG, min 320px, aspect ratio 16:9 or 9:16

Next Steps

After completing this skill:

  1. Review all metadata for accuracy and appeal
  2. Run /devtools:android-workflow-internal to setup deployment
  3. Upload to Play Store: bundle exec fastlane deploy_internal