astro-aso

Query local Astro Mac app database for ASO insights. Use when the user asks about keyword rankings, historical ranking data, trend analysis, competitor keywords, app ratings, keyword opportunities, or ASO health metrics.

16 stars

bydiegosouzapw

View on GitHub Installation ↓

Best use case

astro-aso is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Teams using astro-aso should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/astro-aso/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/backend/astro-aso/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/astro-aso/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How astro-aso Compares

Feature / Agent	astro-aso	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Astro ASO Skill

Query your local Astro Mac app database for App Store Optimization insights.

## When to Use

Invoke this skill when the user asks about:

- Keyword rankings and tracking
- Historical ranking data and trends
- Competitor analysis for keywords
- App ratings and reviews data
- Keyword opportunities and recommendations
- ASO health analysis
- Ranking predictions and anomalies

## Prerequisites

- Astro Mac app installed: https://astro.app
- App must have data (tracked apps/keywords)

## Usage

Run commands via the bundled script:

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs <command> '<json-params>'
```

## Available Commands

### list_apps

List all tracked apps in Astro.

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs list_apps '{}'
```

---

### search_rankings

Search keyword rankings for apps.

| Param   | Type   | Required | Description               |
| ------- | ------ | -------- | ------------------------- |
| keyword | string | YES      | Keyword to search         |
| store   | string | no       | Filter by store (ios/mac) |
| appName | string | no       | Filter by app name        |
| appId   | string | no       | Filter by app ID          |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs search_rankings '{"keyword": "photo editor"}'
```

---

### historical_rankings

Get historical ranking data for a keyword.

| Param    | Type   | Required | Description                   |
| -------- | ------ | -------- | ----------------------------- |
| keyword  | string | YES      | Keyword to track              |
| appName  | string | no       | Filter by app name            |
| appId    | string | no       | Filter by app ID              |
| daysBack | number | no       | Days of history (default: 30) |
| store    | string | no       | Filter by store               |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs historical_rankings '{"keyword": "photo editor", "daysBack": 90}'
```

---

### app_keywords

Get all tracked keywords for an app.

| Param   | Type   | Required | Description       |
| ------- | ------ | -------- | ----------------- |
| appName | string | no\*     | App name to query |
| appId   | string | no\*     | App ID to query   |
| store   | string | no       | Filter by store   |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs app_keywords '{"appName": "My App"}'
```

---

### keyword_trends

Analyze keyword ranking trends over time.

| Param   | Type   | Required | Description                          |
| ------- | ------ | -------- | ------------------------------------ |
| keyword | string | YES      | Keyword to analyze                   |
| appName | string | no       | Filter by app name                   |
| appId   | string | no       | Filter by app ID                     |
| period  | string | no       | week/month/year/all (default: month) |
| store   | string | no       | Filter by store                      |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_trends '{"keyword": "photo editor", "period": "month"}'
```

---

### compare_rankings

Compare rankings between two dates.

| Param   | Type   | Required | Description              |
| ------- | ------ | -------- | ------------------------ |
| keyword | string | YES      | Keyword to compare       |
| date1   | string | YES      | First date (ISO format)  |
| date2   | string | YES      | Second date (ISO format) |
| appName | string | no       | Filter by app name       |
| appId   | string | no       | Filter by app ID         |
| store   | string | no       | Filter by store          |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs compare_rankings '{"keyword": "photo editor", "date1": "2024-01-01", "date2": "2024-02-01"}'
```

---

### app_ratings

Get app ratings and review data.

| Param    | Type   | Required | Description                   |
| -------- | ------ | -------- | ----------------------------- |
| appName  | string | no\*     | App name to query             |
| appId    | string | no\*     | App ID to query               |
| store    | string | no       | Filter by store               |
| daysBack | number | no       | Days of history (default: 30) |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs app_ratings '{"appName": "My App", "daysBack": 60}'
```

---

### keyword_competitors

Find competing apps ranking for a keyword.

| Param   | Type   | Required | Description               |
| ------- | ------ | -------- | ------------------------- |
| keyword | string | YES      | Keyword to analyze        |
| store   | string | no       | Filter by store           |
| limit   | number | no       | Max results (default: 10) |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_competitors '{"keyword": "photo editor", "limit": 20}'
```

---

### keyword_recommendations

Get recommended keywords based on existing ones.

| Param   | Type   | Required | Description               |
| ------- | ------ | -------- | ------------------------- |
| keyword | string | YES      | Base keyword              |
| appName | string | no       | Filter by app name        |
| appId   | string | no       | Filter by app ID          |
| store   | string | no       | Filter by store           |
| limit   | number | no       | Max results (default: 10) |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_recommendations '{"keyword": "photo"}'
```

---

### competitive_landscape

Analyze competitive position for an app.

| Param   | Type   | Required | Description                   |
| ------- | ------ | -------- | ----------------------------- |
| appName | string | no\*     | App name to analyze           |
| appId   | string | no\*     | App ID to analyze             |
| store   | string | no       | Filter by store               |
| limit   | number | no       | Max competitors (default: 10) |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs competitive_landscape '{"appName": "My App"}'
```

---

### keyword_opportunities

Find keyword opportunities (low difficulty, high popularity).

| Param         | Type   | Required | Description          |
| ------------- | ------ | -------- | -------------------- |
| appName       | string | no\*     | App name to analyze  |
| appId         | string | no\*     | App ID to analyze    |
| store         | string | no       | Filter by store      |
| minPopularity | number | no       | Min popularity score |
| maxDifficulty | number | no       | Max difficulty score |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_opportunities '{"appName": "My App", "maxDifficulty": 30}'
```

---

### ranking_anomalies

Detect sudden ranking changes and anomalies.

| Param     | Type   | Required | Description                    |
| --------- | ------ | -------- | ------------------------------ |
| appName   | string | no\*     | App name to analyze            |
| appId     | string | no\*     | App ID to analyze              |
| daysBack  | number | no       | Days to analyze (default: 7)   |
| threshold | number | no       | Change threshold (default: 10) |
| store     | string | no       | Filter by store                |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs ranking_anomalies '{"appName": "My App", "threshold": 15}'
```

---

### ranking_predictions

Predict future rankings based on trends.

| Param       | Type   | Required | Description                  |
| ----------- | ------ | -------- | ---------------------------- |
| keyword     | string | YES      | Keyword to predict           |
| appName     | string | no       | Filter by app name           |
| appId       | string | no       | Filter by app ID             |
| store       | string | no       | Filter by store              |
| daysForward | number | no       | Days to predict (default: 7) |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs ranking_predictions '{"keyword": "photo editor", "daysForward": 14}'
```

---

### low_competition_keywords

Find keywords with low competition.

| Param         | Type   | Required | Description                  |
| ------------- | ------ | -------- | ---------------------------- |
| store         | string | no       | Filter by store              |
| maxDifficulty | number | no       | Max difficulty (default: 30) |
| minPopularity | number | no       | Min popularity (default: 20) |
| limit         | number | no       | Max results (default: 20)    |

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs low_competition_keywords '{"maxDifficulty": 25, "minPopularity": 30}'
```

---

### analyze_aso_health

Get overall ASO health analysis for an app.

| Param   | Type   | Required | Description         |
| ------- | ------ | -------- | ------------------- |
| appName | string | no\*     | App name to analyze |
| appId   | string | no\*     | App ID to analyze   |
| store   | string | no       | Filter by store     |

\*One of appName or appId required

```bash
node .claude/skills/astro-aso/scripts/astro-query.mjs analyze_aso_health '{"appName": "My App"}'
```

## Output Format

All commands return JSON with either:

- `{ "success": true, "data": ... }` on success
- `{ "success": false, "error": "..." }` on failure

## Example Workflow

1. List all tracked apps:

   ```bash
   node .claude/skills/astro-aso/scripts/astro-query.mjs list_apps '{}'
   ```

2. Get keywords for a specific app:

   ```bash
   node .claude/skills/astro-aso/scripts/astro-query.mjs app_keywords '{"appName": "My App"}'
   ```

3. Analyze keyword trends:

   ```bash
   node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_trends '{"keyword": "productivity", "period": "month"}'
   ```

4. Find opportunities:
   ```bash
   node .claude/skills/astro-aso/scripts/astro-query.mjs keyword_opportunities '{"appName": "My App", "maxDifficulty": 40}'
   ```

Related Skills

astro-cta-injector

from diegosouzapw/awesome-omni-skill

Inject Call-to-Action blocks into Astro site content with intelligent placement strategies. Use when the user wants to add CTAs, newsletter signups, product promotions, or any content blocks to blog posts. Supports multiple placement strategies (end, after 50%, after 60%), content scoring for relevance, and dry-run preview.

astro-content

from diegosouzapw/awesome-omni-skill

Create Astro/Starlight MDX content pages. Use when the user says "write a new article", "add a blog post", "create content in Tech/Life category", or "add an MDX page".

astro-blog-write

from diegosouzapw/awesome-omni-skill

Phase 3 - Writing blog content with human voice and SEO optimization

astro-i18n

from diegosouzapw/awesome-omni-skill

Internationalization patterns for Astro sites. Multi-language routing, content translation, locale switching, RTL support. Use for multi-market lead generation.

managing-astro-local-env

from diegosouzapw/awesome-omni-skill

Manage local Airflow environment with Astro CLI. Use when the user wants to start, stop, or restart Airflow, view logs, troubleshoot containers, or fix environment issues. For project setup, see setting-up-astro-project.

astro-seo

from diegosouzapw/awesome-omni-skill

SEO markup patterns for Astro lead generation sites. Meta tags, Open Graph, Schema.org, sitemap, robots. Use for all SEO implementation.

astro-performance

from diegosouzapw/awesome-omni-skill

Core Web Vitals and performance optimization for Astro sites. LCP, CLS, INP optimization, bundle size, fonts, third-party scripts. Use for performance tuning.

astro-forms

from diegosouzapw/awesome-omni-skill

Form infrastructure for Astro. Zod validation, email, rate limiting, Turnstile, GDPR, Sheets. FAIL = no conversion.

bgo

from diegosouzapw/awesome-omni-skill

Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.

Coding & Development

mcp-create-declarative-agent

from diegosouzapw/awesome-omni-skill

Skill converted from mcp-create-declarative-agent.prompt.md

MCP Architecture Expert

from diegosouzapw/awesome-omni-skill

Design and implement Model Context Protocol servers for standardized AI-to-data integration with resources, tools, prompts, and security best practices

mathem-shopping

from diegosouzapw/awesome-omni-skill

Automatiserar att logga in på Mathem.se, söka och lägga till varor från en lista eller recept, hantera ersättningar enligt policy och reservera leveranstid, men lämnar varukorgen redo för manuell checkout.