claude-code-aso-skill

Why use it

Key features

4 specialized agents (aso-master, aso-research, aso-optimizer, aso-strategist)
Real iTunes API integration for competitor and keyword research
Character validation: Apple (30/30/100), Google (50/80/4000)
47-item pre-launch validation checklist
4 slash commands: full audit, optimization-only, pre-launch, competitive analysis

Live Demo

What it looks like in practice

claude-code-aso-skill.replay ▶ ready

0/0

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use claude-code-aso-skill

Generate a complete ASO asset pack before app store submission

👤 Indie developers and small studios launching a new app ⏱ ~60 min intermediate

When to use: You're 2 weeks from submission and need titles, keywords, descriptions, and screenshots captions.

Prerequisites

App concept and category — A 1-paragraph description and the App Store category

Flow

Run the pre-launch command

/aso pre-launch — my app is a focus timer for developers, category Productivity.✓ Copied

→ aso-research scans similar apps via iTunes API; aso-optimizer drafts metadata
Review and iterate

Title feels too generic — give me 5 alternatives that include 'Pomodoro' without keyword stuffing.✓ Copied

→ Variants within char limits
Walk the 47-item checklist

Run the launch checklist.✓ Copied

→ Pass/fail per item with fixes

Outcome: A submission-ready ASO asset pack plus a checked-off launch list.

Pitfalls

Keyword stuffing triggers store rejection — aso-optimizer flags this; trust the warnings

Combine with: claude-ads-skill

Analyze the top 10 competitors in your category

👤 PMs and founders positioning against incumbents ⏱ ~30 min intermediate

When to use: You want to understand how competitors describe themselves before writing your own copy.

Flow

Run competitive analysis

/aso competitive in category 'Productivity' — top 10.✓ Copied

→ Real iTunes data on title, subtitle, keywords, rating patterns
Find the positioning gap

Where are all 10 saying the same thing? What's the whitespace?✓ Copied

→ Concrete positioning angle

Outcome: A differentiated positioning statement backed by live data.

Pitfalls

Top 10 may be dominated by one big player — skewed signal — Filter by category refinement or include mid-tail apps

Optimize metadata for an existing app that's underperforming

👤 App owners with a live app and stagnant downloads ⏱ ~30 min intermediate

When to use: Your app has been live 6+ months and ranking has plateaued.

Flow

Run optimization

/aso optimize — my app is MyApp, current metadata [paste].✓ Copied

→ Suggestions grounded in current top-ranking apps for the keyword set
A/B plan

Which changes should I A/B test first, and in what order?✓ Copied

→ Prioritized test roadmap

Outcome: A testing roadmap to improve rank.

Pitfalls

Too many concurrent changes make attribution impossible — Skill recommends one variable at a time

Combinations

Pair with other MCPs for X10 leverage

claude-code-aso-skill + claude-ads-skill

Align ASO keywords with paid-ads keyword strategy

Take the ASO keyword list and have claude-ads plan a UA campaign around the same terms.✓ Copied

claude-code-aso-skill + nano-banana-pro-prompts-recommend-skill

Generate App Store screenshot-caption image prompts

For each screenshot caption the ASO skill suggests, recommend a visual prompt via nano-banana.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call	Cost
/aso full-audit	app concept or URL	New app or comprehensive review	Tokens + iTunes API (free)
/aso optimize	current metadata	Refreshing an existing app	Tokens
/aso pre-launch	concept + category	Before submission	Tokens
/aso competitive	category or competitor list	Positioning work	Tokens + iTunes API

Cost & Limits

What this costs to run

API quota: iTunes Search API is free, generous limits
Tokens per call: 5-15k per command
Monetary: Free — skill is local
Tip: Run full-audit once, then use optimize + competitive periodically.

Security

Permissions, secrets, blast radius

Credential storage: No credentials — iTunes Search API is unauthenticated

Data egress: iTunes Search API only

Troubleshooting

Common errors and fixes

iTunes API returns empty for a known app

Check the bundleID or the country code; country defaults to US.

Suggested title exceeds 30 chars

The optimizer should catch this; if not, re-run with explicit '30 char max' reminder.

Alternatives