# App Description Writer

Generate compelling App Store descriptions that convert browsers into users.

- Repository: https://github.com/rshankras/claude-code-apple-skills (846 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-07-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -g -a claude-code -y`
Codex: `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -g -a codex -y`
Cursor: `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -g -a cursor -y`
Gemini CLI: `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rshankras/claude-code-apple-skills`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/rshankras/claude-code-apple-skills/blob/HEAD/skills/app-store/app-description-writer/SKILL.md