Skip to main content
ClaudeWave
Skill1.5k estrellas del repoactualizado 1mo ago

category-positioning

The category-positioning skill helps app developers and marketers select and optimize their primary and secondary App Store categories or Google Play category and tags to maximize discoverability, chart ranking potential, and editorial featuring opportunities. Use this skill when evaluating whether an app's current category placement is optimal, considering a category switch to improve visibility in less competitive charts, or assessing how category choice affects keyword indexing and featuring eligibility across platforms.

Instalar en Claude Code
Copiar
git clone --depth 1 https://github.com/Eronred/aso-skills /tmp/category-positioning && cp -r /tmp/category-positioning/skills/category-positioning ~/.claude/skills/category-positioning
Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

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

| Lever | Impact |
|---|---|
| Category & Subcategory chart rankings | Free traffic from chart browsing — varies wildly by category |
| Category browse pages on App Store / Play | Editorial collections, "top apps in X" |
| Category-driven keyword indexing | Apple uses category as a relevance signal |
| Featuring eligibility | Apple editorial curates by category — wrong category = invisible to that team |
| ASA Discovery campaigns | Category affects which keywords Apple's Search Match suggests |
| Competitive density | Top 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

| Layer | Notes |
|---|---|
| **Category** (1, e.g. Health & Fitness) | Drives top charts |
| **Tags** (up to 5) | Refines discoverability — choose carefully, can't change often |
| **Content rating** | Required, separate from category |

Play also has **Game subcategories** mirroring iOS structure.

## Category Selection Framework

For each candidate category, score:

| Factor | Weight |
|---|---|
| **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-off | Question | Default answer |
|---|---|---|
| Health & Fitness vs Lifestyle | Wellness/meditation/journaling apps | Health & Fitness — better featuring + intent, but more competition |
| Productivity vs Utilities | Tools and small utilities | Utilities for niche utilities (less competition); Productivity for broader workflow apps |
| Photo & Video vs Graphics & Design | Photo editor / design tool | Photo & Video for consumer; Graphics & Design for creator/pro |
| Education vs Reference | Learning content | Education — bigger audience, more featuring; Reference is sleepy |
| Finance vs Business | Personal finance app | Finance — Business is dominated by Microsoft/Salesforce |
| Social Networking vs Lifestyle | Communities | Social Networking only if true social graph; otherwise Lifestyle |
| Games subcategory | Hybrid casual | Pick 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

| Step | iOS | Android |
|---|---|---|
| Where to change | App Store Connect → App Information → Primary/Secondary Category | Play Console → Store presence → Main store listing → Category |
| Effective when | After next app version submission (iOS) | Within 24h (Play) |
| Charts impact | Resets category chart position | Resets |
| Search impact | Some re-indexing over 1–4 weeks | Faster, 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
ab-test-store-listingSkill

When the user wants to A/B test App Store product page elements to improve conversion rate. Also use when the user mentions "A/B test", "product page optimization", "test my screenshots", "test my icon", "conversion rate optimization", "CPP", or "custom product pages". For screenshot design, see screenshot-optimization. For metadata optimization, see metadata-optimization.

android-asoSkill

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

app-analyticsSkill

When the user wants to set up, interpret, or improve their app analytics and tracking. Also use when the user mentions "analytics", "tracking", "metrics", "KPIs", "App Store Connect analytics", "install tracking", "funnel", "attribution", or "how is my app performing". For A/B testing, see ab-test-store-listing. For retention metrics, see retention-optimization.

app-clipsSkill

When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.

app-icon-optimizationSkill

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. Use when the user mentions "app icon", "icon design", "icon A/B test", "icon variants", "tap-through rate", "icon conversion", "icon refresh", or wants to know what makes a good app icon. For screenshot optimization, see screenshot-optimization. For full listing A/B tests, see ab-test-store-listing.

app-launchSkill

When the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "pre-launch", "launch day", or "how to launch my app". For ongoing ASO after launch, see aso-audit. For paid acquisition during launch, see ua-campaign.

app-marketing-contextSkill

When the user wants to create or update their app marketing context document. Also use when the user mentions "app context", "marketing brief", "app positioning", or when starting any ASO or app marketing project. This is the foundation skill — all other skills check for this context first.

app-preview-videoSkill

When the user wants to plan, script, produce, or optimize App Store Preview videos or Google Play promo videos — the autoplay videos that show in App Store/Play Store search and product pages. Use when the user mentions "App Preview", "preview video", "app store video", "promo video", "Play Store video", "video poster frame", "YouTube promo for Play Store", "30 second app video", "video script", "video specs", or "should I add a preview video". For static screenshots, see screenshot-optimization. For A/B testing the video, see ab-test-store-listing. For broader creative briefs, see screenshot-optimization (covers stills).