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.
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/app-description-writer/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How app-description-writer Compares
| Feature / Agent | app-description-writer | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
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
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
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
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
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
Pre-refactor safety checklist. Verifies test coverage exists before AI modifies existing code. Use before asking AI to refactor anything.
tdd-feature
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
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
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
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
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
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.