store-screenshots
πΌοΈ AI agent skill for Claude Code & Codex β turns raw app screenshots into store-ready App Store & Google Play marketing images: device frames (iPhoneΒ·iPadΒ·GalaxyΒ·FoldΒ·Flip), app-matched backgrounds, marketing copy, exact store sizes. μ±μ€ν μ΄Β·νλ μ΄μ€ν μ΄ λ§μΌν μ€ν¬λ¦°μ· μλ μμ±
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/leehueeng--store-screenshots)HTML
<a href="/listings/leehueeng--store-screenshots"><img src="/api/listings/leehueeng--store-screenshots/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/LeeHueeng/store-screenshots.git # Claude Code cp -r store-screenshots/store-screenshots ~/.claude/skills/ # Codex mkdir -p ~/.agents/skills cp -r store-screenshots/store-screenshots ~/.agents/skills/
| Agent | All projects | One project only | |-------|--------------|------------------| | Claude Code | `~/.claude/skills/` | `<project>/.claude/skills/` | | Codex | `~/.agents/skills/` | `<repo root>/.agents/skills/` |
> On older Codex versions the skills path may be `~/.codex/skills/`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 151 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="promo/skill-promo-v2-en.png" alt="store-screenshots β AI agent skill that turns raw app screenshots into store-ready App Store and Google Play marketing images with device frames, branded backgrounds, and marketing copy" width="100%" />
- # store-screenshots
- **Raw app screenshots in β store-ready marketing images out.**<br>
- An AI agent skill for **Claude Code** & **OpenAI Codex** that adds device frames, branded backgrounds, and benefit-driven copy β at exact App Store & Google Play sizes.
- [](LICENSE)
- [](https://claude.com/claude-code)
- [](https://openai.com/codex)
- [](#-store-specs-it-targets)
- **English** Β· [νκ΅μ΄](README.ko.md)
- </div>
- ---
- Making App Store and Google Play screenshots by hand β opening Figma, hunting for device mockups, double-checking pixel sizes β gets old fast. This skill turns all of that into one request to your coding agent: point it at your raw screenshots (or let it drive your app and capture them itself), answer a few multiple-choice questions, approve the copy, and get a full set of store-ready PNGs.
- ## β¨ What it does
- - π± **Device frames** β iPhone, iPad, Galaxy, **Fold**, **Flip**, drawn in pure CSS (no mockup downloads, no license worries)
- - π¨ **Branded backgrounds** β extracts your app's real design colors (`colors.xml`, `.xcassets`, app icon); Modern/Minimal, Pop, and Dark presets included
- - βοΈ **Marketing copy** β reads each screen and proposes benefit-driven headlines and subcopy, and only proceeds **after you approve**
- - π **Exact store sizes** β App Store 1320Γ2868 / 1284Γ2778, iPad 2064Γ2752, Google Play 1080Γ1920, and more β every PNG is pixel-verified
- - π€ **Hands-free capture** β no screenshots yet? The agent drives your app itself (adb on Android; deep links, idb, or Maestro on the iOS Simulator) with the status bar unified to 9:41 / 100% battery
- ## πΌοΈ Example output
- <div align="center">
- <img src="promo/sample-output.png" alt="Example result β an App Store marketing screenshot generated by the skill, with an app-matched background and Korean marketing copy" width="300" />
- *App Store iPhone 6.5β³ size (1242Γ2688), generated with the "match my app's design" style*
- </div>
- ## π Install
- ```bash
- git clone https://github.com/LeeHueeng/store-screenshots.git
- # Claude Code
- cp -r store-screenshots/store-screenshots ~/.claude/skills/
- # Codex
- mkdir -p ~/.agents/skills
- cp -r store-screenshots/store-screenshots ~/.agents/skills/
- ```
- | Agent | All projects | One project only |
- |-------|--------------|------------------|
- | Claude Code | `~/.claude/skills/` | `<project>/.claude/skills/` |
- | Codex | `~/.agents/skills/` | `<repo root>/.agents/skills/` |
- > On older Codex versions the skills path may be `~/.codex/skills/`.
- ## π¬ Usage
- In Claude Code:
- ```
- /store-screenshots ./screenshots
- ```
- In Codex:
- ```
- $store-screenshots ./screenshots
- ```
- (or pick it from `/skills`)
- Or just ask in plain language β *"make my App Store screenshots"*.
- ### How a run goes
- 1. **Collect originals** β scans your folder for screenshots; if there are none, the agent **operates the app itself** and captures them.
- - Android: `adb` tap/screencap Β· iOS Simulator: deep links (`simctl openurl`) first, then idb, Maestro, or AppleScript
- - Status bar unified to 9:41 / 100% battery across every capture
- - You never have to touch the device β you only pick options and approve copy
- - On a re-run it first asks: reuse existing screenshots, or start fresh?
- 2. **Questions (all multiple-choice)** β platform (App Store / Google Play) β devices (iPhone, iPad, Galaxy, Fold, Flip) β style (match my app / modern-minimal / pop / dark) β how many slides β what to highlight
- 3. **Draft approval** β a copy table plus one fully rendered first slide at real store size; full rendering starts only after your OK
- 4. **Render** β frame, background, and copy composed in HTML/CSS, captured with headless Chrome
- 5. **Verify** β every PNG's pixel size is checked against the store spec table
- ## π¦ Output
- ```
- store-screenshots/
- βββ appstore-iphone-69/01.png β¦ # 1320Γ2868
- βββ appstore-iphone-65/ # 1242Γ2688 β iPhone always gets both sets
- βββ appstore-ipad-13/ # 2064Γ2752
- βββ play-phone/ # 1080Γ1920
- βββ play-foldable/
- ```
- ## π Store specs it targets
- | Target | Size (px, portrait) | Slides | Notes |
- |--------|--------------------:|--------|-------|
- | App Store iPhone 6.9β³ | 1320Γ2868 | up to 10 | 1290Γ2796 also accepted |
- | App Store iPhone 6.5β³ | 1284Γ2778 | up to 10 | 1242Γ2688 also accepted |
- | App Store iPad 13β³ | 2064Γ2752 | up to 10 | required if the app supports iPad |
- | Google Play phone | 1080Γ1920 | 2β8 | 9:16 Β· featuring needs β₯1080px and 4+ slides |
- | Google Play tablet | 1080Γ1920 / 1920Γ1080 | up to 8 | when tablet is supported |
- | Google Play foldable | in the phone slot | β | Fold's unfolded screen also works for the tablet slot |
- ## β Requirements
- | You need | Notes |
- |----------|-------|
- | [Claude Code](https://claude.com/claude-code) or [Codex](https://openai.com/codex) | either one β the skill runs in both |
- | Chrome or Chromium | for headless rendering β falls back to Playwright automatically |
- | `sips` (built into macOS) or ImageMagick | for pixel-size verification |
- ## π§© Why this instead of a web tool?
- - **It reads your actual app.** Colors come from your real design system, and the copy is written from what's actually on each screen β not from a template.
- - **It can capture for you.** Most screenshot tools start from images you already have; this one can launch and navigate your app to get them.
- - **Nothing leaves your machine.** No uploads, no accounts, no watermarks β plain HTML/CSS rendered locally.
- - **Korean-first, English-ready.** Copy defaults to Korean and can generate an English set for international listings in the same layout.
- ## β FAQ
- **What size do App Store screenshots need to be?**
- For iPhone, 1320Γ2868 (6.9β³) and 1284Γ2778 (6.5β³) portrait β this skill always renders both sets, because App Store Connect can require the 6.5β³ set depending on your app's device support.
- **Does it work for Google Play?**
- Yes β 1080Γ1920 phone screenshots (Play's featuring guidelines want at least 1080px and 4+ slides), plus tablet and foldable coverage.
- **Do I need Figma or Photoshop?**
- No. Frames, backgrounds, and text are composed in HTML/CSS and rendered with headless Chrome.
- **Can it make screenshots for a Galaxy Fold or Flip?**
- Yes β Fold (with hinge line) and Flip frames are drawn in CSS, and the unfolded Fold screen can double as a Play tablet screenshot.
- ## π License
- [MIT](LICENSE)
- ---
- <div align="center">
- If this saved you a Figma session, a β helps other developers find it.
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.