Agent skill

Category Positioning

by appeeky in appeeky/aso-skills

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…

MITAuto-check passedMarketing & SEO

Install Category Positioning

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

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

GitHub CLI
$ gh skill install appeeky/aso-skills category-positioning --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/category-positioning .claude/skills/category-positioning && 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
category-positioning
GitHub stars
2.2k
Token cost
~2.2k tokens
SKILL.md length
892 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 5 steps: Check for app-marketing-context.md → Ask for the App ID and current categories → Ask: What does the app actually do in 1… → …
  • Wants to choose
  • SKILL.md covers Initial Assessment, Why Category Matters, App Store Categories (memorize… and Google Play Categories, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Category Positioning is an agent skill from appeeky/aso-skills. 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"…

Its SKILL.md is about 2.2k 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 Marketing & SEO, covering App store release and Competitor analysis. 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 to choose
  • Evaluate their App Store / Google Play category and subcategory — including primary vs secondary category trade-offs
  • Chart-rank competitive analysis
  • Category-driven discoverability

Example prompts

  • “which category”
  • “App Store category”
  • “primary category”
  • “/category-positioning”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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)

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

Category Positioning loads about 2.2k tokens when it runs. Until then it costs about 202 tokens; SKILL.md has 892 words of instructions outside code blocks.

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

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). 892 words, ~2,197 tokens.

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

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

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

© 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/category-positioning of appeeky/aso-skills.

Open the folder on GitHubat commit 3919d7c

Compare with similar skills

Category Positioning 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.

Category Positioning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Category Positioning this skillappeeky/aso-skills2.2k—~2.2kAutomated safety check: PassMIT
Competitor Analysismrzmyr/pixy-mood-tracker-app154—~1.4kAutomated safety check: PassMIT
Competitive Teardownalirezarezvani/claude-skills28k2 repos~2.1kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo18k2 repos~2.6kAutomated safety check: PassMIT
Startup Competitorsferdinandobons/startup-skill1.2k1 repos~4.1kAutomated safety check: PassMIT
App Store Optimizationalirezarezvani/claude-code-skill-factory8808 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • Competitor Analysis

    mrzmyr/pixy-mood-tracker-app

    Competitor analysis for Pixy (or any mobile app) from public App Store and Google Play data, no API keys.

    154 GitHub stars~1.4k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Competitive Teardown

    alirezarezvani/claude-skills

    Analyzes competitor products and companies by synthesizing data from pricing pages, app store reviews, job postings, SEO signals, and social media into structured competitive intelligence.

    28k GitHub starsUsed in 2 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    18k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Startup Competitors

    ferdinandobons/startup-skill

    Deep competitive intelligence for any market. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub starsUsed in 1 repo~4.1k tokens
    Marketing & SEOAuto-check passed
  • App Store Optimization

    alirezarezvani/claude-code-skill-factory

    Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store

    880 GitHub starsUsed in 8 repos~4.1k tokens
    Marketing & SEOAuto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 2 repos~3.2k tokens
    Marketing & SEOAuto-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

Questions about Category Positioning

What does Category Positioning do?

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

When should I use Category Positioning?

Category Positioning fits situations like: wants to choose; evaluate their App Store / Google Play category and subcategory — including primary vs secondary category trade-offs; chart-rank competitive analysis; category-driven discoverability.

How do I install Category Positioning in Claude Code?

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

How do I install Category Positioning in Codex?

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

Can I use Category Positioning 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 category-positioning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/category-positioning, .gemini/skills/category-positioning, .github/skills/category-positioning and .opencode/skills/category-positioning in your project.

What does Category Positioning need to run?

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

Does Category Positioning 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 Category Positioning 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 Category Positioning use?

Category Positioning 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 Category Positioning use?

About 2.2k tokens (SKILL.md is roughly 8.8k 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 Category Positioning?

Skills that share tags, products or a category with Category Positioning: Competitor Analysis (mrzmyr/pixy-mood-tracker-app, 154 stars), Competitive Teardown (alirezarezvani/claude-skills, 28k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 18k stars) and Startup Competitors (ferdinandobons/startup-skill, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Category Positioning?

appeeky (a GitHub organization) maintains it in appeeky/aso-skills, which has 2,152 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.