appeeky/aso-skills

What is appeeky/aso‑skills?

A collection of Agent Skills – ready‑made prompts and logic bundles that let an AI‑assistant (e.g., Cursor, Claude Code, or any tool that follows the Agent Skills spec) act as a personal App‑Store‑Optimization (ASO) consultant. Each skill contains a framework, scoring rubric, and output template, then calls the Appeeky API to fetch real‑time App Store / Google Play data. The result is a conversational, data‑driven assistant that can audit listings, research keywords, write metadata, analyse competitors, plan in‑app events, and even build Apple Search Ads campaigns.

---

Core idea

1. Skill files (e.g., aso-audit, keyword‑research) describe what the assistant should do and how to format the answer.
2. When the assistant receives a natural‑language request, it reads the appropriate skill, invokes the Appeeky API for live store data, runs the built‑in framework, and returns a concise, actionable report.
3. A single router skill (aso-router) can dispatch any ASO‑related query to the correct specialist skill, so users don’t need to remember individual names.

---

Main capabilities (grouped by the README)

Category	Example skills	What you get
ASO Core	aso-audit, keyword-research, metadata-optimization	Scored audit of your listing, keyword lists ranked by volume/difficulty, three ready‑to‑publish title/description variants.
Creative & International	screenshot-optimization, app-preview-video, localization	Design briefs for screenshots & preview videos, locale‑specific keyword calendars, cultural adaptation checklists.
Growth & User‑Acquisition	ua-campaign, apple-search-ads, creator-ugc-marketing	Full campaign structures for ASA, Meta/TikTok ads, creator‑driven UGC briefs, budget allocation guides.
Revenue & Retention	paywall-optimization, subscription‑lifecycle, retention-optimization	Paywall audit, churn‑reduction playbooks, push‑notification sequences.
Analytics & Testing	asc-metrics, ab-test-store-listing, crash-analytics	Direct pull of your App Store Connect numbers, A/B‑test design & sample‑size calculator, crash‑triage framework.
Market Intelligence	market-movers, competitor-tracking	Weekly competitor surveillance, chart‑gainer/loss analysis, trending‑keyword briefs.
Strategy & Recovery	category-positioning, app-rejection-recovery	Guidance on optimal store categories, step‑by‑step response templates for Apple/Google rejections.

---

How it works (simplified flow)

You: "Run an ASO audit for Headspace"
→ Agent loads `aso-audit/SKILL.md`
→ Calls Appeeky API → fetches current title, subtitle, keywords, ratings, competitors
→ Scores each factor (e.g., title 8/10, keywords 4/10)
→ Returns a score card + prioritized quick‑wins + strategic recommendations

The skills are modular; one skill can suggest running another (e.g., after an audit, the agent may call keyword‑research).

---

Installation / Getting started

Platform	Command	What it does
Cursor	npx skills add appeeky/aso-skills -a cursor	Installs all ~40 skills into your local Cursor skill directory.
Claude Code	/plugin marketplace add appeeky/aso-skills then /plugin install aso-skills@aso-skills	Registers the skill pack as a Claude Code plugin (namespaced as /aso-skills:…).
Manual	git clone https://github.com/appeeky/aso-skills.git && cp -r aso-skills/skills/* .cursor/skills/	Copies the skill files directly into any .cursor/skills/ (or .claude/skills/, .agents/skills/) folder.
Any Agent	git submodule add https://github.com/appeeky/aso-skills.git .agents/aso-skills	Adds the repo as a submodule so the agent can read the skill files.

To enable live data, configure the Appeeky MCP endpoint with your API token (see the README’s JSON snippet). The asc-metrics skill also requires an Appeeky Connect integration (Indie plan $8 / month or higher).

---

Typical use‑case examples you can try right away

• "Find the best keywords for a meditation app"
• "Optimize my App Store title and subtitle"
• "Give me a market briefing for the Games category"
• "Plan a Christmas In‑App Event and list seasonal keywords"
• "Build an Apple Search Ads campaign structure for my fitness app"
• "How are my downloads and revenue trending this month?"

If you don’t want to remember each skill name, just start with /aso-router and type a natural‑language request; the router will dispatch it to the appropriate specialist.

---

Who should use it?

• Indie developers who want expert‑level ASO advice without hiring a consultant.
• Growth or marketing teams that already use AI assistants and need a plug‑and‑play library for app‑store tasks.
• Product managers looking for a repeatable, data‑backed framework for launch, retention, and ad‑campaign planning.

---

Contribution & licensing

The project is MIT‑licensed. Contributions are encouraged – you can add new frameworks, improve existing rubrics, or create additional skills. See CONTRIBUTING.md for guidelines.

---

Bottom line

appeeky/aso-skills turns a generic AI coding assistant into a specialized ASO consultant by bundling domain‑specific knowledge, real‑time store data, and ready‑to‑use output templates. It lets you ask natural language questions about app marketing and receive concrete, data‑driven recommendations directly in your development environment.