home / skills / phrazzld / claude-config / app-screenshots

app-screenshots skill

safe

This skill helps you generate App Store and Play Store screenshots with device frames using fastlane in CI, localizing assets and organizing outputs.

npx playbooks add skill phrazzld/claude-config --skill app-screenshots

Review the files below or copy the command above to add this skill to your agents.

Files (5)

SKILL.md

1.1 KB

---
name: app-screenshots
description: |
  Generate App Store and Play Store screenshots with device frames.
  Use when: preparing for app store submission, updating marketing assets,
  localizing screenshots, or automating screenshot generation in CI.
  Uses fastlane (free) not SaaS. Keywords: app store, play store, screenshot,
  device frame, fastlane, snapshot, frameit, localization.
argument-hint: "[app path] [platforms: ios, android] [locales: en, es]"
effort: high
---

## What This Does
- Configure `Snapfile` for app routes, devices, locales.
- Run `fastlane snapshot` across simulators/emulators.
- Apply device frames via `fastlane frameit`.
- Organize output by platform/locale/device.

## Why fastlane (not Screenshots Pro)
- Free, CLI-first, CI/CD native, handles all device sizes automatically.

## Prerequisites
- `gem install fastlane`
- Xcode (iOS) or Android SDK (Android)

## Usage
- `/app-screenshots apps/mobile for ios in english and spanish`
- `/app-screenshots . for iphone 15 pro only`

## References
- `references/fastlane-config.md`
- `references/device-specs.md`

Overview

This skill generates App Store and Play Store screenshots with realistic device frames using fastlane. It automates snapshot capture across simulators and emulators, applies device frames, and organizes outputs by platform, locale, and device. The workflow is CLI-first and CI-friendly, requiring only open-source tools and local SDKs.

How this skill works

You provide target app paths, platforms, devices, and locales. The skill configures a Snapfile, runs fastlane snapshot to capture screens on configured simulators/emulators, then runs fastlane frameit to apply device frames and output polished assets. Resulting screenshots are organized into platform/locale/device folders ready for store submission or localization pipelines.

When to use it

Preparing screenshots for App Store or Google Play submissions
Updating marketing assets after UI changes
Localizing screenshots for multiple languages and regions
Automating screenshot generation in CI/CD pipelines
Creating device-framed promo images for store listings

Best practices

Install fastlane via gem and ensure Xcode or Android SDK is configured on the build agent
Set up a Snapfile with routes, devices, and locales before running snapshot
Run snapshot on clean simulator/emulator instances to avoid flakiness
Keep localization strings and test routes version-controlled for repeatability
Validate final images against store size and metadata requirements before upload

Example use cases

/app-screenshots apps/mobile for ios in english and spanish — capture iOS screenshots localized to two languages
/app-screenshots . for iphone 15 pro only — generate screenshots for a single device during local QA
CI job that generates screenshots for multiple device families and pushes assets to a release branch
Bulk regenerate screenshots after a UI redesign and reapply device frames automatically

FAQ

Do I need to use a paid service?

No. This workflow uses fastlane (free) and local SDKs, avoiding paid screenshot SaaS.

What are the prerequisites?

Install fastlane (gem install fastlane) and have Xcode for iOS or the Android SDK for Android available on the machine.