App Description Writer

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 7fd70e317e5c · 18 Oct 2026Report an issue or request a re-scan

• Publisherrshankras GitHub userOwner of the repository this skill is read from
• Source folderrshankras/claude-code-apple-skills/skills/app-store/app-description-writerThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict7fd70e317e5cA new audit runs when the source changes
• Repository statusNot archivedLast push 85 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

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

---
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]
```

Excerpt, first 5,020 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/rshankras/claude-code-apple-skills
git -C claude-code-apple-skills checkout 7fd70e317e5c

Works in

1. 2026-10-18
   ✓SAFE B 89 / 100

   first audit · source 7fd70e317e5c

Questions about App Description Writer

• github.com/rshankras/claude-code-apple-skills/tree/main/skills/a — the audited source at commit 7fd70e317e5c and every finding aboveObserved · 18 Oct 2026

Spotted something wrong? Report a correction · Methodology