Agent skill

Aso Audit

by appeeky in appeeky/aso-skills

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking.

MITAuto-check passedMobile

Install Aso Audit

skills CLI
$ npx skills add appeeky/aso-skills --skill aso-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install appeeky/aso-skills aso-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/appeeky/aso-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/aso-audit .claude/skills/aso-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aso-audit
GitHub stars
2.2k
Token cost
~1.6k tokens
SKILL.md length
692 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking.

  • Works in 10 steps: Title (Weight: 20%) → Subtitle (Weight: 15%) — iOS only → Keyword Field (Weight: 15%) — iOS only → …
  • Wants a full ASO health audit
  • SKILL.md covers Initial Assessment, Data Collection, Audit Framework and Output Format, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Aso Audit is an agent skill from appeeky/aso-skills. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering App store release. It works with iOS. The repository describes itself as: AI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent… The licence is MIT.

When your agent uses it

  • Wants a full ASO health audit
  • Review their App Store listing quality
  • Diagnose why their app isnt ranking
  • The user mentions ASO audit

Example prompts

  • “t ranking. Also use when the user mentions”
  • “ASO score”
  • “why am I not ranking”
  • “/aso-audit”

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Title (Weight: 20%)
  2. Subtitle (Weight: 15%) — iOS only
  3. Keyword Field (Weight: 15%) — iOS only
  4. Description (Weight: 5% iOS / 15% Android)
  5. Screenshots (Weight: 15%)
  6. App Preview Video (Weight: 5%)
  7. Ratings & Reviews (Weight: 15%)
  8. Icon (Weight: 5%)
  9. Keyword Rankings (Weight: 10%)
  10. Conversion Signals (Weight: 5%)

What it can do on your machine

Read from SKILL.md and the folder at commit 3919d7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aso Audit loads about 1.6k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 692 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from appeeky/aso-skills at commit 3919d7c, republished under its MIT licence (© appeeky). 692 words, ~1,589 tokens.

Download SKILL.mdSave it as .claude/skills/aso-audit/SKILL.md (or your agent's skills folder).
name
aso-audit
description
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.
metadata.version
1.0.0

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)?
Show full SKILL.md (283 more words)Show less
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.

  • 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

© appeeky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/aso-audit of appeeky/aso-skills.

Open the folder on GitHubat commit 3919d7c

Compare with similar skills

Aso Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aso Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aso Audit this skillappeeky/aso-skills2.2k—~1.6kAutomated safety check: PassMIT
App Adskostja94/marketing-skills1k—~781Automated safety check: PassMIT
App Store Screenshots GeneratorParthJadhav/app-store-screenshots7.2k—~14kAutomated safety check: PassMIT
App Store Release Flowrorkai/app-store-connect-cli-skills1.1k2 repos~2kAutomated safety check: PassMIT
App Store Submission Healthrorkai/app-store-connect-cli-skills1.1k2 repos~2.2kAutomated safety check: PassMIT
App Store Preflight Skillstruongduy2611/app-store-preflight-skills1.4k—~1.4kAutomated safety check: PassMIT

Similar skills

  • App Ads

    kostja94/marketing-skills

    When the user wants to run app install ads, user acquisition (UA), or promote mobile apps.

    1k GitHub stars~781 tokensUpdated 3 days ago
    MobileAuto-check passed
  • App Store Screenshots Generator

    ParthJadhav/app-store-screenshots

    Scaffolds a Next.js editor for designing App Store and Google Play screenshots as ads and exporting them at every required size, for iOS, Mac and Android.

    7.2k GitHub stars~14k tokensUpdated today
    MobileAuto-check passed
  • App Store Release Flow

    rorkai/app-store-connect-cli-skills

    Orchestrates App Store releases with the asc CLI: staging a version, uploading or building, publishing and submitting for review, with dry-run and confirmation gates.

    1.1k GitHub starsUsed in 2 repos~2k tokens
    MobileAuto-check passed
  • App Store Submission Health

    rorkai/app-store-connect-cli-skills

    Diagnoses why an App Store version cannot be submitted or is stuck in review, using the asc CLI for validation, repair routing, status checks and retry decisions.

    1.1k GitHub starsUsed in 2 repos~2.2k tokens
    MobileAuto-check passed
  • App Store Preflight Skills

    truongduy2611/app-store-preflight-skills

    Scan an iOS/macOS Xcode project for common App Store rejection patterns before submission.

    1.4k GitHub stars~1.4k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • App Store Connect App Creator

    rorkai/app-store-connect-cli-skills

    Creates a new App Store Connect app record by driving the New App form through browser automation, for cases where no public API covers app creation.

    1.1k GitHub starsUsed in 3 repos~1.5k tokens
    MobileAuto-check passed

More from appeeky/aso-skills

All 39 skills in this repo
  • Ab Test Store Listing

    appeeky/aso-skills

    When the user wants to A/B test App Store product page elements to improve conversion rate.

    2.2k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Android Aso

    appeeky/aso-skills

    When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features.

    2.2k GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • App Analytics

    appeeky/aso-skills

    When the user wants to set up, interpret, or improve their app analytics and tracking.

    2.2k GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • App Clips

    appeeky/aso-skills

    When the user wants to implement, optimize, or use App Clips for app discovery and conversion.

    2.2k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • App Icon Optimization

    appeeky/aso-skills

    When the user wants to design, test, or improve their app icon to increase tap-through rate and conversions in App Store search and browse.

    2.2k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • App Marketing Context

    appeeky/aso-skills

    When the user wants to create or update their app marketing context document.

    2.2k GitHub stars~910 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Aso Audit

What does Aso Audit do?

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Aso Audit is an agent skill from appeeky/aso-skills. When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking.

When should I use Aso Audit?

Aso Audit fits situations like: wants a full ASO health audit; review their App Store listing quality; diagnose why their app isnt ranking; the user mentions ASO audit.

How do I install Aso Audit in Claude Code?

Run `npx skills add appeeky/aso-skills --skill aso-audit -a claude-code`. Or copy the skill folder (skills/aso-audit in appeeky/aso-skills) into .claude/skills/aso-audit in your project. Claude Code loads it when a task matches its description.

How do I install Aso Audit in Codex?

Run `npx skills add appeeky/aso-skills --skill aso-audit -a codex`. Or copy the skill folder (skills/aso-audit in appeeky/aso-skills) into .agents/skills/aso-audit in your project. Codex loads it when a task matches its description.

Can I use Aso Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add appeeky/aso-skills --skill aso-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aso-audit, .gemini/skills/aso-audit, .github/skills/aso-audit and .opencode/skills/aso-audit in your project.

What does Aso Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: Aso Audit is instructions for the agent only.

Does Aso Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aso Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aso Audit use?

Aso Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aso Audit use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Aso Audit?

Skills that share tags, products or a category with Aso Audit: App Ads (kostja94/marketing-skills, 1k stars), App Store Screenshots Generator (ParthJadhav/app-store-screenshots, 7.2k stars), App Store Release Flow (rorkai/app-store-connect-cli-skills, 1.1k stars) and App Store Submission Health (rorkai/app-store-connect-cli-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aso Audit?

appeeky (a GitHub organization) maintains it in appeeky/aso-skills, which has 2,159 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 6, 2026.

Source: appeeky/aso-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.