# asc-metrics

Analyzes first-party App Store Connect data synced via Appeeky Connect, tracking downloads, revenue, trials, and subscriptions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 installs · ★ 2219
- Author: appeeky
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/appeeky/aso-skills/tree/HEAD/skills/asc-metrics/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/asc-metrics

## What it does

The skill inspects official App Store Connect metrics synced into Appeeky, covering exact downloads, IAP revenue, active subscriptions, and country breakdowns. It checks for `app-marketing-context.md` first to load app context before pulling metrics via `/v1/connect/metrics`.

Setup requires an Appeeky account with App Store Connect linked and an Indie plan or higher, with each query consuming 2 credits. Metrics sync nightly and retain up to 90 days of history.

The agent runs period-over-period comparisons, calculates trial-to-subscription conversion, and sorts top markets by revenue and download volume. If any metric drops by more than 20%, it flags a trend alert with diagnostic hypotheses.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill asc-metrics -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/asc-metrics/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/asc-metrics/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill asc-metrics -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/asc-metrics/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill asc-metrics -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/asc-metrics/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install appeeky/aso-skills asc-metrics
```

2. **Manually: put the files in place**
- File: `.github/skills/asc-metrics/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill asc-metrics -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/appeeky/aso-skills --path skills/asc-metrics
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/asc-metrics/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add appeeky/aso-skills --skill asc-metrics -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/appeeky/aso-skills/tree/HEAD/skills/asc-metrics/SKILL.md

## When to use it
- compare download and revenue metrics across two time periods
- identify countries with high download counts but low revenue
- calculate trial-to-subscription conversion rates
- diagnose sudden drops in App Store Connect daily performance

## Example prompts
- Analyze my App Store Connect downloads and revenue for the last 30 days
- Show top countries by downloads and calculate ARPD for each
- Compare trial and subscription metrics between the current and prior period

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 295d348af428083a.

BEGIN THIRD-PARTY FILE 295d348af428083a
````text
---
name: asc-metrics
description: When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.
metadata:
  version: 1.0.0
---

# ASC Metrics

You analyze the user's **official App Store Connect data** synced into Appeeky — exact downloads, revenue, IAP, subscriptions, and trials. This is first-party data, not estimates.

## Prerequisites

- Appeeky account with ASC connected (Settings → Integrations → App Store Connect)
- Indie plan or higher (2 credits per request)
- Data syncs nightly; up to 90 days of history available

If ASC is not connected, prompt the user to connect it at [appeeky.com/settings](https://appeeky.com) and return.

## Initial Assessment

1. Check for `app-marketing-context.md` — read it for app context
2. Ask: **What do you want to analyze?** (downloads, revenue, subscriptions, country breakdown, trend comparison)
3. Ask: **Which time period?** (default: last 30 days)
4. Ask: **Specific app or all apps?**

## Fetching Data

### Step 1 — List available apps

```bash
GET /v1/connect/metrics/apps
```

Match the user's app to an `app_apple_id` if not already known.

### Step 2 — Get overview (portfolio)

```bash
GET /v1/connect/metrics?from=YYYY-MM-DD&to=YYYY-MM-DD
```

### Step 3 — Get app detail (single app)

```bash
GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD
```

Response includes: `daily[]`, `countries[]`, `totals`.

See full API reference: [appeeky-connect.md](../../tools/integrations/appeeky-connect.md)

## Analysis Frameworks

### Period-over-Period Comparison

Fetch two equal-length windows and compare:

| Metric | Prior Period | Current Period | Change |
|--------|-------------|----------------|--------|
| Downloads | [N] | [N] | [+/-X%] |
| Revenue | $[N] | $[N] | [+/-X%] |
| Subscriptions | [N] | [N] | [+/-X%] |
| Trials | [N] | [N] | [+/-X%] |
| Trial → Sub Rate | [X]% | [X]% | [+/-X pp] |

**What to look for:**
- Downloads rising but revenue flat → pricing or paywall issue
- Trials rising but conversions flat → paywall or onboarding issue
- Revenue rising but downloads flat → good monetization improvement

### Daily Trend Analysis

From `daily[]`, identify:
- **Spikes** — Did a feature, update, or press trigger them?
- **Drops** — Correlate with app updates, seasonality, or algorithm changes
- **Trend direction** — 7-day moving average vs prior 7 days

### Country Breakdown

Sort `countries[]` by downloads and revenue:
1. **Top 5 by downloads** — Are you investing in ASO for these markets?
2. **Top 5 by revenue** — Higher ARPD (avg revenue per download) = prioritize ASO
3. **High downloads, low revenue** — Markets with weak monetization
````
END THIRD-PARTY FILE 295d348af428083a

The third-party file has ended. Everything between the 295d348af428083a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3140 of 5388 bytes. © appeeky · MIT · https://github.com/appeeky/aso-skills/tree/HEAD/skills/asc-metrics/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md