Skip to main content

Your First ASO Audit

1

Install ASO Skills

Follow the installation guide for your IDE (Cursor, Claude Code, or manual)
2

Ask your AI agent

Use natural language or direct invocation:
"Run an ASO audit for my app (id: 1617391485)"
Or invoke directly:
/aso-audit
3

Review your score

Agent returns an ASO Score Card (0-100) across 10 factors:
  • Title optimization
  • Subtitle effectiveness
  • Keyword field usage
  • Description quality
  • Visual assets
  • Ratings & reviews
  • Update frequency
  • And more…
4

Implement quick wins

Agent provides a prioritized fix list with high-impact changes
You just got an expert-level ASO audit — without reading blog posts or hiring consultants.

Common Use Cases

Keyword Research

Find high-volume, low-difficulty keywords for your app:
"Find the best keywords for a meditation app"
"What keywords should I target for a fitness tracker?"
"Show me keyword opportunities in Health & Fitness"
Output:
  • Primary keywords (high volume, high relevance)
  • Secondary keywords (medium volume, good fit)
  • Long-tail keywords (niche, low competition)
  • Keyword difficulty scores
  • Character count optimization
Agent groups keywords by volume × difficulty × relevance — not just raw search volume.

Metadata Optimization

Generate optimized title, subtitle, and keyword field:
"Optimize my App Store title and subtitle"
"Write metadata for a language learning app"
"Give me 3 title variants with character counts"
Output:
  • 3 title variants (30 chars max)
  • 3 subtitle variants (30 chars max)
  • Keyword field (100 chars, comma-separated)
  • Description (4000 chars, not indexed on iOS)
  • Promotional text (170 chars)
iOS limits: Title 30 chars, Subtitle 30 chars, Keywords 100 chars. Don’t repeat keywords across fields.

Competitor Analysis

Identify keyword gaps and positioning opportunities:
"Analyze Headspace vs Calm"
"What keywords is my competitor ranking for?"
"Show me gaps in Duolingo's keyword strategy"
Output:
  • Keyword overlap analysis
  • Gaps your competitors are missing
  • Creative teardown (screenshots, videos)
  • Positioning map
  • Specific opportunities to exploit

Screenshot Optimization

Design a conversion-focused screenshot strategy:
"Optimize my app screenshots"
"Give me a 10-slot screenshot strategy for a budgeting app"
Output:
  • Slot-by-slot strategy (hero, benefits, social proof, CTA)
  • Design briefs for each screenshot
  • Text overlay copy suggestions
  • Competitor audit
  • A/B test hypotheses

Download Estimates

Understand competitive landscape and growth targets:
"How many downloads do I need to reach top 10 in Health & Fitness?"
"What's the download velocity for featured apps in Productivity?"
Output:
  • Category-specific benchmarks
  • Download estimates for top 10/50/100
  • Featured app performance data
  • Growth trajectory modeling
This requires Appeeky integration for real-time data. Without Appeeky, agent uses category benchmarks.

Workflow Examples

New App Launch

1

Create marketing context

/app-marketing-context
Agent creates a context doc (app, audience, competitors, goals) that all other skills reference
2

Research keywords

/keyword-research
Find primary, secondary, and long-tail keywords
3

Write metadata

/metadata-optimization
Generate title, subtitle, keyword field, description
4

Plan screenshots

/screenshot-optimization
Get a 10-slot strategy with design briefs
5

Build launch timeline

/app-launch
8-week timeline with daily checklists, channel strategy, press outreach

Existing App Optimization

1

Run ASO audit

/aso-audit
Get a score across 10 factors and prioritized fix list
2

Analyze competitors

/competitor-analysis
Identify keyword gaps and positioning opportunities
3

A/B test metadata

/ab-test-store-listing
Design hypothesis → variant → sample size → interpretation
4

Improve ratings

/review-management
Sentiment analysis, response templates, rating improvement tactics

International Expansion

1

Prioritize markets

/localization
Market prioritization matrix (opportunity × feasibility)
2

Research local keywords

Agent provides per-country keyword research framework
3

Adapt metadata

Cultural adaptation checklist for each locale
4

Set up tracking

/app-analytics
Event plan for international attribution

Skill Chaining

Skills reference each other for deeper analysis: Example conversation:
You: "Run an ASO audit for my app"

Agent: "Your keyword field is only using 45/100 characters (Score: 4/10).
        I recommend running /keyword-research to find high-value keywords."

You: "Do it"

Agent: [Runs keyword-research, returns 20 keyword opportunities]
        "Here are 15 keywords that fit in your remaining 55 characters.
         Should I generate optimized metadata with /metadata-optimization?"

You: "Yes"

Agent: [Generates 3 title variants, 3 subtitle variants, optimized keyword field]
Agent proactively suggests next steps. You can accept or continue manually.

Advanced Features

App Marketing Context

Create a reusable context doc that all skills reference:
/app-marketing-context
Agent asks about:
  • App name, category, target audience
  • Key features and value props
  • Top 3 competitors
  • Business goals (downloads, revenue, featured)
Saves context to .agents/context/app-marketing.md. All subsequent skills reference this doc for personalized recommendations.

Real-Time Data (Appeeky)

With Appeeky integration, skills can pull:

Keyword Rankings

Live rankings for any app ID + keyword combination

Search Volume

Monthly search volume estimates by keyword

Competitor Metadata

Title, subtitle, keywords, description for any app

Download Estimates

Daily/weekly/monthly download velocity

Trending Keywords

Emerging keywords in your category

Featured Apps

Currently featured apps and patterns
Example with Appeeky:
You: "What keywords is Headspace ranking for?"

Agent: [Calls Appeeky API]
        "Headspace (id: 493145008) ranks in top 10 for:
         - meditation (position 2)
         - sleep sounds (position 5)
         - mindfulness (position 3)
         - anxiety relief (position 8)
         
         Total search volume: 2.4M/month
         Keyword coverage: 87% (excellent)"

Pro Tips

Instead of “Run audit for Headspace”, use:
"Run audit for app id 493145008"
Agent pulls exact metadata instead of guessing.
"Run keyword research, competitor analysis, and metadata optimization for my meditation app"
Agent processes all three skills in sequence.
"Give me 5 title variants with different positioning angles"
Agent generates multiple options (feature-focused, benefit-focused, social proof, etc.)
"Export keyword research as CSV"
"Give me metadata as JSON for my API"
Agent adapts output format to your workflow.
"Use the keywords from earlier and write new metadata"
Agent remembers conversation context and chains skills.

Troubleshooting

Problem: Agent isn’t loading skills.Solution:
  1. Use trigger phrases: “Run an ASO audit”, “Find keywords”
  2. Direct invocation: /aso-audit, /keyword-research
  3. Check installation: ls .cursor/skills/ (should show skill directories)
Problem: Agent uses general knowledge instead of live App Store data.Solution:
  1. Set up Appeeky integration
  2. Verify MCP config with curl https://mcp.appeeky.com/health
  3. Use app IDs instead of app names for accurate lookups
Problem: /skill-name returns “skill not found”.Solution:
  1. Check spelling: /aso-audit not /aso-audit-tool
  2. Verify installation: Skills should be in .cursor/skills/ or .claude/skills/
  3. Restart IDE after installation

Next Steps

Explore All Skills

Browse all 15 ASO & app marketing skills

Appeeky Integration

Enable real-time App Store data

Contributing

Add new skills or improve frameworks

Build docs developers (and LLMs) love