Skip to content
Back to search

app-store-aso

SkillWorks with Claude CodeGitHub

Generate optimized Apple App Store metadata recommendations with ASO best practices. Use this skill when analyzing app listings, optimizing metadata (title, subtitle, description, keywords), performing competitive analysis, or validating App Store listing requirements. Triggers on queries about App Store optimization, metadata review, or screenshot strategy.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/timbroddin--app-store-aso-skill/badge.svg)](/listings/timbroddin--app-store-aso-skill)

HTML

<a href="/listings/timbroddin--app-store-aso-skill"><img src="/api/listings/timbroddin--app-store-aso-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 198 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: app-store-aso
  3. description: Generate optimized Apple App Store metadata recommendations with ASO best practices. Use this skill when analyzing app listings, optimizing metadata (title, subtitle, description, keywords), performing competitive analysis, or validating App Store listing requirements. Triggers on queries about App Store optimization, metadata review, or screenshot strategy.
  4. ---
  5. # Apple App Store ASO Optimization
  6. ## Overview
  7. This skill enables comprehensive Apple App Store Optimization (ASO) analysis and metadata generation. Analyze existing app listings, generate optimized metadata following Apple's guidelines and character limits, provide competitive insights, and recommend screenshot storyboard strategies.
  8. ## Core Workflow
  9. When a user requests ASO optimization or metadata review:
  10. 1. **Analyze the App Context**
  11. - Understand the app's purpose, features, and target audience
  12. - Identify unique value propositions and competitive differentiators
  13. - Note any changes or updates the user mentions
  14. 2. **Load ASO Knowledge Base**
  15. - Reference `references/aso_learnings.md` for comprehensive ASO best practices
  16. - Apply competitive analysis strategies
  17. - Use proven optimization patterns
  18. 3. **Generate Optimized Metadata**
  19. - Create optimized app name, subtitle, and promotional text
  20. - Write compelling description with keyword optimization
  21. - Generate keyword list with strategic placement
  22. - Ensure all metadata follows Apple's character limits
  23. 4. **Validate Character Counts**
  24. - Use `scripts/validate_metadata.py` to verify all metadata meets Apple's requirements
  25. - Display validation results with character counts and limit compliance
  26. - Flag any violations with specific corrections needed
  27. 5. **Provide Screenshot Strategy**
  28. - Recommend screenshot storyboard sequence
  29. - Suggest messaging hierarchy and visual focus areas
  30. - Align screenshot strategy with metadata messaging
  31. ## Apple App Store Character Limits
  32. **Critical Limits to Validate:**
  33. - **App Name**: 30 characters maximum
  34. - **Subtitle**: 30 characters maximum
  35. - **Promotional Text**: 170 characters maximum
  36. - **Description**: 4,000 characters maximum
  37. - **Keywords**: 100 characters maximum (comma-separated, no spaces)
  38. - **What's New**: 4,000 characters maximum
  39. ## Metadata Validation Process
  40. After generating recommendations, always validate using the validation script:
  41. ```bash
  42. python scripts/validate_metadata.py
  43. ```
  44. The script will:
  45. 1. Prompt for each metadata field
  46. 2. Calculate character counts
  47. 3. Check against Apple's limits
  48. 4. Display results with ✅ (pass) or ❌ (fail) indicators
  49. 5. Show exact character counts and remaining characters
  50. **Integration Pattern:**
  51. - Generate metadata recommendations
  52. - Run validation script with recommended content
  53. - Display validation results to user
  54. - Adjust any failing fields and re-validate
  55. ## Output Format
  56. Structure recommendations as:
  57. ### 📱 App Metadata Recommendations
  58. **App Name** (X/30 characters)
  59. [optimized name]
  60. **Subtitle** (X/30 characters)
  61. [optimized subtitle]
  62. **Promotional Text** (X/170 characters)
  63. [promotional text]
  64. **Keywords** (X/100 characters)
  65. [keyword,list,no,spaces]
  66. **Description** (X/4000 characters)
  67. [full description]
  68. ### 🎯 Competitive Analysis
  69. [Key insights and positioning recommendations]
  70. ### 📸 Screenshot Storyboard Strategy
  71. [Ordered list of screenshot recommendations with messaging]
  72. ### ✅ Validation Results
  73. [Output from validation script showing compliance]
  74. ## Krankie: App Store Ranking Tracker
  75. Krankie is an agent-first CLI tool for tracking App Store keyword rankings. Use it to monitor keyword performance, track ranking changes over time, and inform ASO optimization decisions with real data.
  76. ### Installation
  77. ```bash
  78. bun install -g krankie
  79. # or run directly
  80. bunx krankie
  81. ```
  82. ### Key Commands
  83. **App Management:**
  84. ```bash
  85. # Search for apps
  86. krankie app search "<query>" --platform ios
  87. # Add an app to track
  88. krankie app create <app_id> --platform ios
  89. # List tracked apps
  90. krankie app list
  91. ```
  92. **Keyword Tracking:**
  93. ```bash
  94. # Add keywords to track for an app
  95. krankie keyword add <app_id> "<keyword>" --store us
  96. # List tracked keywords
  97. krankie keyword list
  98. ```
  99. **Ranking Checks:**
  100. ```bash
  101. # Run ranking checks for all tracked keywords
  102. krankie check run
  103. # View current rankings
  104. krankie rankings
  105. # See biggest movers (gains/losses)
  106. krankie rankings movers
  107. # View ranking history for a keyword
  108. krankie rankings history <keyword_id>
  109. # Check status of last run
  110. krankie check status
  111. ```
  112. **Automation:**
  113. ```bash
  114. # Install daily cron job (default: 6 AM)
  115. krankie cron install --hour 6
  116. # Check cron status
  117. krankie cron status
  118. ```
  119. ### Agent Integration
  120. All commands support `--json` flag for structured output:
  121. ```bash
  122. krankie rankings --json
  123. krankie app list --json
  124. ```
  125. Get agent-friendly instructions:
  126. ```bash
  127. krankie instructions --format json
  128. ```
  129. ### Data Notes
  130. - Rankings track positions 1-200; null indicates outside this range
  131. - Data stored locally in `~/.krankie/krankie.db` (SQLite)
  132. - Daily re-checks are rate-limited; use `--force` to override
  133. - Logs available at `~/.krankie/check.log`
  134. ### ASO Workflow Integration
  135. 1. **Before optimization**: Use `krankie rankings` to establish baseline keyword positions
  136. 2. **Competitive analysis**: Track competitor apps and their keyword rankings
  137. 3. **After metadata changes**: Monitor `krankie rankings movers` to measure impact
  138. 4. **Trend analysis**: Use `krankie rankings history` to identify patterns
  139. ## Resources
  140. ### scripts/validate_metadata.py
  141. Python script that validates App Store metadata against Apple's character limits. Provides interactive validation with clear pass/fail indicators.
  142. ### references/aso_learnings.md
  143. Comprehensive ASO knowledge base containing optimization strategies, competitive analysis frameworks, keyword research techniques, and proven best practices. Load this file to inform all ASO recommendations.
README.md · README · 31 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Apple App Store ASO Optimization Skill
  2. > **Moved.** This skill now lives in the consolidated [TimBroddin/skills](https://github.com/TimBroddin/skills) repo so all my agent skills install from one place.
  3. ## New install
  4. ### `skills` CLI (any agent — Claude Code, Codex, Cursor, OpenCode, …)
  5. ```bash
  6. npx skills add TimBroddin/skills --skill app-store-aso
  7. ```
  8. ### Claude Code plugin (installs every skill in the repo)
  9. ```
  10. /plugin install TimBroddin/skills
  11. ```
  12. ## What it does
  13. Generate optimized Apple App Store metadata with ASO best practices:
  14. - App name, subtitle, promotional text, description, keywords, what's new — all validated against Apple's character limits
  15. - Competitive analysis and screenshot strategy (including caption optimization for the June 2025 OCR indexing update)
  16. - Pairs with [astro-mcp-server](https://github.com/TimBroddin/astro-mcp-server) for keyword research and [krankie](https://github.com/timbroddin/krankie) for rank tracking
  17. Full documentation lives in the consolidated repo: <https://github.com/TimBroddin/skills/tree/main/skills/app-store-aso>.
  18. ## License
  19. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.