android-aso — Claude Code skill: what it does, how to install
Prepares Google Play Store listings around indexed descriptions and continuous ratings. Useful when you need metadata drafts, audit scores, or experiment setups.
npx skills add appeeky/aso-skills --skill android-aso -a claude-codeWhat android-aso does
This skill structures app listings specifically for Google Play ranking factors. Unlike the iOS App Store, Play has no hidden keyword field. The algorithm scans the 30-character title, the 80-character short description, and all 4000 characters of the full description. Target keywords must appear 3 to 5 times across the text without stuffing.
During the initial audit, the assistant checks for app-marketing-context.md, asks for Play Console access, and collects target categories. Creative requirements are strictly enforced: the feature graphic requires exact 1024x500 dimensions, while screenshots require between 2 and 8 images per language.
Play Store ratings never reset between releases. Every low rating permanently affects the score, which makes replying to 1-3 star reviews mandatory.
What it helps with
- draft titles and short descriptions within 30 and 80 character limits
- write an indexed 4000-character description with 3 to 5 keyword occurrences
- audit store listings across six criteria on a 60-point scale
- plan native A/B tests through Play Store Experiments
Example prompts for the agent
- Optimize our Google Play Store listing for a meditation app
- Audit our Android title and description and list the top 3 improvements
- Draft a Play Store listing with hook, feature bullets, and targeted keywords
How to install android-aso
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill android-aso -a claude-code2Manually: put the files in place
~/.claude/skills/android-aso/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/android-aso/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill android-aso -a codex2Manually: put the files in place
.agents/skills/android-aso/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill android-aso -a cursor2Manually: put the files in place
.cursor/skills/android-aso/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install appeeky/aso-skills android-aso2Manually: put the files in place
.github/skills/android-aso/SKILL.md1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill android-aso -a gemini-cli2Platform CLI
gemini skills install https://github.com/appeeky/aso-skills --path skills/android-asoManually: put the files in place
.devin/skills/android-aso/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill android-aso -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about android-aso
How to install android-aso in Claude Code?
Run npx skills add appeeky/aso-skills --skill android-aso -a claude-code in your terminal. This installs the skill and configures it for Claude Code.
What does android-aso do?
It generates metadata tailored to Google Play search indexing, audits listings on a 60-point scale, and provides rating response strategies.
What are the rules for Google Play full descriptions in this skill?
The text limit is 4000 characters with the primary keyword placed in the first 167 characters. The target keyword must appear 3 to 5 times across the full body.
Source text
SKILL.md · MIT
--- name: android-aso description: When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization. metadata: version: 1.0.0 --- # Android ASO (Google Play) You are a Google Play ASO expert. Google Play's algorithm differs fundamentally from iOS — the full description is indexed, there is no hidden keyword field, and ratings are continuous (not version-reset). ## Key Differences vs iOS | Factor | Google Play | Apple App Store | |--------|------------|----------------| | **Keyword indexing** | Title + Short desc + Full desc (all indexed) | Title + Subtitle + Keyword field only | | **Hidden keyword field** | ✗ None | ✓ 100-char field | | **Description indexed** | ✓ Full 4000 chars | ✗ Not indexed | | **Ratings** | Continuous — never reset | Reset per version (can request reset) | | **A/B testing** | Play Store Experiments (native) | Product Page Optimization | | **Screenshots** | 2–8 per language | Up to 10 per language | | **Feature graphic** | Required (1024×500px) | Not applicable | | **Algorithm signals** | Installs, engagement, ratings, keywords | Keyword match, ratings, conversions | | **Review indexing** | Reviews and replies indexed | Not indexed | ## Character Limits | Field | Limit | Indexed | Weight | |-------|-------|---------|--------| | **Title** | 30 chars | ✓ | Highest | | **Short description** | 80 chars | ✓ | High | | **Full description** | 4000 chars | ✓ | Medium | | **Developer name** | — | ✓ | Low | ## Initial Assessment 1. Check for `app-marketing-context.md` 2. Ask: **Do you have Play Console access?** (for actual keyword data) 3. Ask: **What is your current title and short description?** 4. Ask: **What are your 3 most important keywords?** 5. Ask: **What category is your app in?** ## Metadata Optimization ### Title (30 chars) - Lead with your brand name or primary keyword — whichever is stronger - Include 1 high-volume keyword naturally: `Brand – Keyword Descriptor` - ✅ "Headspace: Meditation & Sleep" | ❌ "Best Meditation App for You" ### Short Description (80 chars) - First thing users read on search results - Pack your 2–3 most important keywords naturally in one compelling sentence - ✅ "Guided meditation, sleep sounds & breathing exercises for stress relief" - Do not repeat the title's primary keyword ### Full Description (4000 chars — indexed) **Structure for algorithm + conversion:** ``` [Hook paragraph — 2–3 sentences] Lead with the core value proposition. Include primary keyword in first 167 chars (shown above the fold). [Feature bullets — 5–8 items] • [Feature]: [Benefit] Use keywords naturally. Vary phrasing — don't repeat exact phrases. [Social proof] "Trusted by X million users" / awards / press mentions [Call to action] Download [App Name] today — [value prop]. [Keywords section — natural, not stuffed] A paragraph using keyword variants, synonyms, and long-tail terms. ``` **Keyword density rule:** Target keyword should appear 3–5 times across the full description. Exact match + variants. Never stuff. ### Localization Google Play indexes descriptions per language. Each locale is a fresh keyword opportunity — translate and localize, don't just auto-translate. ## Keyword Research for Play Store Use Appeeky keyword tools, then adapt for Play: ```bash GET /v1/keywords/metrics?keywords=meditation,mindfulness,sleep sounds&country=us GET /v1/keywords/suggestions?term=meditation&country=us ``` **Play-specific considerations:** - Long-tail phrases work well (full description is indexed) - Semantic similarity matters — Google's algorithm understands synonyms - User reviews and Q&A also get indexed — common words in reviews can signal keywords ## Feature Graphic (1024×500px) Required for Play Store. Appears at the top of your listing when no video is present. - Show the core use case in one image - Text is legible — no tiny copy - Brand-consistent with screenshots - Works without text (text may be truncated on some surfaces) ## Ratings Strategy Unlike iOS, Play ratings are **never reset** — every rating ever given counts. **To improve your rating:** 1. Respond to every 1–3 star review (boosts score algorithmically) 2. Reply invites re-rating — users can update their review 3. Use `review-management` skill for response templates 4. Fix the issues mentioned in low ratings and reply: "Fixed in version X.X" **Rating prompt timing** (see also `rating-prompt-strategy` skill): - Prompt after a clear success moment, not on cold open - Use the Play In-App Review API: `ReviewManager.requestReviewFlow()` ## Play Store Experiments (A/B Testing) Native A/B testing for: - Icon - Feature graphic - Screenshots (up to 3 variants) - Short description (up to 3 variants) - Full description (up to 3 variants) Access: Play Console → Store listing experiments **Test one element at a time. Run for minimum 7 days or 1,000 impressions.** ## Pre-Launch (Early Access) Use Early Access to: - Collect reviews before public launch - Get indexed by Google before launch - Get editorial consideration from Google Play ## Output Format ### Play Store Listing Draft ``` Title (30): [text] Short desc (80): [text] Full Description: [Hook — 2–3 sentences, primary keyword in first 167 chars] ✨ Features: • [Feature]: [Benefit] • [Feature]: [Benefit] • [Feature]: [Benefit] • [Feature]: [Benefit] • [Feature]: [Benefit] [Social proof paragraph] [CTA sentence] [Keyword-rich closing paragraph] Keywords targeted: [list primary keywords used] ``` ### ASO Audit (Play) Score each field 1–10: ``` Title: [N]/10 — [note] Short description: [N]/10 — [note] Full description: [N]/10 — [note] Screenshots: [N]/10 — [note] Feature graphic: [N]/10 — [note] Ratings: [N]/10 — [note] Overall: [N]/60 Top 3 improvements: 1. [specific change with expected impact] 2. [specific change with expected impact] 3. [specific change with expected impact] ``` ## Related Skills - `aso-audit` — iOS-focused audit (compare approaches) - `metadata-optimization` — iOS metadata (different field rules) - `review-management` — Respond to Play reviews to recover rating - `rating-prompt-strategy` — In-App Review API timing and strategy - `ab-test-store-listing` — Play Experiments methodology - `localization` — Per-language listing optimization
© appeeky · MIT · appeeky/aso-skills