marketing-skill/skills/app-store-optimization/SKILL.md
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
npx skillsauth add alirezarezvani/claude-skills app-store-optimizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Discover and evaluate keywords that drive app store visibility.
| Factor | Weight | High Score Indicators | |--------|--------|----------------------| | Relevance | 35% | Describes core app function | | Volume | 25% | 10,000+ monthly searches | | Competition | 25% | Top 10 apps have <4.5 avg rating | | Conversion | 15% | Transactional intent ("best X app") |
| Location | Search Weight | |----------|---------------| | App Title | Highest | | Subtitle (iOS) | High | | Keyword Field (iOS) | High | | Short Description (Android) | High | | Full Description | Medium |
See: references/keyword-research-guide.md
Optimize app store listing elements for search ranking and conversion.
[Brand Name] - [Primary Keyword] [Secondary Keyword]
| Field | Apple App Store | Google Play Store | |-------|-----------------|-------------------| | Title | 30 characters | 50 characters | | Subtitle | 30 characters | N/A | | Short Description | N/A | 80 characters | | Keywords | 100 characters | N/A | | Promotional Text | 170 characters | N/A | | Full Description | 4,000 characters | 4,000 characters | | What's New | 4,000 characters | 500 characters |
PARAGRAPH 1: Hook (50-100 words)
├── Address user pain point
├── State main value proposition
└── Include primary keyword
PARAGRAPH 2-3: Features (100-150 words)
├── Top 5 features with benefits
├── Bullet points for scanability
└── Secondary keywords naturally integrated
PARAGRAPH 4: Social Proof (50-75 words)
├── Download count or rating
├── Press mentions or awards
└── Summary of user testimonials
PARAGRAPH 5: Call to Action (25-50 words)
├── Clear next step
└── Reassurance (free trial, no signup)
See: references/platform-requirements.md
Analyze top competitors to identify keyword gaps and positioning opportunities.
| Analysis Area | Data Points | |---------------|-------------| | Keywords | Title keywords, description frequency | | Metadata | Character utilization, keyword density | | Visuals | Icon style, screenshot count/style | | Ratings | Average rating, total count, velocity | | Reviews | Top praise, top complaints |
| Opportunity Type | Example | Action | |------------------|---------|--------| | Keyword gap | "habit tracker" (40% coverage) | Add to keyword field | | Feature gap | Competitor lacks widget | Highlight in screenshots | | Visual gap | No videos in top 5 | Create app preview | | Messaging gap | None mention "free" | Test free positioning |
Execute a structured launch for maximum initial visibility.
| Category | Items | |----------|-------| | Metadata | Title, subtitle, description, keywords | | Visual Assets | Icon, screenshots (all sizes), video | | Compliance | Age rating, privacy policy, content rights | | Technical | App binary, signing certificates | | Analytics | SDK integration, event tracking | | Marketing | Press kit, social content, email ready |
| Factor | Recommendation | |--------|----------------| | Day of week | Tuesday-Wednesday (avoid weekends) | | Time of day | Morning in target market timezone | | Seasonal | Align with relevant category seasons | | Competition | Avoid major competitor launch dates |
See: references/aso-best-practices.md
Test metadata and visual elements to improve conversion rates.
If we [change], then [metric] will [improve/increase] by [amount]
because [rationale].
| Element | Conversion Impact | Test Complexity | |---------|-------------------|-----------------| | App Icon | 10-25% lift possible | Medium (design needed) | | Screenshot 1 | 15-35% lift possible | Medium | | Title | 5-15% lift possible | Low | | Short Description | 5-10% lift possible | Low | | Video | 10-20% lift possible | High |
| Baseline CVR | Impressions Needed (per variant) | |--------------|----------------------------------| | 1% | 31,000 | | 2% | 15,500 | | 5% | 6,200 | | 10% | 3,100 |
TEST ID: ASO-2025-001
ELEMENT: App Icon
HYPOTHESIS: A bolder color icon will increase conversion by 10%
START DATE: [Date]
END DATE: [Date]
RESULTS:
├── Control CVR: 4.2%
├── Treatment CVR: 4.8%
├── Lift: +14.3%
├── Significance: 97%
└── Decision: Implement treatment
LEARNINGS:
- Bold colors outperform muted tones in this category
- Apply to screenshot backgrounds for next test
Productivity App:
| Version | Title | Analysis | |---------|-------|----------| | Before | "MyTasks" | No keywords, brand only (8 chars) | | After | "MyTasks - Todo List & Planner" | Primary + secondary keywords (29 chars) |
Fitness App:
| Version | Title | Analysis | |---------|-------|----------| | Before | "FitTrack Pro" | Generic modifier (12 chars) | | After | "FitTrack: Workout Log & Gym" | Category keywords (27 chars) |
| Version | Subtitle | Analysis | |---------|----------|----------| | Before | "Get Things Done" | Vague, no keywords | | After | "Daily Task Manager & Planner" | Two keywords, benefit clear |
Before (Inefficient - 89 chars, 8 keywords):
task manager, todo list, productivity app, daily planner, reminder app
After (Optimized - 97 chars, 14 keywords):
task,todo,checklist,reminder,organize,daily,planner,schedule,deadline,goals,habit,widget,sync,team
Improvements:
Before:
MyTasks is a comprehensive task management solution designed
to help busy professionals organize their daily activities
and boost productivity.
After:
Forget missed deadlines. MyTasks keeps every task, reminder,
and project in one place—so you focus on doing, not remembering.
Trusted by 500,000+ professionals.
Improvements:
| Version | Caption | Issue | |---------|---------|-------| | Before | "Task List Feature" | Feature-focused, passive | | Better | "Create Task Lists" | Action verb, but still feature | | Best | "Never Miss a Deadline" | Benefit-focused, emotional |
| Script | Purpose | Usage |
|--------|---------|-------|
| keyword_analyzer.py | Analyze keywords for volume and competition | python keyword_analyzer.py --keywords "todo,task,planner" |
| metadata_optimizer.py | Validate metadata character limits and density | python metadata_optimizer.py --platform ios --title "App Title" |
| competitor_analyzer.py | Extract and compare competitor keywords | python competitor_analyzer.py --competitors "App1,App2,App3" |
| aso_scorer.py | Calculate overall ASO health score | python aso_scorer.py --app-id com.example.app |
| ab_test_planner.py | Plan tests and calculate sample sizes | python ab_test_planner.py --cvr 0.05 --lift 0.10 |
| review_analyzer.py | Analyze review sentiment and themes | python review_analyzer.py --app-id com.example.app |
| launch_checklist.py | Generate platform-specific launch checklists | python launch_checklist.py --platform ios |
| localization_helper.py | Manage multi-language metadata | python localization_helper.py --locales "en,es,de,ja" |
| Document | Content | |----------|---------| | platform-requirements.md | iOS and Android metadata specs, visual asset requirements | | aso-best-practices.md | Optimization strategies, rating management, launch tactics | | keyword-research-guide.md | Research methodology, evaluation framework, tracking |
| Template | Purpose | |----------|---------| | aso-audit-template.md | Structured audit checklist for app store listings |
| Platform / Constraint | Behavior / Impact | |-----------------------|-------------------| | iOS keyword changes | Require app submission | | iOS promotional text | Editable without an app update | | Android metadata changes | Index in 1-2 hours | | Android keyword field | None — use description instead | | Keyword volume data | Estimates only; no official source | | Competitor data | Public listings only |
When not to use this skill: web apps (use web SEO), enterprise/internal apps, TestFlight-only betas, or paid advertising strategy.
| Skill | Integration Point | |-------|-------------------| | content-creator | App description copywriting | | marketing-demand-acquisition | Launch promotion campaigns | | marketing-strategy-pmm | Go-to-market planning |
| When you ask for... | You get... | |---------------------|------------| | "ASO audit" | Full app store listing audit with prioritized fixes | | "Keyword research" | Keyword list with search volume and difficulty scores | | "Optimize my listing" | Rewritten title, subtitle, description, keyword field |
All output passes quality verification:
development
Use when someone wants to run a weekly review, close open loops, audit stalled projects and commitments, get their system back to trusted, restart a lapsed review habit, or says "/cs:weekly-review". Walks David Allen's three-phase loop — GET CLEAR, GET CURRENT, GET CREATIVE — with deterministic scripts that inventory open loops, gate the checklist with named gaps, and score commitment health 0-100.
development
Use when someone wants to decide whether a meeting is worth calling, price a meeting in dollars, build a timeboxed agenda with desired outcomes, or turn messy meeting notes into owned action items — or says "should this be a meeting", "/cs:meeting-prep", or "/cs:meeting-actions". Runs a cost gate (ASYNC / NOT-READY / MEET), builds a decision-first agenda, and extracts an owner + due-date checklist that flags every orphan.
development
Convert a rambling description of a desired outcome into one polished, autonomous /goal prompt ready to paste into a fresh session. Use when the user says "/fable-goal", "turn this into a goal prompt", "write me a fable prompt", "write the prompt that builds X", or rambles about something they want made and asks for the prompt that makes it happen. The output is a single copy-paste prompt, never the build itself. Do NOT use when the user wants the thing built right now in this session — only when they want the PROMPT that will make it happen in a fresh session.
development
Use when someone wants to plan a deep work day, time-block their calendar or task list, budget or cut shallow work, protect focus hours, track deep-work sessions and streaks, run an end-of-day shutdown ritual, or says "/deep-work" or "/time-block". Classifies tasks deep vs shallow, builds an energy-first time-blocked schedule that refuses deep demand past the 4-hour ceiling, batches shallow work into at most two windows, and logs focus sessions against a weekly target.