$npx -y skills add rshankras/claude-code-apple-skills --skill app-description-writerGenerate 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.
| 1 | # App Description Writer |
| 2 | |
| 3 | Generate compelling App Store descriptions that convert browsers into users. |
| 4 | |
| 5 | ## When This Skill Activates |
| 6 | |
| 7 | - User needs to write initial App Store description |
| 8 | - User wants to improve existing description |
| 9 | - User is preparing for a major update |
| 10 | - User asks about promotional text or What's New |
| 11 | |
| 12 | ## Information Gathering |
| 13 | |
| 14 | Before writing, ask about: |
| 15 | |
| 16 | 1. **App Basics** |
| 17 | - What does the app do? (one sentence) |
| 18 | - Who is it for? (target audience) |
| 19 | - What problem does it solve? |
| 20 | |
| 21 | 2. **Key Features** |
| 22 | - Top 3-5 features |
| 23 | - What makes it unique vs competitors? |
| 24 | - Any awards or recognition? |
| 25 | |
| 26 | 3. **Social Proof** |
| 27 | - Number of users/downloads (if impressive) |
| 28 | - Notable reviews or press mentions |
| 29 | - Any partnerships or integrations? |
| 30 | |
| 31 | 4. **Tone** |
| 32 | - Professional / Casual / Fun / Technical? |
| 33 | - Brand voice keywords? |
| 34 | |
| 35 | ## Output Format |
| 36 | |
| 37 | Generate all three text types: |
| 38 | |
| 39 | ### 1. Promotional Text (170 characters) |
| 40 | - First thing users see |
| 41 | - Should create curiosity or urgency |
| 42 | - Can be updated without app review |
| 43 | - Good for seasonal/sale messaging |
| 44 | |
| 45 | ### 2. Full Description (4000 characters max) |
| 46 | Structure: |
| 47 | ``` |
| 48 | [Opening Hook - 1-2 sentences, problem/benefit focused] |
| 49 | |
| 50 | [Key Features with emoji bullets] |
| 51 | • Feature 1 - benefit |
| 52 | • Feature 2 - benefit |
| 53 | • Feature 3 - benefit |
| 54 | |
| 55 | [Social Proof paragraph - optional] |
| 56 | |
| 57 | [How it works - brief explanation] |
| 58 | |
| 59 | [Call to action] |
| 60 | |
| 61 | [Support/contact info] |
| 62 | ``` |
| 63 | |
| 64 | ### 3. What's New (4000 characters) |
| 65 | For updates: |
| 66 | ``` |
| 67 | [Version X.X highlights] |
| 68 | |
| 69 | NEW |
| 70 | • Feature addition |
| 71 | |
| 72 | IMPROVED |
| 73 | • Enhancement |
| 74 | |
| 75 | FIXED |
| 76 | • Bug fix |
| 77 | |
| 78 | Thank you for your feedback! |
| 79 | ``` |
| 80 | |
| 81 | ## Best Practices |
| 82 | |
| 83 | ### Do's |
| 84 | - Lead with the biggest benefit |
| 85 | - Use short paragraphs (2-3 lines max) |
| 86 | - Include relevant keywords naturally |
| 87 | - Use emojis sparingly for scannability |
| 88 | - End with clear call-to-action |
| 89 | - Mention if there's a free trial/tier |
| 90 | |
| 91 | ### Don'ts |
| 92 | - Don't start with "Welcome to..." |
| 93 | - Don't use ALL CAPS excessively |
| 94 | - Don't include URLs (they're not clickable) |
| 95 | |
| 96 | ## Examples |
| 97 | |
| 98 | ### Promotional Text Examples |
| 99 | |
| 100 | **Productivity App:** |
| 101 | ``` |
| 102 | Transform chaos into clarity. The task manager that adapts to how YOU work. |
| 103 | ``` |
| 104 | |
| 105 | **Weather App:** |
| 106 | ``` |
| 107 | Know before you go. Hyperlocal forecasts down to your street corner. ⛅️ |
| 108 | ``` |
| 109 | |
| 110 | **Finance App:** |
| 111 | ``` |
| 112 | Your money, finally making sense. Budgeting that doesn't feel like homework. |
| 113 | ``` |
| 114 | |
| 115 | ### Description Opening Examples |
| 116 | |
| 117 | **Problem-First:** |
| 118 | ``` |
| 119 | Tired of losing track of important tasks? [App] turns your scattered thoughts |
| 120 | into organized action plans in seconds. |
| 121 | ``` |
| 122 | |
| 123 | **Benefit-First:** |
| 124 | ``` |
| 125 | Capture ideas the moment they strike. [App] is the fastest way to go from |
| 126 | thought to organized note, anywhere. |
| 127 | ``` |
| 128 | |
| 129 | **Curiosity-First:** |
| 130 | ``` |
| 131 | What if your to-do list actually helped you get things done? Introducing |
| 132 | a smarter way to manage your day. |
| 133 | ``` |
| 134 | |
| 135 | ## Localization Tips |
| 136 | |
| 137 | When localizing descriptions: |
| 138 | - Don't just translate—adapt to cultural context |
| 139 | - Research local competitors' descriptions |
| 140 | - Adjust feature emphasis by market |
| 141 | - Use native speakers for review |
| 142 | - Consider character limits in other languages (German expands ~30%) |
| 143 | |
| 144 | ## Character Limits Reference |
| 145 | |
| 146 | | Field | Limit | |
| 147 | |-------|-------| |
| 148 | | App Name | 30 characters | |
| 149 | | Subtitle | 30 characters | |
| 150 | | Promotional Text | 170 characters | |
| 151 | | Description | 4000 characters | |
| 152 | | What's New | 4000 characters | |
| 153 | | Keywords | 100 characters | |
| 154 | |
| 155 | ## Templates |
| 156 | |
| 157 | ### Template: Utility App |
| 158 | ``` |
| 159 | [One-line value proposition] |
| 160 | |
| 161 | Stop [pain point]. Start [desired outcome]. |
| 162 | |
| 163 | ✨ KEY FEATURES |
| 164 | |
| 165 | • [Feature 1] — [Benefit in user terms] |
| 166 | • [Feature 2] — [Benefit in user terms] |
| 167 | • [Feature 3] — [Benefit in user terms] |
| 168 | • [Feature 4] — [Benefit in user terms] |
| 169 | |
| 170 | 💡 HOW IT WORKS |
| 171 | |
| 172 | [2-3 sentences explaining the core flow] |
| 173 | |
| 174 | 🎯 PERFECT FOR |
| 175 | |
| 176 | • [User type 1] |
| 177 | • [User type 2] |
| 178 | • [User type 3] |
| 179 | |
| 180 | [Social proof if available] |
| 181 | |
| 182 | Download now and [call to action with benefit]. |
| 183 | |
| 184 | Questions? We're here to help: [support email] |
| 185 | ``` |
| 186 | |
| 187 | ### Template: Creative App |
| 188 | ``` |
| 189 | [Evocative opening that sparks imagination] |
| 190 | |
| 191 | [App Name] puts [creative power] in your pocket. |
| 192 | |
| 193 | 🎨 CREATE |
| 194 | |
| 195 | • [Creative feature 1] |
| 196 | • [Creative feature 2] |
| 197 | • [Creative feature 3] |
| 198 | |
| 199 | 📤 SHARE |
| 200 | |
| 201 | • [Sharing/export feature] |
| 202 | • [Community feature if applicable] |
| 203 | |
| 204 | 🔓 UNLOCK YOUR CREATIVITY |
| 205 | |
| 206 | [Inspirational paragraph about what users can achieve] |
| 207 | |
| 208 | Join [X] creators already using [App Name]. |
| 209 | |
| 210 | [Call to action] |
| 211 | ``` |
| 212 | |
| 213 | ### Template: What's New |
| 214 | ``` |
| 215 | Thanks for using [App Name]! Here's what's new in version X.X: |
| 216 | |
| 217 | 🆕 NEW |
| 218 | • [Major new feature with brief explanation] |
| 219 | |
| 220 | ⚡️ IMPROVED |
| 221 | • [Performance improvement] |
| 222 | • [UX enhancement] |
| 223 | |
| 224 | 🔧 FIXED |
| 225 | • [Bug fix users complained about] |
| 226 | |
| 227 | Love [App Name]? Leave us a review — it helps more than you know! 💙 |
| 228 | |
| 229 | Feedback? |