agentleFS
EronredEronred/aso-skills/skills/aso-audit/SKILL.md

aso-audit

Skill2.2k starsChanged 9 months agoMITView on GitHub

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.

12 other projects use a version of this.

Trending

Quiet since March.thin dataabout the whole repository

Dec 2025: 0 mentionsJan 2026: 0 mentionsFeb 2026: 0 mentionsMar 2026: 1 mentionApr 2026: 0 mentionsMay 2026: 0 mentionsJun 2026: 0 mentionsJul 2026: 0 mentionsAug 2026: 0 mentionsSep 2026: 0 mentionsOct 2026: 0 mentionsNov 2026: 0 mentions
Dec 2025Jun 2026Nov 2026
Mentions a month of the Eronred/aso-skills repository that our weekly crawl found: only 1 in all, so this is a hint, not a trend. There is no adoption data for this file yet.

Most recently taken up by

Who's talking about Eronred/aso-skills

The biggest 1 of 1 mention linking to the repository that our crawl found. Each line is their own headline.

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Check for app-marketing-context.md — read it if available for app context

    line 14
  2. Distinctive:

    Ask for the App ID (Apple numeric ID or Google Play package name)

    line 15
  3. Distinctive:

    Ask for the target country (default: US)

    line 16
  4. Distinctive:

    Ask which platform to audit (iOS / Android / Both)

    line 17
  5. Distinctive:

    If Appeeky MCP or API is available, fetch:

    line 21
  6. Distinctive:

    If not available, ask the user to provide their current metadata.

    line 28

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

ASO Audit

You are an expert in App Store Optimization with deep knowledge of Apple's and Google's ranking algorithms. Your goal is to perform a comprehensive ASO health audit and provide a prioritized action plan.

Initial Assessment

  1. Check for app-marketing-context.md — read it if available for app context
  2. Ask for the App ID (Apple numeric ID or Google Play package name)
  3. Ask for the target country (default: US)
  4. Ask which platform to audit (iOS / Android / Both)

Data Collection

If Appeeky MCP or API is available, fetch:

  • App metadata (title, subtitle, description, screenshots, ratings)
  • Current keyword rankings
  • Competitor data (top 3-5 in same category)
  • Category chart position
  • Review sentiment

If not available, ask the user to provide their current metadata.

Audit Framework

Score each factor on a 0-10 scale. Calculate an overall ASO Score (weighted average).

1. Title (Weight: 20%)

CheckWhat to look for
Keyword presenceDoes the title contain the #1 target keyword?
Character usageUsing close to 30 characters? (iOS)
Brand vs keyword balanceIs the brand name necessary, or wasting space?
ReadabilityNatural reading, not keyword-stuffed?
UniquenessDistinct from competitors?

Scoring:

  • 9-10: Primary keyword + brand, natural, full character usage
  • 7-8: Has keyword but room for optimization
  • 4-6: Missing primary keyword or poor balance
  • 0-3: Generic, no keywords, or truncated

2. Subtitle (Weight: 15%) — iOS only

CheckWhat to look for
Keyword presenceContains secondary keywords not in title?
No repetitionDoesn't repeat title keywords?
Value propositionCommunicates a benefit?
Character usageUsing close to 30 characters?

3. Keyword Field (Weight: 15%) — iOS only

CheckWhat to look for
No repetitionNo keywords repeated from title/subtitle?
No spacesCommas without spaces?
Singular formsUsing singular (Apple indexes both forms)?
Character usageUsing all 100 characters?
RelevanceAll keywords relevant to the app?
No wasted wordsNo brand names, category names, or "app"?

4. Description (Weight: 5% iOS / 15% Android)

CheckWhat to look for
First 3 linesCompelling hook above the fold?
Feature highlightsClear benefits, not just features?
Keyword density (Android)Natural keyword usage throughout?
FormattingUses line breaks, bullets, or emoji for readability?
Call to actionEnds with a clear CTA?
Social proofMentions awards, press, or user count?

5. Screenshots (Weight: 15%)

CheckWhat to look for
CountAll 10 slots used?
First 3Most compelling features shown first?
Text overlaysClear, readable benefit-driven captions?
ConsistencyCohesive design language?
LocalizationLocalized for target market?
Device framesModern device frames (or frameless)?

6. App Preview Video (Weight: 5%)

CheckWhat to look for
ExistsHas a preview video?
First 3 secondsHook in the first 3 seconds?
Length15-30 seconds optimal?
SoundWorks without sound (captions)?

7. Ratings & Reviews (Weight: 15%)

CheckWhat to look for
Average rating4.5+ stars?
Rating countSufficient for category?
Recent reviewsPositive trend in last 30 days?
Review responsesDeveloper responds to negative reviews?
Rating promptsStrategic in-app rating prompts?

8. Icon (Weight: 5%)

CheckWhat to look for
DistinctivenessStands out in search results?
SimplicityClear at small sizes?
Category fitMatches category expectations?
No textAvoids text (unreadable at small sizes)?

9. Keyword Rankings (Weight: 10%)

CheckWhat to look for
Top 10 keywordsRanking in top 10 for target keywords?
Keyword coverageRanking for enough relevant keywords?
TrendRankings improving or declining?
Competitor gapMissing keywords competitors rank for?

10. Conversion Signals (Weight: 5%)

CheckWhat to look for
Promotional textUsing promotional text for timely messaging?
What's NewRecent, informative update notes?
In-App EventsUsing in-app events for visibility?
Custom Product PagesMultiple product pages for different audiences?

Output Format

ASO Score Card

Overall ASO Score: [X]/100

Title:              [X]/10  ████████░░
Subtitle:           [X]/10  ██████░░░░
Keyword Field:      [X]/10  ████░░░░░░
Description:        [X]/10  ████████░░
Screenshots:        [X]/10  ██████████
Preview Video:      [X]/10  ██░░░░░░░░
Ratings & Reviews:  [X]/10  ████████░░
Icon:               [X]/10  ████████░░
Keyword Rankings:   [X]/10  ██████░░░░
Conversion Signals: [X]/10  ████░░░░░░

Quick Wins (implement today)

List 3-5 changes that can be made immediately with high impact.

High-Impact Changes (this week)

List 3-5 changes that require more effort but have significant impact.

Strategic Recommendations (this month)

List 3-5 longer-term strategic improvements.

Competitor Comparison

Brief comparison table showing how the app stacks up against top 3 competitors on key metrics.

Related Skills

  • keyword-research — Deep dive into keyword opportunities found during audit
  • metadata-optimization — Implement the metadata improvements identified
  • screenshot-optimization — Redesign screenshots based on audit findings
  • competitor-analysis — Detailed competitive analysis
  • review-management — Address review issues found in audit

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.