.claude/skills/ts-app-store-optimization/SKILL.md
Optimize mobile app listings for discovery and conversion in Apple App Store and Google Play. Use when tasks involve ASO keyword research, title and subtitle optimization, screenshot and preview video design, A/B testing store listings, review management, localization for international markets, tracking keyword rankings, or improving download conversion rates. Covers both iOS and Android store algorithms and best practices.
npx skillsauth add eliferjunior/Claude 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.
Optimize mobile app visibility and conversion in App Store and Google Play. Cover keyword research, metadata optimization, creative assets, ratings management, and localization.
Apple App Store indexes: App Name (30 chars, highest weight), Subtitle (30 chars), Keyword field (100 chars, hidden), In-App Purchase names, Developer name. Apple does NOT index the description for search.
Google Play indexes: App Title (30 chars, highest weight), Short Description (80 chars), Long Description (4000 chars, 2-5% keyword density), Developer name, Package name. Google also factors engagement metrics: install velocity, retention, crash rate, uninstall rate.
volume × relevance / difficultyKeyword placement:
App Store (iOS):
- App Name (30 chars): Top 2-3 keywords, natural reading
- Subtitle (30 chars): Supporting keywords, value prop
- Keyword field (100 chars): Everything else, no duplicates across fields
- Comma-separated, no spaces. Singular OR plural (Apple matches both)
- Don't include "app" or category name. Don't use competitor brands.
Google Play:
- Title (30 chars): Primary keyword + brand
- Short Description (80 chars): Key features with keywords
- Long Description (4000 chars): Natural usage, 2-5% density, repeat 3-5x
Screenshots are the single biggest conversion factor. Design principles:
Preview video: iOS 15-30s (autoplays muted), Android 30s-2min (YouTube). Start with the wow moment, no long intros.
Icon: Recognizable at 16×16px, single focal element, avoid text, A/B test variations.
Google Play Experiments: Test up to 5 variants (icon, screenshots, descriptions). Minimum 7 days, recommend 14 days.
Apple Product Page Optimization: Test up to 3 treatments (icon, screenshots, preview video). Cannot test title/subtitle. 90-day limit.
Priority order: Screenshots → Icon → Short description/subtitle → Preview video.
Each 0.5-star increase improves conversion by 10-20%. Apps below 4.0 lose significant traffic.
In-app review prompts: Use native review API. Trigger after positive actions (completed goal, saved money). Pre-qualify: ask "Are you enjoying [App]?" — if yes, show review; if no, route to feedback form. Max 3 times per year (iOS enforced).
Responding: Reply to all negative reviews within 24-48 hours. Be specific about fixes. Never argue or be defensive.
Localizing metadata (not the app) is the fastest ASO win. High-impact locales: Spanish, Portuguese (Brazil), Japanese, German, French, Korean.
Localization is NOT translation — research keywords in each locale separately. Direct translations often aren't what locals search for.
Track weekly: keyword rankings (top 10 with position changes), category ranking, impressions, page view → install rate (benchmark: 25-35%), impression → install rate (benchmark: 3-8%), Day 1 retention, crash rate, current rating and trend.
Our meditation app "ZenFlow" has 2,000 daily downloads but a 22% conversion rate from page views. Current title: "ZenFlow". We rank for "meditation" (#45) and "sleep sounds" (#78). Optimize our App Store metadata — title, subtitle, and keyword field — to improve keyword rankings and conversion. Research what top competitors in the meditation category use.
Our fitness app has 100K downloads in the US and we want to expand internationally. Identify the top 5 markets by opportunity (considering competition, ARPU, and mobile fitness trends), then create localized metadata for each — not direct translations, but locally researched keywords and culturally adapted screenshots.
Our productivity app's screenshots haven't been updated in 8 months and conversion is declining. Design 3 screenshot variants to A/B test on Google Play. Include the messaging strategy, visual approach, and success metrics for each variant. Our current conversion rate from page view to install is 28%.
development
Expert guidance for Fireworks AI, the platform for running open-source LLMs (Llama, Mixtral, Qwen, etc.) with enterprise-grade speed and reliability. Helps developers integrate Fireworks' inference API, fine-tune models, and deploy custom model endpoints with function calling and structured output support.
development
Convert any website into clean, structured data with Firecrawl — API-first web scraping service. Use when someone asks to "turn a website into markdown", "scrape website for LLM", "Firecrawl", "extract website content as clean text", "crawl and convert to structured data", or "scrape website for RAG". Covers single-page scraping, full-site crawling, structured extraction, and LLM-ready output.
tools
Expert guidance for Firebase, Google's platform for building and scaling web and mobile applications. Helps developers set up authentication, Firestore/Realtime Database, Cloud Functions, hosting, storage, and analytics using Firebase's SDK and CLI.
development
When the user needs to build file upload functionality for a web application. Use when the user mentions "file upload," "image upload," "upload endpoint," "multipart upload," "presigned URL," "S3 upload," "file validation," "upload to cloud storage," or "accept user files." Handles upload endpoints, file validation (type, size, magic bytes), cloud storage integration, and upload status tracking. For image/video processing after upload, see media-transcoder.