100% Open Source ASO toolkit for Claude Code
No subscriptions. No API keys required. No hidden costs.
Features • Installation • Quick Start • Commands • Workflows
ASO Skill is a completely free and open source App Store Optimization toolkit for Claude Code. Generate metadata, analyze competitors, create screenshots, manage versions, and submit to App Store Connect - all with 6 simple commands.
- No monthly fees - Unlike AppTweak, Sensor Tower, or ASOTools
- No API limits - Use as much as you want
- Full transparency - See exactly how it works
- Community driven - Contribute and improve together
- Self-hosted - Your data stays with you
| Feature | Traditional ASO Tools | ASO Skill |
|---|---|---|
| Price | $50-500/month | Free forever |
| Metadata Generation | Manual writing | AI-powered, character-validated |
| Competitor Analysis | Expensive subscriptions | Free iTunes API integration |
| Screenshots | Design software needed | AI-generated with Gemini MCP |
| App Store Connect | Manual submission | Direct API integration |
| Version Management | ASC web interface | CLI commands |
| Workflow | Fragmented tools | 6 unified commands |
- Quick mode - Copy-paste ready metadata in minutes
- Audit mode - Full competitor analysis and research
- Localize mode - Translate .xcstrings to 70+ languages
- Character validation - All limits enforced
- Setup wizard - Configure API credentials
- Status check - Verify submission readiness
- Sync metadata - Push to ASC directly
- Create versions - New App Store versions
- Attach builds - Link builds to versions
- Submit for review - One command submission
- What's New - Generate from git commits
- Phased release - Control rollout percentage
- Screenshots - AI-generated with Gemini MCP
- IAP setup - Create and manage in-app purchases
- Upload - Push assets to ASC
- Reviews - AI response suggestions
- Legal docs - Privacy Policy, Terms, EULA
- GDPR/CCPA - Compliance ready
- XcodeBuildMCP - Build, archive, upload
- Simulator/Device - Target any platform
- TestFlight - Direct upload
git clone https://github.com/furkancingoz/aso-skill.git ~/.claude/skills/asomkdir -p .claude/skills
git clone https://github.com/furkancingoz/aso-skill.git .claude/skills/aso# Required: JWT token generation
pip3 install PyJWT cryptography
# Optional: Screenshot generation
claude mcp add gemini-mcp -s user -- npx -y @houtini/gemini-mcp
export GEMINI_API_KEY="your_key"
# Optional: IAP sync with RevenueCat
claude mcp add --transport http revenuecat https://mcp.revenuecat.ai/mcp \
--header "Authorization: Bearer YOUR_V2_API_KEY"/aso-connect setup
/aso TaskFlow
/aso-assets screenshots
/aso-release create 1.0.0
/aso-release attach
/aso-connect sync
/aso-release submit
| Command | Purpose | Subcommands |
|---|---|---|
/aso |
Metadata generation | (default), --audit, --localize |
/aso-connect |
ASC integration | setup, status, sync |
/aso-release |
Version management | create, attach, submit, notes, phased |
/aso-assets |
Screenshots & IAP | screenshots, iap |
/aso-manage |
Reviews & legal | reviews, legal |
/aso-build |
Xcode build | (default), --archive, --upload |
# Quick metadata
/aso "My App Name"
# Full audit with competitors
/aso MyApp --audit --competitors "Todoist,Any.do"
# Translate to multiple languages
/aso --localize tr,de,ja
# Check submission readiness
/aso-connect status
# Create new version and submit
/aso-release create 1.2.0
/aso-release attach
/aso-release submit
# Generate screenshots
/aso-assets screenshots
# Manage reviews
/aso-manage reviews --negative
# Generate legal documents
/aso-manage legal privacy/aso-connect setup # 1. Configure credentials
/aso AppName --audit # 2. Research + optimize
/aso-assets screenshots # 3. Generate screenshots
/aso-assets iap # 4. Set up IAPs
/aso-release create 1.0.0 # 5. Create version
/aso-release attach # 6. Attach build
/aso-connect sync # 7. Push metadata
/aso-connect status # 8. Verify readiness
/aso-release submit # 9. Submit for review
/aso-release notes # Generate What's New from git
/aso-release create 1.1.0 # Create new version
/aso-release attach # Attach latest build
/aso-release submit # Submit for review
/aso-release phased start # Enable phased release
/aso --localize tr,de,ja # Translate .xcstrings
/aso-connect sync --locale tr # Sync Turkish metadata
| Field | Limit | Notes |
|---|---|---|
| Title | 30 | Include primary keyword |
| Subtitle | 30 | No overlap with title |
| Keywords | 100 | Comma-separated, no spaces |
| Promo Text | 170 | Editable without update |
| Description | 4000 | Include app name 3-5x |
| Field | Limit | Notes |
|---|---|---|
| Title | 50 | More keywords allowed |
| Short Desc | 80 | Shows in search results |
| Full Desc | 4000 | Keywords ARE indexed |
aso-skill/
├── SKILL.md # Main skill definition
├── CLAUDE.md # Development guidance
├── README.md # This file
├── agents/
│ ├── aso-quick.md # Fast metadata (sonnet)
│ └── aso-full.md # Full audit (opus)
├── commands/
│ ├── aso.md # Metadata + audit + localize
│ ├── aso-connect.md # Setup + status + sync
│ ├── aso-release.md # Version + build + submit
│ ├── aso-assets.md # Screenshots + IAP
│ ├── aso-manage.md # Reviews + legal
│ └── aso-build.md # Xcode build
├── lib/
│ ├── itunes_api.py # iTunes Search API
│ ├── keyword_engine.py # Keyword analysis
│ └── asc_api.py # App Store Connect API
└── templates/
├── apple-metadata.md
└── google-metadata.md
- Direct API integration
- JWT authentication
- Version, build, metadata management
- Free, official Apple API
- Competitor analysis
- No authentication required
claude mcp add gemini-mcp -s user -- npx -y @houtini/gemini-mcp
export GEMINI_API_KEY="your_key"claude mcp add --transport http revenuecat https://mcp.revenuecat.ai/mcp \
--header "Authorization: Bearer YOUR_V2_API_KEY"- Build, archive, upload
- See: https://github.com/getsentry/XcodeBuildMCP
This skill combines best practices from:
| Project | Contribution |
|---|---|
| alirezarezvani/claude-code-aso-skill | Multi-agent system, structured outputs |
| Mehrozsheikh/aso-appstore-listing-skill | Minimal skill format, Astro MCP |
| adamlyttleapps/claude-skill-aso-appstore-screenshots | Screenshot generation |
No. This skill uses free iTunes Search API and industry benchmarks.
Yes. Generates metadata for Apple App Store and Google Play Store.
Direct API calls using JWT authentication. Run /aso-connect setup to configure.
Yes. All agents are Markdown files - edit freely.
# 1. Fork on GitHub, then clone
git clone https://github.com/YOUR_USERNAME/aso-skill.git
cd aso-skill
# 2. Install and use immediately
cp -r . ~/.claude/skills/aso/
# 3. Customize as you want
# - Edit commands/*.md for new features
# - Modify lib/*.py for API changes
# - Add new agents in agents/git checkout -b feature/your-feature
git commit -m "feat: add your feature"
git push origin feature/your-feature
# Open a Pull Request- 🌐 Google Play API - Play Console integration
- 📊 Analytics Dashboard - Keyword ranking history
- 🤖 More MCPs - AppTweak, Sensor Tower integrations
- 🌍 More Languages - Expand localization support
- 📱 TestFlight Management - Beta tester workflows
commands/ ← Add new /aso-xxx commands here
lib/ ← Python API clients
agents/ ← AI agent definitions
templates/ ← Output templates
All files are Markdown or Python - no complex build system.
MIT License - see LICENSE for details.
You can:
- ✅ Use commercially
- ✅ Modify freely
- ✅ Distribute copies
- ✅ Use privately
- ✅ Sublicense
Created by @furkancingoz