Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/leehueeng--store-screenshots/badge.svg)](/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

i

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)

  1. <div align="center">
  2. <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%" />
  3. # store-screenshots
  4. **Raw app screenshots in β†’ store-ready marketing images out.**<br>
  5. 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.
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  7. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Agent%20Skill-D97757?logo=claude&logoColor=white)](https://claude.com/claude-code)
  8. [![Codex](https://img.shields.io/badge/Codex-Agent%20Skill-000000?logo=openai&logoColor=white)](https://openai.com/codex)
  9. [![Stores](https://img.shields.io/badge/App%20Store%20%26%20Google%20Play-exact%20sizes-4285F4)](#-store-specs-it-targets)
  10. **English** Β· [ν•œκ΅­μ–΄](README.ko.md)
  11. </div>
  12. ---
  13. 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.
  14. ## ✨ What it does
  15. - πŸ“± **Device frames** β€” iPhone, iPad, Galaxy, **Fold**, **Flip**, drawn in pure CSS (no mockup downloads, no license worries)
  16. - 🎨 **Branded backgrounds** β€” extracts your app's real design colors (`colors.xml`, `.xcassets`, app icon); Modern/Minimal, Pop, and Dark presets included
  17. - ✍️ **Marketing copy** β€” reads each screen and proposes benefit-driven headlines and subcopy, and only proceeds **after you approve**
  18. - πŸ“ **Exact store sizes** β€” App Store 1320Γ—2868 / 1284Γ—2778, iPad 2064Γ—2752, Google Play 1080Γ—1920, and more β€” every PNG is pixel-verified
  19. - πŸ€– **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
  20. ## πŸ–ΌοΈ Example output
  21. <div align="center">
  22. <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" />
  23. *App Store iPhone 6.5β€³ size (1242Γ—2688), generated with the "match my app's design" style*
  24. </div>
  25. ## πŸš€ Install
  26. ```bash
  27. git clone https://github.com/LeeHueeng/store-screenshots.git
  28. # Claude Code
  29. cp -r store-screenshots/store-screenshots ~/.claude/skills/
  30. # Codex
  31. mkdir -p ~/.agents/skills
  32. cp -r store-screenshots/store-screenshots ~/.agents/skills/
  33. ```
  34. | Agent | All projects | One project only |
  35. |-------|--------------|------------------|
  36. | Claude Code | `~/.claude/skills/` | `<project>/.claude/skills/` |
  37. | Codex | `~/.agents/skills/` | `<repo root>/.agents/skills/` |
  38. > On older Codex versions the skills path may be `~/.codex/skills/`.
  39. ## πŸ’¬ Usage
  40. In Claude Code:
  41. ```
  42. /store-screenshots ./screenshots
  43. ```
  44. In Codex:
  45. ```
  46. $store-screenshots ./screenshots
  47. ```
  48. (or pick it from `/skills`)
  49. Or just ask in plain language β€” *"make my App Store screenshots"*.
  50. ### How a run goes
  51. 1. **Collect originals** β€” scans your folder for screenshots; if there are none, the agent **operates the app itself** and captures them.
  52. - Android: `adb` tap/screencap Β· iOS Simulator: deep links (`simctl openurl`) first, then idb, Maestro, or AppleScript
  53. - Status bar unified to 9:41 / 100% battery across every capture
  54. - You never have to touch the device β€” you only pick options and approve copy
  55. - On a re-run it first asks: reuse existing screenshots, or start fresh?
  56. 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
  57. 3. **Draft approval** β€” a copy table plus one fully rendered first slide at real store size; full rendering starts only after your OK
  58. 4. **Render** β€” frame, background, and copy composed in HTML/CSS, captured with headless Chrome
  59. 5. **Verify** β€” every PNG's pixel size is checked against the store spec table
  60. ## πŸ“¦ Output
  61. ```
  62. store-screenshots/
  63. β”œβ”€β”€ appstore-iphone-69/01.png … # 1320Γ—2868
  64. β”œβ”€β”€ appstore-iphone-65/ # 1242Γ—2688 β€” iPhone always gets both sets
  65. β”œβ”€β”€ appstore-ipad-13/ # 2064Γ—2752
  66. β”œβ”€β”€ play-phone/ # 1080Γ—1920
  67. └── play-foldable/
  68. ```
  69. ## πŸ“ Store specs it targets
  70. | Target | Size (px, portrait) | Slides | Notes |
  71. |--------|--------------------:|--------|-------|
  72. | App Store iPhone 6.9β€³ | 1320Γ—2868 | up to 10 | 1290Γ—2796 also accepted |
  73. | App Store iPhone 6.5β€³ | 1284Γ—2778 | up to 10 | 1242Γ—2688 also accepted |
  74. | App Store iPad 13β€³ | 2064Γ—2752 | up to 10 | required if the app supports iPad |
  75. | Google Play phone | 1080Γ—1920 | 2–8 | 9:16 Β· featuring needs β‰₯1080px and 4+ slides |
  76. | Google Play tablet | 1080Γ—1920 / 1920Γ—1080 | up to 8 | when tablet is supported |
  77. | Google Play foldable | in the phone slot | β€” | Fold's unfolded screen also works for the tablet slot |
  78. ## βœ… Requirements
  79. | You need | Notes |
  80. |----------|-------|
  81. | [Claude Code](https://claude.com/claude-code) or [Codex](https://openai.com/codex) | either one β€” the skill runs in both |
  82. | Chrome or Chromium | for headless rendering β€” falls back to Playwright automatically |
  83. | `sips` (built into macOS) or ImageMagick | for pixel-size verification |
  84. ## 🧩 Why this instead of a web tool?
  85. - **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.
  86. - **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.
  87. - **Nothing leaves your machine.** No uploads, no accounts, no watermarks β€” plain HTML/CSS rendered locally.
  88. - **Korean-first, English-ready.** Copy defaults to Korean and can generate an English set for international listings in the same layout.
  89. ## ❓ FAQ
  90. **What size do App Store screenshots need to be?**
  91. 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.
  92. **Does it work for Google Play?**
  93. Yes β€” 1080Γ—1920 phone screenshots (Play's featuring guidelines want at least 1080px and 4+ slides), plus tablet and foldable coverage.
  94. **Do I need Figma or Photoshop?**
  95. No. Frames, backgrounds, and text are composed in HTML/CSS and rendered with headless Chrome.
  96. **Can it make screenshots for a Galaxy Fold or Flip?**
  97. Yes β€” Fold (with hinge line) and Flip frames are drawn in CSS, and the unfolded Fold screen can double as a Play tablet screenshot.
  98. ## πŸ“„ License
  99. [MIT](LICENSE)
  100. ---
  101. <div align="center">
  102. If this saved you a Figma session, a ⭐ helps other developers find it.
  103. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.