skills/app-store/app-description-writer/SKILL.md
Generate compelling App Store descriptions that convert browsers into users. Use when writing initial descriptions, improving existing copy, or drafting promotional text and What's New for a major update.
npx skillsauth add rshankras/claude-code-apple-skills app-description-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Generate compelling App Store descriptions that convert browsers into users.
Before writing, ask about:
App Basics
Key Features
Social Proof
Tone
Generate all three text types:
Structure:
[Opening Hook - 1-2 sentences, problem/benefit focused]
[Key Features with emoji bullets]
• Feature 1 - benefit
• Feature 2 - benefit
• Feature 3 - benefit
[Social Proof paragraph - optional]
[How it works - brief explanation]
[Call to action]
[Support/contact info]
For updates:
[Version X.X highlights]
NEW
• Feature addition
IMPROVED
• Enhancement
FIXED
• Bug fix
Thank you for your feedback!
Productivity App:
Transform chaos into clarity. The task manager that adapts to how YOU work.
Weather App:
Know before you go. Hyperlocal forecasts down to your street corner. ⛅️
Finance App:
Your money, finally making sense. Budgeting that doesn't feel like homework.
Problem-First:
Tired of losing track of important tasks? [App] turns your scattered thoughts
into organized action plans in seconds.
Benefit-First:
Capture ideas the moment they strike. [App] is the fastest way to go from
thought to organized note, anywhere.
Curiosity-First:
What if your to-do list actually helped you get things done? Introducing
a smarter way to manage your day.
When localizing descriptions:
| Field | Limit | |-------|-------| | App Name | 30 characters | | Subtitle | 30 characters | | Promotional Text | 170 characters | | Description | 4000 characters | | What's New | 4000 characters | | Keywords | 100 characters |
[One-line value proposition]
Stop [pain point]. Start [desired outcome].
✨ KEY FEATURES
• [Feature 1] — [Benefit in user terms]
• [Feature 2] — [Benefit in user terms]
• [Feature 3] — [Benefit in user terms]
• [Feature 4] — [Benefit in user terms]
💡 HOW IT WORKS
[2-3 sentences explaining the core flow]
🎯 PERFECT FOR
• [User type 1]
• [User type 2]
• [User type 3]
[Social proof if available]
Download now and [call to action with benefit].
Questions? We're here to help: [support email]
[Evocative opening that sparks imagination]
[App Name] puts [creative power] in your pocket.
🎨 CREATE
• [Creative feature 1]
• [Creative feature 2]
• [Creative feature 3]
📤 SHARE
• [Sharing/export feature]
• [Community feature if applicable]
🔓 UNLOCK YOUR CREATIVITY
[Inspirational paragraph about what users can achieve]
Join [X] creators already using [App Name].
[Call to action]
Thanks for using [App Name]! Here's what's new in version X.X:
🆕 NEW
• [Major new feature with brief explanation]
⚡️ IMPROVED
• [Performance improvement]
• [UX enhancement]
🔧 FIXED
• [Bug fix users complained about]
Love [App Name]? Leave us a review — it helps more than you know! 💙
Feedback? [support email]
development
Build, install, and launch an iOS app on a physical iPhone or iPad entirely from the command line (no Xcode GUI), using xcodebuild + devicectl. Use when the user wants to run, test, or screenshot their app on a real device without opening Xcode.
development
Comprehensive iOS development guidance including Swift best practices, SwiftUI patterns, UI/UX review against HIG, and app planning. Use for iOS code review, best practices, accessibility audits, or planning new iOS apps.
development
Build, install, launch, and screenshot an iOS app in the Simulator to verify a change visually. Use when the user wants to run the app, see a change live, screenshot the running app, or confirm a UI fix actually works (not just that it compiles).
development
Audits skills in this repo for consistency, API drift, and structural gaps. Produces a prioritized report grouped by severity (Critical/High/Medium/Low). Use when asked to "audit skills", "check the skill repo for drift", or when planning bulk skill cleanup. Read-only — does not apply fixes.