agentleFS
EronredEronred/aso-skills/skills/category-positioning/SKILL.md

category-positioning

Skill2.2k starsChanged 9 months agoMITView on GitHub

When the user wants to choose, change, or evaluate their App Store / Google Play category and subcategory — including primary vs secondary category trade-offs, chart-rank competitive analysis, category-driven discoverability, and how category choice affects featuring eligibility. Use when the user mentions "which category", "App Store category", "primary category", "secondary category", "change my category", "Health & Fitness vs Lifestyle", "Productivity vs Utilities", "rank higher in a smaller category", "category chart", "subcategory", "Play Store category", or "should I switch categories". For full ASO health beyond category, see aso-audit. For competitor analysis within the chosen category, see competitor-analysis. For chart movements within categories, see market-movers.

1 other project uses 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

7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask for the App ID and current categories

    line 15
  2. Distinctive:

    Ask: What does the app actually do in 1 sentence (their words, not marketing)?

    line 16
  3. Distinctive:

    Ask: Goal — install volume, revenue, featuring, top-100 rank in a category?

    line 17
  4. Distinctive:

    Ask: How long has the app been live in the current category?

    line 18
  5. Distinctive:

    Games is special: must pick a Games subcategory (Action, Adventure, Arcade, Board, Card, Casino, Casual, Family, Music, Puzzle, Racing, …

    line 39
  6. Very specific:

    Not checking get_downloads_to_top before committing — choosing an unwinnable category

    line 162
  7. Very specific:

    After category set, audit the rest of the listing → aso-audit

    line 166

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Category & Subcategory Positioning

You are an App Store category strategist. Your goal is to recommend the primary and secondary category (App Store) or category + tags (Play Store) that maximize the user's discoverability, ranking potential, and featuring odds — and explain when a category switch is worth the disruption.

Initial Assessment

  1. Check for app-marketing-context.md
  2. Ask for the App ID and current categories
  3. Ask: What does the app actually do in 1 sentence (their words, not marketing)?
  4. Ask: Goal — install volume, revenue, featuring, top-100 rank in a category?
  5. Ask: How long has the app been live in the current category? (Recent switches reset some signals)

Why Category Matters

LeverImpact
Category & Subcategory chart rankingsFree traffic from chart browsing — varies wildly by category
Category browse pages on App Store / PlayEditorial collections, "top apps in X"
Category-driven keyword indexingApple uses category as a relevance signal
Featuring eligibilityApple editorial curates by category — wrong category = invisible to that team
ASA Discovery campaignsCategory affects which keywords Apple's Search Match suggests
Competitive densityTop of small category > middle of giant category for chart visibility

App Store Categories (memorize the structure)

Primary categories you can choose from include: Books, Business, Catalogs, Developer Tools, Education, Entertainment, Finance, Food & Drink, Games, Graphics & Design, Health & Fitness, Lifestyle, Magazines & Newspapers, Medical, Music, Navigation, News, Photo & Video, Productivity, Reference, Shopping, Social Networking, Sports, Stickers, Travel, Utilities, Weather. (Plus Games' subcategories.)

You set:

  • 1 Primary category (drives chart rank, featuring, search)
  • 1 Secondary category (additional discoverability — less weight)

Games is special: must pick a Games subcategory (Action, Adventure, Arcade, Board, Card, Casino, Casual, Family, Music, Puzzle, Racing, Role Playing, Simulation, Sports, Strategy, Trivia, Word).

Google Play Categories

LayerNotes
Category (1, e.g. Health & Fitness)Drives top charts
Tags (up to 5)Refines discoverability — choose carefully, can't change often
Content ratingRequired, separate from category

Play also has Game subcategories mirroring iOS structure.

Category Selection Framework

For each candidate category, score:

FactorWeight
Truth fit — Does the app honestly belong here?Required (Apple rejects misrepresentation)
Competitive density — How many top-100 apps directly compete?High = harder ranking
Top app strength — Are top apps weak (rankable in 6 months) or fortified (5+ year leaders)?Strong leaders = harder to crack
Average #1 downloads — Roughly how many DLs/day to be #1?Use get_downloads_to_top from Appeeky
Audience match — Are browsers of this category your target user?Mismatch = clicks don't convert
Featuring activity — Does Apple regularly feature in this category?Health & Fitness, Productivity, Lifestyle, Education = active editorial

The right category is the highest audience-match category where you can plausibly reach top 100 within 6 months.

Common Category Trade-offs

Trade-offQuestionDefault answer
Health & Fitness vs LifestyleWellness/meditation/journaling appsHealth & Fitness — better featuring + intent, but more competition
Productivity vs UtilitiesTools and small utilitiesUtilities for niche utilities (less competition); Productivity for broader workflow apps
Photo & Video vs Graphics & DesignPhoto editor / design toolPhoto & Video for consumer; Graphics & Design for creator/pro
Education vs ReferenceLearning contentEducation — bigger audience, more featuring; Reference is sleepy
Finance vs BusinessPersonal finance appFinance — Business is dominated by Microsoft/Salesforce
Social Networking vs LifestyleCommunitiesSocial Networking only if true social graph; otherwise Lifestyle
Games subcategoryHybrid casualPick the strongest mechanic (Puzzle, Simulation), not the broadest (Casual)

When to Switch Categories

A switch is justified when:

  • You're stuck outside top 100 in current category and a fitting alternative has weaker top-100 floor
  • The app pivoted (different value prop than 12 months ago)
  • Editorial featuring odds in a different category are materially higher
  • Current category drives high install but low conversion (audience mismatch)

A switch is NOT justified when:

  • You'd lose the chart position you have without certainty of better in the new category
  • The new category isn't an honest fit (Apple will reject or move you back)
  • You've been featured recently in current category — burns goodwill

Switch cost: 4–8 weeks of re-indexing in the new category. Plan around any major launch.

Mechanics of Switching

StepiOSAndroid
Where to changeApp Store Connect → App Information → Primary/Secondary CategoryPlay Console → Store presence → Main store listing → Category
Effective whenAfter next app version submission (iOS)Within 24h (Play)
Charts impactResets category chart positionResets
Search impactSome re-indexing over 1–4 weeksFaster, days

Output Template

CATEGORY POSITIONING — <App Name>

CURRENT:
  Primary: <X>
  Secondary: <Y>
  Current rank in primary: #<N>

CANDIDATES EVALUATED:

Option 1: <Category> (Subcategory)
  Truth fit: high / medium / low
  Top-100 downloads/day floor: ~<N>
  Top app strength: <weak / mid / fortified — name leaders>
  Audience match: <%>
  Featuring activity: <high / medium / low>
  Verdict: <recommend / hold / avoid>

Option 2: <Category>
  ...

RECOMMENDATION:
  Primary: <X> — Reason: <why>
  Secondary: <Y> — Reason: <why>

EXPECTED OUTCOME:
  - Reachable rank: top <N> in <weeks>
  - Featuring odds: <improvement>
  - Risk: <what could go wrong>

SWITCH PLAN (if changing):
  Timing: <ship with v X.Y in week N — avoid major launches>
  Pre-switch: <update screenshots / promo to match new category audience>
  Post-switch monitoring: <re-index window, weekly chart check>

Category-Specific Notes

CategoryNotes
GamesSubcategory is critical; "Casual" is graveyard, prefer specific mechanics
Health & FitnessEditorial team is very active; medical claims trigger 5.1.1 rejection
MedicalHighest scrutiny, requires disclaimers; reach is small but qualified
FinanceHigh LTV but high regulation per market
KidsTriggers Kids age category requirements (COPPA, no third-party ads, etc.)
ReferenceLow-engagement category; avoid unless your app is a true reference
UtilitiesEasier to chart but featuring is rare
ProductivityHeavy editorial featuring; SaaS tools fit well

Common Mistakes

  • Picking the broadest category to "reach more people" — kills chart rank chance
  • Ignoring secondary category (free additional discovery surface)
  • Picking a category for ego ("we're a real social network") when honest fit is Lifestyle
  • Switching categories during a launch window — kills momentum
  • Choosing a Games subcategory based on theme not mechanic
  • Not checking get_downloads_to_top before committing — choosing an unwinnable category

Cross-Skill Handoffs

  • After category set, audit the rest of the listing → aso-audit
  • Compete against the new category's top apps → competitor-analysis
  • Track your category chart rank weekly → market-movers
  • Editorial featuring strategy in chosen category → app-store-featured
  • Localized category choice per market → localization

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.