/app-description-writer
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 -y skills add rshankras/claude-code-apple-skills --skill app-description-writer --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/app-description-writer
Context preview
The summary Claude sees to decide when to auto-load this skill.
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.
SKILL.md
app-description-writer.SKILL.mdname: app-description-writer
description: 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.
allowed-tools: [Read, Write, Edit, Glob, Grep, AskUserQuestion]
last_verified: 2026-07-16
review_by: 2027-06-22
App Description Writer
Generate compelling App Store descriptions that convert browsers into users.
When This Skill Activates
- User needs to write initial App Store description
- User wants to improve existing description
- User is preparing for a major update
- User asks about promotional text or What's New
Information Gathering
Before writing, ask about:
1. **App Basics**
- What does the app do? (one sentence)
- Who is it for? (target audience)
- What problem does it solve?
2. **Key Features**
- Top 3-5 features
- What makes it unique vs competitors?
- Any awards or recognition?
3. **Social Proof**
- Number of users/downloads (if impressive)
- Notable reviews or press mentions
- Any partnerships or integrations?
4. **Tone**
- Professional / Casual / Fun / Technical?
- Brand voice keywords?
Output Format
Generate all three text types:
1. Promotional Text (170 characters)
- First thing users see
- Should create curiosity or urgency
- Can be updated without app review
- Good for seasonal/sale messaging
2. Full Description (4000 characters max)
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]
3. What's New (4000 characters)
For updates:
[Version X.X highlights]
NEW
• Feature addition
IMPROVED
• Enhancement
FIXED
• Bug fix
Thank you for your feedback!
Best Practices
Do's
- Lead with the biggest benefit
- Use short paragraphs (2-3 lines max)
- Include relevant keywords naturally
- Use emojis sparingly for scannability
- End with clear call-to-action
- Mention if there's a free trial/tier
Don'ts
- Don't start with "Welcome to..."
- Don't use ALL CAPS excessively
- Don't include URLs (they're not clickable)
Examples
Promotional Text Examples
**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.
Description Opening Examples
**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.
Localization Tips
When localizing descriptions:
- Don't just translate—adapt to cultural context
- Research local competitors' descriptions
- Adjust feature emphasis by market
- Use native speakers for review
- Consider character limits in other languages (German expands ~30%)
Character Limits Reference
| Field | Limit | |-------|-------| | App Name | 30 characters | | Subtitle | 30 characters | | Promotional Text | 170 characters | | Description | 4000 characters | | What's New | 4000 characters | | Keywords | 100 characters |
Templates
Template: Utility App
[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]
Template: Creative App
[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]
Template: What's New
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]
Read more
name: app-description-writer description: 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. allowed-tools: [Read, Write, Edit, Glob, Grep, AskUserQuestion] last_verified: 2026-07-16 review_by: 2027-06-22
App Description Writer
Generate compelling App Store descriptions that convert browsers into users.
When This Skill Activates
- User needs to write initial App Store description
- User wants to improve existing description
- User is preparing for a major update
- User asks about promotional text or What's New
Information Gathering
Before writing, ask about:
1. **App Basics**
- What does the app do? (one sentence)
- Who is it for? (target audience)
- What problem does it solve?
2. **Key Features**
- Top 3-5 features
- What makes it unique vs competitors?
- Any awards or recognition?
3. **Social Proof**
- Number of users/downloads (if impressive)
- Notable reviews or press mentions
- Any partnerships or integrations?
4. **Tone**
- Professional / Casual / Fun / Technical?
- Brand voice keywords?
Output Format
Generate all three text types:
1. Promotional Text (170 characters)
- First thing users see
- Should create curiosity or urgency
- Can be updated without app review
- Good for seasonal/sale messaging
2. Full Description (4000 characters max)
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]
3. What's New (4000 characters)
For updates:
[Version X.X highlights] NEW • Feature addition IMPROVED • Enhancement FIXED • Bug fix Thank you for your feedback!
Best Practices
Do's
- Lead with the biggest benefit
- Use short paragraphs (2-3 lines max)
- Include relevant keywords naturally
- Use emojis sparingly for scannability
- End with clear call-to-action
- Mention if there's a free trial/tier
Don'ts
- Don't start with "Welcome to..."
- Don't use ALL CAPS excessively
- Don't include URLs (they're not clickable)
Examples
Promotional Text Examples
**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.
Description Opening Examples
**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.
Localization Tips
When localizing descriptions:
- Don't just translate—adapt to cultural context
- Research local competitors' descriptions
- Adjust feature emphasis by market
- Use native speakers for review
- Consider character limits in other languages (German expands ~30%)
Character Limits Reference
| Field | Limit | |-------|-------| | App Name | 30 characters | | Subtitle | 30 characters | | Promotional Text | 170 characters | | Description | 4000 characters | | What's New | 4000 characters | | Keywords | 100 characters |
Templates
Template: Utility App
[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]
Template: Creative App
[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]
Template: What's New
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]
A collection of Claude Code skills for iOS, macOS, watchOS, visionOS, and Apple platform development. These skills help you plan and build apps, maintain code quality, ensure HIG compliance, and guide you from idea to App Store.
Repo: rshankras/claude-code-apple-skills
Other skills on rshankras-apple-skills.
- /app-store
App Store optimization and marketing skills for descriptions, screenshots, keywords, review responses, and comprehensive promotional strategy. Use when user needs help with App Store presence, ASO, marketing, or customer communication.
Open skill - /ad-attribution
Privacy-preserving ad measurement with AdAttributionKit (SKAdNetwork's successor) — install and re-engagement attribution, conversion-value strategy under crowd anonymity, and end-to-end postback testing. Use when running paid acquisition beyond Apple Ads, measuring
Open skill - /apple-search-ads
Apple Search Ads campaign strategy for indie developers — paid acquisition, keyword bidding, budget planning, and ROAS optimization. Use when user asks about running ads, paid user acquisition, or Apple Search Ads campaigns.
Open skill - /iap-finalizer
Take a one-time in-app purchase from MISSING_METADATA to READY_TO_SUBMIT in App Store Connect — set its price schedule and localized display name/description (and optional review screenshot) via the ASC REST API. Use at Phase 6 (Pre-Release), after the IAP is built in-app (Phase
Open skill - /keyword-optimizer
Optimize app title, subtitle, and keywords for maximum App Store discoverability. Use when launching a new app, improving search rankings, entering new markets/languages, or safely optimizing ASO for an app with existing traffic.
Open skill - /marketing-strategy
App Store marketing strategy advisor that analyzes your app and recommends the best promotional features. Orchestrates sub-skills for implementation. Use when planning app promotion, launch strategy, user acquisition, or re-engagement campaigns.
Open skill

