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.

149 stars

Best use case

app-description-writer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using app-description-writer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/app-description-writer/SKILL.md --create-dirs "https://raw.githubusercontent.com/rshankras/claude-code-apple-skills/main/skills/app-store/app-description-writer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/app-description-writer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How app-description-writer Compares

Feature / Agentapp-description-writerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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 mention prices (they change)
- Don't claim "#1" or "best" without proof
- Don't mention competitors by name
- 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]
```

Related Skills

review-response-writer

149
from rshankras/claude-code-apple-skills

Write professional, empathetic responses to App Store reviews that build trust and turn critics into fans. Use when responding to negative reviews, drafting templates for common review types, or improving review management strategy.

watchOS

149
from rshankras/claude-code-apple-skills

watchOS development guidance including SwiftUI for Watch, Watch Connectivity, complications, and watch-specific UI patterns. Use for watchOS code review, best practices, or Watch app development.

visionos-widgets

149
from rshankras/claude-code-apple-skills

visionOS widget patterns including mounting styles, glass/paper textures, proximity-aware layouts, and spatial widget families. Use when creating or adapting widgets for visionOS.

test-data-factory

149
from rshankras/claude-code-apple-skills

Generate test fixture factories for your models. Builder pattern and static factories for zero-boilerplate test data. Use when tests need sample data setup.

test-contract

149
from rshankras/claude-code-apple-skills

Generate protocol/interface test suites that any implementation must pass. Define the contract once, test every implementation. Use when designing protocols or swapping implementations.

tdd-refactor-guard

149
from rshankras/claude-code-apple-skills

Pre-refactor safety checklist. Verifies test coverage exists before AI modifies existing code. Use before asking AI to refactor anything.

tdd-feature

149
from rshankras/claude-code-apple-skills

Red-green-refactor scaffold for building new features with TDD. Write failing tests first, then implement to pass. Use when building new features test-first.

tdd-bug-fix

149
from rshankras/claude-code-apple-skills

Fix bugs using red-green-refactor — reproduce the bug as a failing test first, then fix it. Use when fixing bugs to ensure they never regress.

snapshot-test-setup

149
from rshankras/claude-code-apple-skills

Set up SwiftUI visual regression testing with swift-snapshot-testing. Generates snapshot test boilerplate and CI configuration. Use for UI regression prevention.

integration-test-scaffold

149
from rshankras/claude-code-apple-skills

Generate cross-module test harness with mock servers, in-memory stores, and test configuration. Use when testing networking + persistence + business logic together.

characterization-test-generator

149
from rshankras/claude-code-apple-skills

Generates tests that capture current behavior of existing code before refactoring. Use when you need a safety net before AI-assisted refactoring or modifying legacy code.

testing

149
from rshankras/claude-code-apple-skills

TDD and testing skills for iOS/macOS apps. Covers characterization tests, TDD workflows, test contracts, snapshot tests, and test infrastructure. Use for test-driven development, adding tests to existing code, or building test infrastructure.