vibe-aso
You vibe-coded the app — now vibe the ASO. A Claude Code skill: keyword research, 50-locale App Store metadata, localized screenshots, worldwide pricing, in-app localization.
What is it?
What it is
A Claude Code skill that automates end‑to‑end App Store Optimization for iOS apps, handling keyword research, multi‑locale store metadata, localized screenshots, worldwide pricing, in‑app localization, and a submission checklist.
Why it exists
To eliminate manual ASO work and deliver a fully‑optimized, localized App Store presence directly from Claude Code, with automated verification and clear manual steps for any gaps.
Who should use it
iOS app developers and mobile marketers using Claude Code who want to automate App Store Optimization, localization, and submission workflows
Who should avoid it
Developers not publishing iOS apps, those without macOS access, or users seeking a no-setup no-code SaaS solution (requires App Store Connect API key, fastlane, and technical configuration)
How it works
A quick walkthrough in plain English
How vibe-aso works
Step 1 of 3
You interact with it
Open vibe-aso, send a request, or connect it to your stack.
Features
Advantages
- No signup/SaaS requirements
- Open-source with MIT license
- Supports multiple translation engines
- Automated verification checks
- Cost-effective translation options
- Comprehensive localization coverage
Disadvantages
- Requires App Store Connect API key
- macOS dependency for development
- Complex installation process
- Large font dependencies (~55MB)
- Limited topic metadata support
- Requires additional tools for full functionality
Installation
native
git clone https://github.com/Kronop/vibe-aso /tmp/vibe-aso && cp -R /tmp/vibe-aso/skills/vibe-aso ~/.claude/skills/vibe-aso
FAQ
How do I install the Vibe ASO skill in Claude Code?
Run the two plugin commands in Claude Code: first `/plugin marketplace add Kronop/vibe-aso`, then `/plugin install vibe-aso@vibe-aso-marketplace`. Wait for the first to succeed before pasting the second. If the summary says 'Run /reload-plugins to activate.', execute that command or restart Claude Code. Alternatively, clone the repo and copy the skill folder to `~/.claude/skills/vibe-aso`.
What setup is required the first time I run the skill?
The first run launches a setup wizard that asks for: (1) your App Store Connect API key (stored in `~/.vibe-aso/` with chmod 600), (2) the translation engine to use (Claude subagents by default, or DeepSeek/OpenAI‑compatible API), and (3) a keyword data source (an ASO tool with popularity/difficulty data, or you can continue in degraded mode without one).
Which tools do I need for each ASO phase?
The skill checks prerequisites per phase: Keyword research and metadata generation need nothing extra. For metadata or screenshot upload you need `fastlane` (≥2.234.0). Screenshot rendering requires `node` (run `npm install` and `npx playwright install chromium`). Pricing and submission checklist need `ruby` (bundled with macOS). In‑app localization requires Xcode command‑line tools to rebuild and verify translations. Each phase’s `scripts/check_setup.sh` will tell you exactly what’s missing and how to fix it.
How are localized screenshots generated?
You start with the free Figma template, place your app screenshots over the 'Your screenshot here' placeholders, set background colors, and export each frame as PNG named `iphone_1..N.png` (or ipad/watch) into your project folder. The skill’s bundled renderer (Playwright + per‑script Noto fonts) then burns the localized headings into the top band, handles RTL, and auto‑fits the text. No mockups? Just duplicate the template and follow those steps.
How does worldwide pricing work and what models are available?
Choose a pricing model—uniform, GNI bands, Big Mac index, or Netflix index—and the skill applies it per territory via the App Store Connect API, then performs a read‑back GET to verify the values were set correctly. The App Store Connect API itself is free; you only pay for any external translation engine you select.
What are the cost implications of using Vibe ASO?
The skill itself is free and open source (MIT). You pay only for your Claude usage, and if you opt for the DeepSeek translation engine, roughly $0.50 per app for a full ~400‑string × 40‑locale in‑app localization cascade. The App Store Connect API and the bundled renderer (which downloads OFL‑licensed Google Fonts) incur no extra cost.
Featured in Videos
YouTube tutorials and walkthroughs for vibe-aso
Alternatives
Similar projects ranked by category, topics, and text overlap.
