🚀 App Store Optimization (ASO) Agent and Agent Skill System for Claude Code

Professional App Store Optimization (ASO) powered by AI agents

Features • Installation • Quick Start • Documentation • Examples

---

📋 Overview

The ASO (App Stores Optimization) Agent System for Claude Code is a comprehensive, production-ready multi-agent framework for App Store Optimization (ASO) built for Claude Code and Claude Desktop/Web App. It combines specialized AI agents including a Agent Skill (Claude's New Feature) set with real-time data fetching to generate actionable, copy-paste ready deliverables for iOS and Android app optimization.

Two ways to use:

• 🖥️ Claude Code CLI - Full multi-agent system with automated workflows (developers)
• 🌐 Claude Desktop/Web App - Standalone skill for conversational ASO analysis (everyone)

🎯 What Makes This Different

Unlike generic ASO tools that provide analysis reports, this system delivers:

✅ Copy-Paste Ready Metadata - Character-validated content ready for App Store Connect and Google Play Console ✅ Real Data Integration - iTunes Search API + WebFetch for competitor intelligence ✅ Actionable Task Checklists - 47-item pre-launch validation with success criteria ✅ Specific Timelines - Real calendar dates, not "Week 1" placeholders ✅ Complete Workflow - 5-phase execution from research to ongoing optimization

---

✨ Features

🤖 Multi-Agent System

4 Specialized Agents working in coordinated workflow:

• aso-master - Orchestrator coordinating all specialist agents (Opus model)
• aso-research - Keyword research + competitor analysis with iTunes API (Opus model)
• aso-optimizer - Metadata generation with character validation (Sonnet model)
• aso-strategist - Launch timelines + ongoing optimization (Opus model)

📊 Real Data Integration

• iTunes Search API - Free, official Apple API for competitor data (tested & working)
• WebFetch Utilities - Additional scraping for comprehensive analysis
• Character Validation - Apple (30/30/100) and Google (50/80/4000) limits enforced
• Natural Language Checking - No keyword stuffing, reads professionally

📁 Comprehensive Deliverables

outputs/[YourApp]/
├── 00-MASTER-ACTION-PLAN.md      # Complete roadmap with ASO score
├── 01-research/
│   ├── keyword-list.md           # 20 priority keywords, tiered strategy
│   ├── competitor-gaps.md        # Competitive opportunities
│   └── action-research.md        # Research tasks checklist
├── 02-metadata/
│   ├── apple-metadata.md         # Copy-paste ready (App Store Connect)
│   ├── google-metadata.md        # Copy-paste ready (Play Console)
│   ├── visual-assets-spec.md     # Designer briefing
│   └── action-metadata.md        # Implementation tasks
├── 03-testing/
│   ├── ab-test-setup.md          # A/B test configuration
│   └── action-testing.md         # Testing tasks
├── 04-launch/
│   ├── prelaunch-checklist.md    # 47-item validation
│   ├── timeline.md               # Specific calendar dates
│   ├── submission-guide.md       # Platform procedures
│   └── action-launch.md          # Launch tasks
├── 05-optimization/
│   ├── review-responses.md       # Pre-written templates
│   ├── ongoing-tasks.md          # Daily/weekly/monthly schedule
│   └── action-optimization.md    # Optimization tasks
└── FINAL-REPORT.md               # Executive summary

⚡ Slash Commands

Four user-facing workflows:

| Command | Duration | Output | |---------|----------|--------| | /aso-full-audit [AppName] | 30-40 min | Complete audit with all phases | | /aso-optimize [AppName] | 10-15 min | Metadata optimization only | | /aso-prelaunch [AppName] | 15-20 min | Pre-launch validation checklist | | /aso-competitor [AppName] "App1,App2" | 10-15 min | Competitive intelligence |

---

🚀 Quick Start

Prerequisites

Choose Your Platform:

• Claude Code (CLI) - Full multi-agent system with automation
• Claude Desktop/Web App - Standalone skill for direct conversations
• macOS, Linux, or Windows
• Internet connection (for iTunes API)

Installation (< 5 minutes)

Option 1: Claude Code (Full Multi-Agent System) - Recommended

For developers using Claude Code CLI who want the complete multi-agent workflow:

# Clone repository
git clone https://github.com/alirezarezvani/claude-code-aso-skill.git
cd claude-code-aso-skill

# Install agents (user-level)
cp .claude/agents/aso/*.md ~/.claude/agents/

# Install slash commands (optional)
cp .claude/commands/aso/*.md ~/.claude/commands/

# Verify installation
claude --list-agents | grep aso

---

Option 2: Claude Desktop/Web App (Standalone Skill) - Easy Upload

For users of Claude Desktop or Web App who want quick ASO analysis:

Step 1: Download the Skill Package

# Download app-store-optimization.zip from the repository
# Or use wget/curl:
wget https://github.com/alirezarezvani/claude-code-aso-skill/raw/main/app-store-optimization.zip

Step 2: Upload to Claude

For Claude Desktop App:

1. Open Claude Desktop
2. Go to Settings (⚙️ icon)
3. Navigate to Capabilities tab
4. Click Upload Custom Skill
5. Select app-store-optimization.zip
6. Wait for "Skill installed successfully" message
7. Ready to use!

For Claude Web App:

1. Go to claude.ai
2. Click your profile icon → Settings
3. Navigate to Capabilities section
4. Click Upload Custom Skill
5. Select app-store-optimization.zip
6. Confirm upload
7. Ready to use!

Step 3: Start Using

Hey Claude, I just added the app-store-optimization skill.
Analyze my app: FitFlow - fitness tracking app for beginners.
Generate a complete ASO strategy with keyword research and metadata.

---

Option 3: Manual Installation (Advanced)

For advanced users who want to customize the skill:

# Extract and install skill manually
unzip app-store-optimization.zip
cp -r app-store-optimization ~/.claude/skills/

# For Claude Code CLI
# Restart Claude Code
claude --reload

# For Claude Desktop
# Restart Claude Desktop app

First Run

For Claude Code Users:

# Start Claude Code in your project directory
claude

# Run complete ASO audit
/aso-full-audit MyAwesomeApp

# Review outputs
cd outputs/MyAwesomeApp
cat 00-MASTER-ACTION-PLAN.md

For Claude Desktop/Web App Users:

Start a new conversation and say:

"Hey Claude, I just added the app-store-optimization skill.
I need help with App Store Optimization for my app called 'MyAwesomeApp'.
It's a fitness tracking app for beginners.

Please generate:
1. Keyword research with 20 priority keywords
2. Copy-paste ready metadata for Apple App Store
3. Copy-paste ready metadata for Google Play Store
4. A complete action plan with timeline"

That's it! You'll receive a complete ASO strategy with copy-paste ready metadata, keyword research, and actionable recommendations.

---

📖 Usage

Typical Workflows

1️⃣ New App Launch (Complete Workflow)

/aso-full-audit MyApp

Generates:

• ASO health score (0-100)
• 20 priority keywords with implementation guide
• Copy-paste ready metadata (Apple + Google)
• 47-item pre-launch checklist
• Timeline with specific dates
• Ongoing optimization schedule

Time: 30-40 minutes Output: Complete outputs/MyApp/ folder

---

2️⃣ Existing App Optimization

/aso-optimize MyApp

Generates:

• Updated metadata optimized for current keywords
• A/B test variants
• Visual asset specifications

Time: 10-15 minutes Output: outputs/MyApp/02-metadata/ folder

---

3️⃣ Pre-Launch Validation

/aso-prelaunch MyApp

Generates:

• 47-item validation checklist
• Submission procedures
• Launch timeline
• Common rejection fixes

Time: 15-20 minutes Output: outputs/MyApp/04-launch/ folder

---

4️⃣ Competitive Intelligence

/aso-competitor MyApp "Todoist,Any.do,Microsoft To Do"

Generates:

• Competitor keyword analysis
• Feature gap identification
• Pricing strategy comparison
• Opportunity areas

Time: 10-15 minutes Output: outputs/MyApp/01-research/competitor-gaps.md

---

Quality Standards

All outputs meet these standards:

✅ Character Limits Validated

• Apple title ≤ 30 chars
• Apple subtitle ≤ 30 chars
• Apple keywords ≤ 100 chars (no duplicates)
• Google title ≤ 50 chars
• Google short description ≤ 80 chars

✅ Real Dates, Not Placeholders

• "November 7-13, 2025" ✅
• "Week 1" ❌

✅ Copy-Paste Ready

• No additional formatting needed
• Pre-validated character counts
• Platform constraints respected

✅ Actionable Tasks

• Checkbox format with success criteria
• Validation methods included
• Implementation guidance provided

---

🎯 Example Outputs

See the complete example workflow for a fictional fitness app:

FitFlow Example

Master Action Plan

# Master Action Plan: FitFlow

**ASO Health Score:** 58/100
**Priority Level:** High (New App Launch)

## Timeline
November 7-10, 2025: Research Phase
November 11-17, 2025: Metadata & Visual Assets
November 18-20, 2025: A/B Test Setup
November 21-25, 2025: Launch Preparation
December 1, 2025: PUBLIC LAUNCH 🚀

Keyword Research

| Keyword | Search Volume | Difficulty | Implementation |
|---------|--------------|------------|------------