Agent skill

App Description Writer

by rshankras in rshankras/claude-code-apple-skills

Generate compelling App Store descriptions that convert browsers into users.

MITAuto-check passedMobile

Install App Description Writer

skills CLI
$ npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rshankras/claude-code-apple-skills app-description-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/app-store/app-description-writer .claude/skills/app-description-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
app-description-writer
GitHub stars
785
Token cost
~1.3k tokens
SKILL.md length
296 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

Generate compelling App Store descriptions that convert browsers into users.

  • Works in 3 steps: Promotional Text (170 characters) → Full Description (4000 characters max) → What's New (4000 characters)
  • Writing initial descriptions
  • SKILL.md covers When This Skill Activates, Information Gathering, Output Format and Best Practices, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

App Description Writer is an agent skill from rshankras/claude-code-apple-skills. 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.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering App store release. The repository describes itself as: Claude Code skills for Apple platform development (iOS, macOS, iPadOS) — product validation, code generation, App Store optimization, and more. The licence is MIT.

When your agent uses it

  • Writing initial descriptions
  • Improving existing copy
  • Drafting promotional text and Whats New for a major update

Example prompts

  • “/app-description-writer”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, AskUserQuestion

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Promotional Text (170 characters)
  2. Full Description (4000 characters max)
  3. What's New (4000 characters)

What it can do on your machine

Read from SKILL.md and the folder at commit 9ffb831. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

App Description Writer loads about 1.3k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 296 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rshankras/claude-code-apple-skills at commit 9ffb831, republished under its MIT licence (© rshankras). 296 words, ~1,256 tokens.

Download SKILL.mdSave it as .claude/skills/app-description-writer/SKILL.md (or your agent's skills folder).
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

FieldLimit
App Name30 characters
Subtitle30 characters
Promotional Text170 characters
Description4000 characters
What's New4000 characters
Keywords100 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]

© rshankras, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/app-store/app-description-writer of rshankras/claude-code-apple-skills.

Open the folder on GitHubat commit 9ffb831

Compare with similar skills

App Description Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

App Description Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
App Description Writer this skillrshankras/claude-code-apple-skills785—~1.3kAutomated safety check: PassMIT
Aso Appstore Screenshotsadamlyttleapps/claude-skill-aso-appstore-screenshots1.8k1 repos~9.6kAutomated safety check: PassMIT
Asc Ppp Pricingrorkai/app-store-connect-cli-skills1.1k3 repos~4.2kAutomated safety check: PassMIT
Maintain Docusaurus Manualmatthiasn/lotti1.2k—~930Automated safety check: PassGPL-3.0
Workbuddy Skin Studiocdredfox/workbuddy-skin-studio198—~1.5kAutomated safety check: PassMIT
App Store AsoTimBroddin/app-store-aso-skill100—~1.5kAutomated safety check: PassMIT

Similar skills

  • Aso Appstore Screenshots

    adamlyttleapps/claude-skill-aso-appstore-screenshots

    Generate high-converting App Store screenshots by analyzing your app's codebase, discovering core benefits, and creating ASO-optimized screenshot images using Nano Banana Pro.

    1.8k GitHub starsUsed in 1 repo~9.6k tokens
    MobileAuto-check passed
  • Asc Ppp Pricing

    rorkai/app-store-connect-cli-skills

    Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands.

    1.1k GitHub starsUsed in 3 repos~4.2k tokens
    MobileAuto-check passed
  • Maintain a Docusaurus product manual whose prose, navigation, localized page trees, screenshots, coverage metadata, and release build must stay aligned with the application.

    1.2k GitHub stars~930 tokensUpdated today
    MobileAuto-check passed
  • Workbuddy Skin Studio

    cdredfox/workbuddy-skin-studio

    Apply a reversible theme/skin to the WorkBuddy desktop app (Tencent AI office agent) via local Chromium DevTools Protocol (CDP) injection.

    198 GitHub stars~1.5k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • App Store Aso

    TimBroddin/app-store-aso-skill

    Generate optimized Apple App Store metadata recommendations with ASO best practices.

    100 GitHub stars~1.5k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    482 GitHub stars~11k tokensUpdated 4 days ago
    MobileAuto-check passed

More from rshankras/claude-code-apple-skills

All 41 skills in this repo
  • Accessibility Generator

    rshankras/claude-code-apple-skills

    Generate accessibility infrastructure for VoiceOver, Dynamic Type, and accessibility features.

    785 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check: notes
  • Animation Patterns

    rshankras/claude-code-apple-skills

    SwiftUI animation patterns including springs, transitions, PhaseAnimator, KeyframeAnimator, SF Symbol effects, scroll-driven effects, mesh gradients, text renderers, and shader effects.

    785 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • App Icon Generator

    rshankras/claude-code-apple-skills

    Generates an app icon for macOS or iOS — a fast CoreGraphics placeholder and/or flat layered source art to finish in Icon Composer (the Liquid Glass / iOS 26+ standard).

    785 GitHub stars~5.1k tokensUpdated 2 mo ago
    Auto-check: notes
  • App Namer

    rshankras/claude-code-apple-skills

    Turn an app idea into validated, App-Store-ready name candidates.

    785 GitHub stars~3.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Bundles And Licensing

    rshankras/claude-code-apple-skills

    Revenue beyond the single-app price tag — own-app bundles, Family Sharing as a conversion lever, cross-developer bundles & suites, and institutional licensing via Group Purchases / Apple School &…

    785 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • CI CD Setup

    rshankras/claude-code-apple-skills

    Generate CI/CD configuration for automated builds, tests, and distribution of iOS/macOS apps.

    785 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check: notes

Categories

Questions about App Description Writer

What does App Description Writer do?

Generate compelling App Store descriptions that convert browsers into users. App Description Writer is an agent skill from rshankras/claude-code-apple-skills. Generate compelling App Store descriptions that convert browsers into users.

When should I use App Description Writer?

App Description Writer fits situations like: writing initial descriptions; improving existing copy; drafting promotional text and Whats New for a major update.

How do I install App Description Writer in Claude Code?

Run `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -a claude-code`. Or copy the skill folder (skills/app-store/app-description-writer in rshankras/claude-code-apple-skills) into .claude/skills/app-description-writer in your project. Claude Code loads it when a task matches its description.

How do I install App Description Writer in Codex?

Run `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -a codex`. Or copy the skill folder (skills/app-store/app-description-writer in rshankras/claude-code-apple-skills) into .agents/skills/app-description-writer in your project. Codex loads it when a task matches its description.

Can I use App Description Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rshankras/claude-code-apple-skills --skill app-description-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/app-description-writer, .gemini/skills/app-description-writer, .github/skills/app-description-writer and .opencode/skills/app-description-writer in your project.

What does App Description Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: App Description Writer is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, AskUserQuestion.

Does App Description Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is App Description Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does App Description Writer use?

App Description Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does App Description Writer use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to App Description Writer?

Skills that share tags, products or a category with App Description Writer: Aso Appstore Screenshots (adamlyttleapps/claude-skill-aso-appstore-screenshots, 1.8k stars), Asc Ppp Pricing (rorkai/app-store-connect-cli-skills, 1.1k stars), Maintain Docusaurus Manual (matthiasn/lotti, 1.2k stars) and Workbuddy Skin Studio (cdredfox/workbuddy-skin-studio, 198 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains App Description Writer?

rshankras (a GitHub user) maintains it in rshankras/claude-code-apple-skills, which has 785 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on July 24, 2026.

Source: rshankras/claude-code-apple-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.