This repo packages an ASO workflow for Claude Code, plus a standalone Claude skill for Claude Desktop and the Claude web app. It combines specialized agents, slash commands, and a Python skill package to generate keyword research, metadata, launch checklists, and executive summaries.
Builders who want Claude Code to do app store optimization work for their iOS or Android app.
You can turn app ideas into copy-paste store metadata, keyword research, and launch plans without assembling the workflow yourself.
Uses four named agents: `aso-master`, `aso-research`, `aso-optimizer`, and `aso-strategist`.
Provides `/aso-full-audit`, `/aso-optimize`, `/aso-prelaunch`, and `/aso-competitor` for common ASO tasks.
Ships `app-store-optimization.zip` for upload into Claude Desktop or the Claude web app.
Uses the iTunes Search API and WebFetch utilities for app and competitor research.
Generates App Store and Google Play metadata with character limits checked and output folders organized by app.
Creates pre-launch validation, testing, and ongoing optimization docs with concrete action items.
# 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
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.
/aso-full-audit MyApp
/aso-optimize MyApp
/aso-prelaunch MyApp
/aso-competitor MyApp "Todoist,Any.do,Microsoft To Do"
Professional App Store Optimization (ASO) powered by AI agents
Features • Installation • Quick Start • Documentation • Examples
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:
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
4 Specialized Agents working in coordinated workflow:
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
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 |
Choose Your Platform:
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
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:
app-store-optimization.zipFor Claude Web App:
app-store-optimization.zipStep 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.
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
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.
/aso-full-audit MyApp
Generates:
Time: 30-40 minutes
Output: Complete outputs/MyApp/ folder
/aso-optimize MyApp
Generates:
Time: 10-15 minutes
Output: outputs/MyApp/02-metadata/ folder
/aso-prelaunch MyApp
Generates:
Time: 15-20 minutes
Output: outputs/MyApp/04-launch/ folder
/aso-competitor MyApp "Todoist,Any.do,Microsoft To Do"
Generates:
Time: 10-15 minutes
Output: outputs/MyApp/01-research/competitor-gaps.md
All outputs meet these standards:
✅ Character Limits Validated
✅ Real Dates, Not Placeholders
✅ Copy-Paste Ready
✅ Actionable Tasks
See the complete example workflow for a fictional fitness app:
# 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 | Search Volume | Difficulty | Implementation |
|---------|--------------|------------|----------------|
| fitness tracker | 85,000/mo | 55/100 | Apple Title |
| workout planner | 62,000/mo | 48/100 | Apple Subtitle |
| exercise log | 45,000/mo | 42/100 | Description |
### Title (30 chars max)
FitFlow: Fitness Tracker
Character Count: 25/30 ✅
### Subtitle (30 chars max)
Easy Workout Planner & Log
Character Count: 26/30 ✅
### Keywords (100 chars max)
activity,goals,routine,challenge,calories,home,progress,simple,exercise,fitness,beginner
Character Count: 91/100 ✅
┌─────────────────────────────────────────────────────────────────┐
│ ASO Agent System │
│ │
│ Standalone Skill ←─────→ Agent System ←─────→ User Outputs │
└─────────────────────────────────────────────────────────────────┘
Layer 1: Standalone Skill (app-store-optimization/)
↓
Layer 2: Agent-Integrated Skill (.claude/skills/aso/)
↓
Layer 3: Agent Definitions (.claude/agents/aso/)
↓
Layer 4: Slash Commands (.claude/commands/aso/)
↓
Layer 5: Output Structure (outputs/[app-name]/)
Standalone Skill (app-store-optimization/)
app-store-optimization.zip)ZIP Package for Claude Desktop/Web App (app-store-optimization.zip)
Agent-Integrated (.claude/skills/aso/)
Choose Your Version:
See ARCHITECTURE.md for complete details.
| Document | Description |
|---|---|
| ARCHITECTURE.md | Complete system architecture (509 lines) |
| INSTALL.md | Installation guide for 3 scenarios |
| USAGE.md | Usage guide with 5 workflows |
| CLAUDE.md | Quick reference for Claude instances |
| Implementation Plan | Complete development plan (400+ lines) |
| Data Sources | API documentation and limitations |
cd .claude/skills/aso && python3 lib/itunes_api.py
Test Results:
✅ Search for apps: PASSED (Todoist found)
✅ Get app by name: PASSED (Metadata extracted)
✅ Get competitors: PASSED (Top productivity apps fetched)
✅ Compare competitors: PASSED (3 apps compared successfully)
Sample Output:
- Todoist: 4.8★ (120,655 ratings)
- Any.do: 4.6★ (49,604 ratings)
- Microsoft To Do: 4.7★ (250,014 ratings)
Created: outputs/FitFlow-example/
Quality Validation:
✅ Character counts validated
✅ Real dates used (November 7 - December 1, 2025)
✅ Actionable tasks with success criteria
✅ Natural language (no keyword stuffing)
✅ Copy-paste ready content
Contributions are welcome! Here's how you can help:
Additional Data Sources
Localization
Enhanced Analytics
Documentation
# Fork repository
git clone https://github.com/alirezarezvani/claude-code-aso-skill.git
cd claude-code-aso-skill
# Create feature branch
git checkout -b feature/your-feature-name
# Make changes and test
# ... your changes ...
# Commit with clear message
git commit -m "feat: add AppTweak API integration"
# Push and create PR
git push origin feature/your-feature-name
This project is licensed under the MIT License - see the LICENSE.md file for details.
MIT License - Copyright (c) 2025 Alireza Rezvani
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software.
Q: Do I need paid ASO tools? A: No. This system uses free iTunes Search API and industry benchmarks.
Q: Can I use this for both iOS and Android? A: Yes. Generates metadata for both Apple App Store and Google Play Store.
Q: How accurate are the keyword search volumes? A: Estimates based on industry benchmarks (±20% accuracy). Use Apple Search Ads data for exact volumes.
Q: Can I customize the agents?
A: Yes. All agents are Markdown files in .claude/agents/aso/ - edit freely.
If you find this project useful, please consider giving it a star on GitHub!
Built with ❤️ using Claude Code
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
A skill to stop your coding agent from burying the answer. ADHD-friendly output.
AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
De-AI writing skill for any Agent Skills-compatible agent (77+ via the Skills CLI), with native plugins for Claude Code, Codex, Grok Build, and Antigravity. Narrative-architecture repair for fiction, venue-matched rules for professional prose. Based on StoryScope (arXiv:2604.03136).
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Agent skill that removes signs of AI-generated writing from text