Agent skill

Screenshot Planner

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

Plan compelling App Store screenshot sequences that showcase your app's value.

MITAuto-check passedMobile

Install Screenshot Planner

skills CLI
$ npx skills add rshankras/claude-code-apple-skills --skill screenshot-planner -a claude-code

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

GitHub CLI
$ gh skill install rshankras/claude-code-apple-skills screenshot-planner --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/screenshot-planner .claude/skills/screenshot-planner && 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
screenshot-planner
GitHub stars
787
Token cost
~2.1k tokens
SKILL.md length
872 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

Plan compelling App Store screenshot sequences that showcase your app's value.

  • Works in 4 steps: App Type → Key Selling Points → Target Audience → …
  • Preparing App Store assets
  • SKILL.md covers When This Skill Activates, Information Gathering, Screenshot Strategy and Caption Writing, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Screenshot Planner is an agent skill from rshankras/claude-code-apple-skills. Plan compelling App Store screenshot sequences that showcase your app's value. Use when preparing App Store assets, improving screenshot conversion, or drafting screenshot captions for a launch or major update.

Its SKILL.md is about 2.1k 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

  • Preparing App Store assets
  • Improving screenshot conversion
  • Drafting screenshot captions for a launch

Example prompts

  • “/screenshot-planner”

Requirements

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

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. App Type
  2. Key Selling Points
  3. Target Audience
  4. Competitors

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

Screenshot Planner loads about 2.1k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 872 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
~2.1k

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). 872 words, ~2,138 tokens.

Download SKILL.mdSave it as .claude/skills/screenshot-planner/SKILL.md (or your agent's skills folder).
name
screenshot-planner
description
Plan compelling App Store screenshot sequences that showcase your app's value. Use when preparing App Store assets, improving screenshot conversion, or drafting screenshot captions for a launch or major update.
allowed-tools
Read, Write, Edit, Glob, Grep, AskUserQuestion
last_verified
2026-07-16
review_by
2027-06-22
os_version
iOS 27 / macOS 27

Screenshot Planner

Plan compelling App Store screenshot sequences that showcase your app's value.

When This Skill Activates

  • User is preparing App Store assets
  • User wants to improve screenshot conversion
  • User asks about screenshot strategy or captions
  • User is launching a new app or major update

Information Gathering

Before planning, ask about:

  1. App Type

    • What category? (Productivity, Games, Lifestyle, etc.)
    • Primary use case?
    • Visual style of the app?
  2. Key Selling Points

    • What makes users choose this app?
    • Most impressive features visually?
    • Any unique UI elements?
  3. Target Audience

    • Who downloads this app?
    • What problem are they trying to solve?
    • What matters most to them?
  4. Competitors

    • What do competitor screenshots show?
    • How can you differentiate?

Screenshot Strategy

The 5-Screenshot Framework

Most users only see the first 2-3 screenshots. Order matters!

PositionPurposeContent
1Hero ShotValue proposition + best visual
2Core FeaturePrimary use case in action
3Key DifferentiatorWhat makes you unique
4Secondary FeatureAnother compelling feature
5Social Proof/CTAReviews, awards, or final push
Extended (10 Screenshots)
PositionPurpose
6Additional feature
7Customization/settings
8Integration/ecosystem
9Before/after or workflow
10Final CTA with app icon

Caption Writing

Caption Formula
[Action Verb] + [Benefit] + [Optional Detail]
Examples by Category

Productivity:

  • "Capture ideas instantly"
  • "Never miss a deadline"
  • "Your tasks, beautifully organized"

Health & Fitness:

  • "Track every workout"
  • "See your progress over time"
  • "Personalized plans that work"

Photo & Video:

  • "Edit like a pro in seconds"
  • "Filters that actually look good"
  • "Share anywhere with one tap"

Finance:

  • "Know where your money goes"
  • "Budget without the stress"
  • "Insights that save you money"
Caption Rules

✅ Do:

  • Keep under 8 words
  • Start with action verbs
  • Focus on user benefits
  • Match the visual exactly
  • Use sentence case

❌ Don't:

  • Use technical jargon
  • Include version numbers
  • Mention prices
  • Use "Our app does..."
  • Write full sentences

Visual Best Practices

Device Frames
ApproachWhen to Use
With framesWhen device context matters, lifestyle apps
Without framesMaximizing screen real estate, content apps
3D anglesStanding out, premium feel
Flat/straightClean, professional, enterprise
Backgrounds
  • Solid colors: Clean, professional, fast loading
  • Gradients: Modern, dynamic, attention-grabbing
  • Lifestyle photos: Context, emotion, aspiration
  • Abstract patterns: Creative, unique, memorable
Typography
  • Use 2 fonts max (headline + body)
  • Minimum 60pt for headlines (iPhone)
  • Ensure readability on small thumbnails
  • Match your app's brand fonts if possible

Screenshot Storyboard Template

SCREENSHOT 1: HERO
━━━━━━━━━━━━━━━━━━
Caption: [Value proposition - max 6 words]
Visual: [Key screen showing main feature]
Background: [Color/gradient that pops]
Notes: [This is first impression - make it count]

SCREENSHOT 2: CORE FEATURE
━━━━━━━━━━━━━━━━━━━━━━━━━━
Caption: [What can user do?]
Visual: [App in action, primary workflow]
Background: [Consistent with #1]
Notes: [Show the "aha" moment]

SCREENSHOT 3: DIFFERENTIATOR
━━━━━━━━━━━━━━━━━━━━━━━━━━━
Caption: [What makes you unique?]
Visual: [Feature competitors don't have]
Background: [Can vary slightly]
Notes: [Answer "why this app?"]

SCREENSHOT 4: SECONDARY FEATURE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Caption: [Another key benefit]
Visual: [Compelling secondary feature]
Background: [Consistent theme]
Notes: [Add depth to value proposition]

SCREENSHOT 5: TRUST/CTA
━━━━━━━━━━━━━━━━━━━━━━
Caption: [Social proof or call to action]
Visual: [Reviews, stats, or final screen]
Background: [Strong finish]
Notes: [Close the deal]

Size Requirements

iPhone (Required)
SizeDeviceDimensions
6.7"iPhone 15 Pro Max1290 × 2796
6.5"iPhone 11 Pro Max1284 × 2778
5.5"iPhone 8 Plus1242 × 2208
iPad (If Universal)
SizeDeviceDimensions
12.9"iPad Pro2048 × 2732
macOS
DisplayDimensions
Standard1280 × 800 (min)
Retina2880 × 1800

App Preview Video

When to Include
  • Complex apps that need demonstration
  • Games (almost always)
  • Apps with unique interactions
  • When screenshots can't show the experience
Video Specs
  • 15-30 seconds optimal
  • First 3 seconds = hook
  • No audio required (most watch muted)
  • Show actual app (no external footage first 3s)
  • 1080p or higher
Video Storyboard
0:00-0:03  Hook - Most impressive moment
0:03-0:10  Core workflow demonstration
0:10-0:20  Key features montage
0:20-0:30  Final CTA with value prop
Show full SKILL.md (393 more words)Show less
Creative Assets, Product Page Header & Search Results Visuals

Introduced at WWDC26; submittable via App Store Connect's Asset Library, rendering on iOS 27 / iPadOS 27. (Per the session "Enhance your presence on the App Store".)

Two new surfaces beyond screenshots, both fed from the Asset Library (ASC's central hub for screenshots, previews, event media, and the new marketing images/videos called creative assets):

  • Product Page Header — an image or video above your screenshots; the first visual element people see. Header, icon, and screenshots should "work together" — one visual identity, video when you want to control the narrative.
  • Custom Search Results visuals — replace the default screenshot strip in search with an impactful image/video; you can show a tailored asset per search keyword, pairing it with the matching Custom Product Page and deep link.

Working rules from Apple's session:

  • ✅ Pre-approve assets in the Asset Library — approved assets can then update the header and search visuals in real time, without another review or an app update. Two flows: attach to a version submission, or submit assets standalone.
  • ✅ Use the same asset on header and search results for a seamless discovery→install experience.
  • ✅ A/B every new visual through PPO ("test different visuals and see exactly which ones your audience respond best to"); use the ASC Preview tool across iPhone/iPad, orientations, and languages before submitting.
  • ✅ Automate uploads/submissions via the App Store Connect API.
  • ❌ Don't treat these as decoration — assets must "clearly communicate your app's core value" (aspirational imagery for outdoor apps, destinations for travel, gameplay/characters for games).

Keep a motion-capable asset library (source-quality captures, layered project files) so every PPO/CPP learning can graduate into header and search assets.

Localization

Considerations
  • Captions must be localized
  • Screenshots may need localization if they show text
  • Consider using minimal in-app text in screenshots
  • Some markets prefer different visual styles
Priority Markets
  1. English (US)
  2. Chinese (Simplified)
  3. Japanese
  4. German
  5. French
  6. Spanish

Tools

Design Tools
  • Figma - Free, collaborative
  • Sketch - Mac-native, templates available
  • Photoshop - Full control
Screenshot Generators
  • Screenshots.pro - Templates with device frames
  • Previewed - 3D mockups
  • AppLaunchpad - Quick and easy
  • Studio - Mac app with templates
Capture Tools
  • Xcode Simulator - File → Screenshot
  • QuickTime - Screen recording for video
  • ScreenFloat - Organize captures

Competitive Analysis

Before finalizing, check competitors:

  1. Search your main keyword
  2. Screenshot top 5 apps
  3. Note patterns:
    • Frame style used
    • Caption placement
    • Color schemes
    • Number of screenshots
  4. Differentiate while meeting expectations

© 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/screenshot-planner of rshankras/claude-code-apple-skills.

Open the folder on GitHubat commit 9ffb831

Compare with similar skills

Screenshot Planner 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.

Screenshot Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Screenshot Planner this skillrshankras/claude-code-apple-skills787—~2.1kAutomated safety check: PassMIT
App Store AsoTimBroddin/app-store-aso-skill100—~1.5kAutomated safety check: PassMIT
App Preview Videoappeeky/aso-skills2.2k—~1.6kAutomated safety check: PassMIT
Shotshashgraph-online/awesome-codex-plugins1.3k—~2.4kAutomated safety check: PassMIT
Aso Appstore Screenshotsadamlyttleapps/claude-skill-aso-appstore-screenshots1.8k1 repos~9.6kAutomated safety check: PassMIT
Asc Localize MetadataCamilleScholtz/swmpc2395 repos~2.8kAutomated safety check: PassEUPL-1.2

Similar skills

  • 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
  • App Preview Video

    appeeky/aso-skills

    When the user wants to plan, script, produce, or optimize App Store Preview videos or Google Play promo videos — the autoplay videos that show in App Store/Play Store search and product pages.

    2.2k GitHub stars~1.6k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Shots

    hashgraph-online/awesome-codex-plugins

    Generate, revise, translate, and manage App Store marketing screenshots and app icon candidates through the hosted Shots MCP tools.

    1.3k GitHub stars~2.4k tokensUpdated today
    MobileAuto-check passed
  • 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 Localize Metadata

    CamilleScholtz/swmpc

    Automatically translate and sync App Store metadata (description, keywords, what's new, subtitle) to multiple languages using LLM translation and asc CLI.

    239 GitHub starsUsed in 5 repos~2.8k 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

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.

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

    787 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • App Description Writer

    rshankras/claude-code-apple-skills

    Generate compelling App Store descriptions that convert browsers into users.

    787 GitHub stars~1.3k 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).

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

    787 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 &…

    787 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Screenshot Planner

What does Screenshot Planner do?

Plan compelling App Store screenshot sequences that showcase your app's value. Screenshot Planner is an agent skill from rshankras/claude-code-apple-skills. Plan compelling App Store screenshot sequences that showcase your app's value.

When should I use Screenshot Planner?

Screenshot Planner fits situations like: preparing App Store assets; improving screenshot conversion; drafting screenshot captions for a launch.

How do I install Screenshot Planner in Claude Code?

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

How do I install Screenshot Planner in Codex?

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

Can I use Screenshot Planner 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 screenshot-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/screenshot-planner, .gemini/skills/screenshot-planner, .github/skills/screenshot-planner and .opencode/skills/screenshot-planner in your project.

What does Screenshot Planner need to run?

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

Does Screenshot Planner 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 Screenshot Planner 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 Screenshot Planner use?

Screenshot Planner 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 Screenshot Planner use?

About 2.1k tokens (SKILL.md is roughly 8.6k 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 Screenshot Planner?

Skills that share tags, products or a category with Screenshot Planner: App Store Aso (TimBroddin/app-store-aso-skill, 100 stars), App Preview Video (appeeky/aso-skills, 2.2k stars), Shots (hashgraph-online/awesome-codex-plugins, 1.3k stars) and Aso Appstore Screenshots (adamlyttleapps/claude-skill-aso-appstore-screenshots, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Screenshot Planner?

rshankras (a GitHub user) maintains it in rshankras/claude-code-apple-skills, which has 787 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.