v1 · Claude Code Skill

Ship iOS apps from Claude Code.

ASO Toolkit turns Claude Code into your App Store operator. Research keywords, generate metadata, capture screenshots, produce AI icons, audit Apple Review Guidelines, and sync with App Store Connect — all with slash commands.

Install the skill See it run

# Clones the skill into your Claude Code skills directory
git clone https://github.com/omerycll/claude-aso.git ~/.claude/skills/aso

# Clone and run the installer
git clone https://github.com/omerycll/claude-aso.git /tmp/aso \
  && bash /tmp/aso/install-skill.sh

# Restart Claude Code, then inside your Xcode project:
/aso init
/aso check

Slash commands

100+

Guideline checks

Icons & translations

External services stored

Features

Everything you need to launch on the App Store

One Claude Code skill covers the whole ASO loop — from a cold Xcode project to a reviewed, localized, screenshotted release.

Keyword research

Guided research per locale. Gaps, synonyms, and character-limit-aware suggestions.

/aso research

Metadata generation

Generate title, subtitle, keywords, and descriptions that stay within App Store limits.

/aso metadata

App Store Connect sync

Push and pull metadata between your repo and ASC without leaving the terminal.

/aso push · /aso pull

Screenshot pipeline

Capture from the simulator, compose marketing frames with AI, upload to ASC.

/aso screenshots capture · compose · upload

AI icon generation

27+ presets — flat, clay, gradient, glossy, neubrutalist, 3d-mascot — powered by Gemini.

/aso icons generate --preset modern-blob

Translate to all locales

One command, every supported locale. Keywords and descriptions that actually fit.

/aso translate

Competitor analysis

AI-assisted keyword gap analysis against the apps in your category.

/aso competitor

Release notes from git

Generate App Store "What's New" copy directly from your commit history.

/aso whats-new

ASO readiness score

0–100 score with concrete recommendations across metadata, visuals, and legal.

/aso score

Apple Review Guidelines check

100+ checks across Safety, Performance, Business, Design, Legal, Technical, ASC, and Website.

/aso check

Privacy manifest

Auto-scan your code for required reason APIs and emit a matching PrivacyInfo.xcprivacy.

/aso privacy-manifest

Zero-config init

Autodetects your Xcode project, team, bundle id, version, and ASC locales in one command.

/aso init

Reference

Every command at a glance

Each subcommand is a dedicated script. Run them directly, or ask Claude Code to orchestrate them.

Command	What it does
`/aso init`	Autodetect Xcode project, connect to App Store Connect, generate config
`/aso status`	Show app info, ASC connection, data inventory
`/aso research`	Guided keyword research for each locale
`/aso metadata`	Generate metadata with character-limit validation
`/aso push` / `/aso pull`	Sync metadata with App Store Connect
`/aso export`	Export metadata as JSON, CSV, or text
`/aso screenshots capture`	Capture screenshots via iOS Simulator
`/aso screenshots compose`	Generate marketing frames with Gemini AI
`/aso screenshots upload`	Upload screenshots to App Store Connect
`/aso icons generate`	AI icon generation (multiple preset styles)
`/aso translate`	AI-translate metadata to all configured locales
`/aso competitor`	Competitor keyword analysis
`/aso whats-new`	Generate "What's New" from git history
`/aso score`	ASO readiness score with recommendations
`/aso check`	Apple Review Guidelines compliance (100+ checks)
`/aso privacy-manifest`	Auto-generate PrivacyInfo.xcprivacy

Demo

What it looks like in your terminal

Actual output. Exit codes are real. No "demo mode."

~/MyApp · /aso check

  Apple App Store Review Guidelines — MyApp
  Source: developer.apple.com · Checks: 68

  ═══ 1. SAFETY ══════════════════════════════════════════════
    ✓ [1.1]   No objectionable content
    ✓ [1.5.9] ATT implemented
    ✓ [1.5.10] PrivacyInfo.xcprivacy with API declarations

  ═══ 3. BUSINESS ════════════════════════════════════════════
    ✓ [3.1.2] Subscriptions properly implemented
    ✓ [3.1.3] Restore mechanism found

  ═══ 4. DESIGN ══════════════════════════════════════════════
    ✓ [4.0]   1024x1024 app icon found
    ✓ [4.2]   185 Swift files
    ✓ [4.5.4] Sign in with Apple implemented

  ═══ 5. LEGAL ═══════════════════════════════════════════════
    ✓ [5.1]   Privacy policy reachable

  ═══ 8. WEBSITE ═════════════════════════════════════════════
    ✓ [WEB.1] privacy, data, collect, personal, information
    ✓ [WEB.3] iTunes, payment, charged, purchase, Account
    ✓ [WEB.4] auto-renew, 24 hours, current period, automatically
    ⚠ [WEB.7] Free trial terms — only relevant if trial offered

  ═══════════════════════════════════════════════════════════
    Pass:     61
    Warn:     5
    Fail:     0
    Manual:   2

  ✓ All checks passed — ready for submission.

How it works

Runs entirely on your Mac

Nothing is stored on external services. ASC calls go through Apple's CLI. AI calls (icons / translations) go to Gemini if you opt in.

Prerequisite: Xcode

Everything else — jq, asc CLI, Python deps — is installed by /aso init. Python 3 ships with macOS.

Auth stays local

ASC uses your Xcode Apple ID (Settings → Accounts). The only secret you supply is a free Gemini API key if you want AI features.

Claude-native, terminal-friendly

Slash commands drive Claude Code; the same scripts work without Claude via bash aso/run.sh <command>.

FAQ

Frequently asked

What is ASO Toolkit, exactly?

A Claude Code skill that wraps the common App Store Optimization workflow for iOS and macOS apps: keyword research, metadata, screenshots, AI icons, Apple Review Guidelines audit, and App Store Connect sync. Each capability is a slash command like /aso check or /aso push.

How do I install it?

Clone the repo into ~/.claude/skills/aso and restart Claude Code. Or run the installer script from the repo. See the Install section above for the exact commands.

Does it work without Claude Code?

Yes. Every subcommand has a plain shell entry point at scripts/run.sh <command>, so you can use it from CI or any terminal. The Claude Code integration just gives you slash commands and natural-language orchestration on top.

What does /aso check actually check?

Over 100 guideline items across Safety, Performance, Business, Design, Legal, Technical, App Store Connect, and your Website. It scans your Swift sources recursively, reads the privacy manifest and entitlements declared in config, inspects ASC metadata via the asc CLI, and fetches your privacy / terms / support pages to verify required disclosures.

Does it send my code or data anywhere?

No. The skill runs locally. It only talks to Apple (via the asc CLI) and, if you opt in, to Gemini for AI icon / translation / screenshot generation. You bring your own keys.

Is it free?

Yes. The toolkit is MIT-licensed. You pay only for third-party services you opt into — typically an App Store Connect developer account (Apple) and optionally a Gemini API key (Google, has a free tier).

Android support?

Not today. Contributions welcome — the architecture is subcommand-based, so a Play Store variant could slot in cleanly.

Wall of apps

Real apps shipping with ASO Toolkit

See what teams ship — or add your own with a one-line pull request.

Browse the wall Add your app

Stop wrestling with App Store Connect.

Install the skill, run /aso init, and let Claude Code take it from there.

Star on GitHub Get the install command