> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent Skills

> Pre-built ASO & app marketing skills for Cursor, Claude Code, and any Agent Skills-compatible AI assistant

17 ready-to-use skills that turn your AI assistant into an ASO expert. Each skill contains frameworks, scoring rubrics, and output templates — the agent reads the skill, pulls real data via the Appeeky MCP Server, and gives you actionable recommendations.

Open source: [github.com/eronred/aso-skills](https://github.com/eronred/aso-skills)

## Quick Start

<Tabs>
  <Tab title="Cursor">
    Settings (Cmd+Shift+J) → Rules → Add Rule → Remote Rule (Github) → paste:

    ```
    https://github.com/eronred/aso-skills
    ```

    Cursor will automatically discover and use the skills when relevant.
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    npx skills add eronred/aso-skills
    ```

    Or install specific skills:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    npx skills add eronred/aso-skills --skill aso-audit keyword-research market-movers
    ```
  </Tab>

  <Tab title="Manual">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    git clone https://github.com/eronred/aso-skills.git

    # Cursor
    cp -r aso-skills/skills/* .cursor/skills/

    # Claude Code
    cp -r aso-skills/skills/* .claude/skills/

    # Any Agent Skills-compatible tool
    cp -r aso-skills/skills/* .agents/skills/
    ```
  </Tab>
</Tabs>

<Info>
  Skills work best with the [Appeeky MCP Server](/docs/mcp) connected — the agent pulls live App Store data automatically. Without it, skills still provide expert frameworks and guidance using general ASO knowledge.
</Info>

## Available Skills

### ASO Core

| Skill                   | What it does                                                                                | MCP Tools Used                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `aso-audit`             | Scores your listing across 10 factors (0-100), flags problems, gives a prioritized fix list | `aso_full_audit`, `get_app`, `get_app_keywords`                       |
| `keyword-research`      | Finds keywords by volume × difficulty × relevance, groups into primary/secondary/long-tail  | `get_keyword_suggestions`, `get_keyword_metrics`, `get_keyword_ranks` |
| `metadata-optimization` | Writes title, subtitle, keyword field, description — with 3 variants and character counts   | `aso_validate_metadata`, `aso_suggest_metadata`, `get_app`            |
| `competitor-analysis`   | Keyword gaps, creative teardown, positioning map, and specific opportunities to exploit     | `aso_competitor_report`, `compare_keywords`, `get_app_intelligence`   |

### Market Intelligence

| Skill           | What it does                                                                                         | MCP Tools Used                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `market-movers` | Identifies top chart gainers/losers, new entries, and dropped apps — explains what's driving changes | `get_market_movers`, `get_market_activity`, `get_category_top`                                               |
| `market-pulse`  | Full market briefing: chart movements + trending keywords + featured apps + new launches in one view | `get_market_movers`, `get_market_activity`, `get_trending_keywords`, `get_featured_apps`, `get_new_releases` |

### Creative & International

| Skill                     | What it does                                                                              | MCP Tools Used                                   |
| ------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `screenshot-optimization` | 10-slot screenshot strategy with design briefs, text overlay copy, and competitor audit   | `get_app`, competitor screenshots                |
| `review-management`       | Sentiment analysis, response templates (HEAR framework), rating improvement tactics       | `get_app_reviews`, `get_app`                     |
| `localization`            | Market prioritization matrix, per-country keyword research, cultural adaptation checklist | `get_keyword_suggestions`, `get_keyword_metrics` |

### Growth

| Skill                | What it does                                                                                 | MCP Tools Used                                               |
| -------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `app-launch`         | 8-week launch timeline with daily checklists, channel strategy, and press outreach templates | `search_apps`, `get_category_top`, `get_keyword_suggestions` |
| `ua-campaign`        | Apple Search Ads, Meta, Google UAC — campaign structure, bidding, budget allocation          | `get_keyword_metrics`, `get_app_intelligence`                |
| `app-store-featured` | Featuring readiness score, Apple tech checklist, pitch template, In-App Events calendar      | `get_featured_apps`, `get_app`                               |

### Revenue & Retention

| Skill                    | What it does                                                                  | MCP Tools Used                            |
| ------------------------ | ----------------------------------------------------------------------------- | ----------------------------------------- |
| `monetization-strategy`  | Pricing tiers, paywall timing/design, trial optimization, category benchmarks | `get_app_intelligence`, `get_app`         |
| `retention-optimization` | Activation → habit → engagement framework, push sequences, churn prevention   | `get_app_reviews`, `get_app_intelligence` |

### Analytics & Testing

| Skill                   | What it does                                                                 | MCP Tools Used                                 |
| ----------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------- |
| `app-analytics`         | Event tracking plan, dashboard setup, KPI framework with category benchmarks | `get_app_intelligence`, `get_country_rankings` |
| `ab-test-store-listing` | Hypothesis → variant design → sample size → interpretation for A/B tests     | `get_app`, `get_app_intelligence`              |

### Foundation

| Skill                   | What it does                                                                              | MCP Tools Used                               |
| ----------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------- |
| `app-marketing-context` | Creates a context doc (app, audience, competitors, goals) that all other skills reference | `get_app`, `get_app_keywords`, `search_apps` |

## How Skills Work

```
You: "Run an ASO audit for Headspace"

Agent:
  1. Reads aso-audit/SKILL.md (framework, scoring rubric, output template)
  2. Calls Appeeky MCP → fetches metadata, keywords, ratings, competitors
  3. Scores each factor (title: 8/10, subtitle: 6/10, keywords: 4/10...)
  4. Returns: ASO Score Card + Quick Wins + High-Impact Changes + Strategic Recs
```

Skills reference each other — `aso-audit` might suggest running `keyword-research` for deeper analysis, which then feeds into `metadata-optimization` for implementation.

## Example Prompts

**ASO:**

```
Run a full ASO audit on my app (id: 570060128).
What's my score and what should I improve?
```

**Keywords:**

```
Find the best keywords for a meditation app.
Show me volume, difficulty, and which ones my competitors rank for.
```

**Market intelligence:**

```
What apps are rising in the free charts right now?
Show me the top gainers in Games and any new entries.
```

**Market briefing:**

```
Give me a full market pulse for the Health & Fitness category.
Include chart movers, trending keywords, and featured apps.
```

**Competitor analysis:**

```
Compare my app (id: 493145008) against Calm (id: 571800810).
Where am I falling behind on keywords and creative?
```

**Launch planning:**

```
I'm launching a fitness app in 6 weeks.
Create a launch plan with ASO, marketing, and PR milestones.
```

## Skill Compatibility

| Platform                  | Install Method                                | Status          |
| ------------------------- | --------------------------------------------- | --------------- |
| **Cursor**                | Settings → Rules → Remote Rule                | Fully supported |
| **Claude Code**           | `npx skills add` or manual copy               | Fully supported |
| **Windsurf**              | Copy to `.agents/skills/`                     | Compatible      |
| **Any Agent Skills tool** | Copy to `.agents/skills/` or `.codex/skills/` | Compatible      |

Skills follow the open [Agent Skills](https://agentskills.io) standard — any tool that reads `SKILL.md` files can use them.

## Contributing

Found an inaccuracy? Have a better framework? Want to add a skill? Contributions are welcome.

See the [Contributing Guide](https://github.com/eronred/aso-skills/blob/main/CONTRIBUTING.md) on GitHub.