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
cd ~/.claude/skills
git clone https://github.com/alirezarezvani/claude-skills.git claude-skills mkdir -p ~/.claude/skills/app-store-optimization
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/claude-skills/HEAD/.gemini/skills/app-store-optimization/SKILL.md \
-o ~/.claude/skills/app-store-optimization/SKILL.md 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:
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working w
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.