⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
store-screenshots
앱스토어·플레이스토어 등록용 마케팅 스크린샷 자동 생성. 원본 앱 스크린샷에 기기 프레임(iPhone, iPad, Galaxy, Fold, Flip)을 씌우고 배경 그라데이션과 홍보 문구를 얹어 스토어 규격 PNG로 출력한다. Turns raw app screenshots into store-ready App Store & Google Play marketing images — device frames, branded backgrounds, marketing copy, exact store sizes. "스토어 스크린샷 만들어줘", "앱스토어 이미지", "플레이스토어 스크린샷", "make App Store screenshots", "Play Store screenshots" 같은 요청에 사용.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
store-screenshots
Raw app screenshots in → store-ready marketing images out. 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.
English · 한국어
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
App Store iPhone 6.5″ size (1242×2688), generated with the "match my app's design" style
🚀 Install
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
- Collect originals — scans your folder for screenshots; if there are none, the agent operates the app itself and captures them.
- Android:
adbtap/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?
- Android:
- 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
- Draft approval — a copy table plus one fully rendered first slide at real store size; full rendering starts only after your OK
- Render — frame, background, and copy composed in HTML/CSS, captured with headless Chrome
- 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 or 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
If this saved you a Figma session, a ⭐ helps other developers find it.
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
store-screenshots/SKILL.md13 KBupstream ↗
--- name: store-screenshots description: 앱스토어·플레이스토어 등록용 마케팅 스크린샷 자동 생성. 원본 앱 스크린샷에 기기 프레임(iPhone, iPad, Galaxy, Fold, Flip)을 씌우고 배경 그라데이션과 홍보 문구를 얹어 스토어 규격 PNG로 출력한다. Turns raw app screenshots into store-ready App Store & Google Play marketing images — device frames, branded backgrounds, marketing copy, exact store sizes. "스토어 스크린샷 만들어줘", "앱스토어 이미지", "플레이스토어 스크린샷", "make App Store screenshots", "Play Store screenshots" 같은 요청에 사용. argument-hint: [원본 스크린샷 폴더 경로] --- # 스토어 스크린샷 생성기 원본 앱 스크린샷을 받아 → 기기 프레임 + 브랜드 배경 + 홍보 문구를 얹은 스토어 등록용 이미지를 만든다. ## 에이전트 호환 이 스킬은 Claude Code와 OpenAI Codex 어디서든 동작한다. 본문의 표현은 실행 중인 에이전트에 맞게 해석한다: - **"선택지로 묻는다"** — 선택지 UI 툴이 있으면 그걸 쓰고(Claude Code: AskUserQuestion, multiSelect 지원), 없으면(Codex 등) 번호를 매긴 선택지를 텍스트로 제시하고 번호로 답하게 한다. 추천 항목에는 "(Recommended)"를 붙인다. - **"이미지를 열어 확인한다"** — 에이전트의 이미지 열람 수단을 쓴다(Claude Code: Read, Codex: view_image). - **원본 폴더 인자** — Claude Code는 `$ARGUMENTS`, Codex는 스킬 호출 문장에 함께 적힌 경로를 쓴다. ## 절대 규칙 1. **컨펌 전에는 전체 렌더링을 하지 않는다.** 문구 초안 표 + 시안 1장(첫 슬라이드)을 보여주고 사용자 OK를 받은 뒤에만 나머지를 렌더링한다. 2. 최종 PNG는 전부 픽셀 크기를 검증(`sips` 또는 ImageMagick `identify`)하고, 규격 표와 다르면 다시 렌더링한다. 3. 기기 프레임은 외부에서 다운로드하지 않고 HTML/CSS로 직접 그린다(라이선스·네트워크 문제 없음). 실사 프레임을 원하면 아래 "실사 프레임" 참고. 4. 중간 작업 파일(html 등)은 임시 폴더(스크래치패드 등)에 두고, 출력 폴더에는 최종 PNG만 남긴다. 5. **사용자에게 손을 쓰게 하지 않는다.** 화면 전환·탭 같은 기기 조작은 에이전트가 adb/idb/AppleScript로 직접 한다(아래 "자동 캡처"). 사용자의 개입은 선택지 고르기나 짧은 타이핑까지만. "화면 띄우고 메시지 보내주세요" 같은 진행은 금지 — 자동화 수단이 전부 실패했을 때만 선택지로 수동 진행 여부를 묻는다. ## 워크플로 ### 1. 원본 수집 - **재실행이면 먼저 묻는다.** 출력 폴더(`store-screenshots/`)나 이전에 쓰던 원본이 이미 있는 상태에서 "다시 해줘" 류의 요청이 오면, 작업 전에 선택지로 묻는다: - "기존 스크린샷 재활용해서 업데이트 (Recommended)" — 캡처를 생략하고 기존 원본으로 문구·디자인·규격만 다시 작업한다. - "처음부터 새로 만들기" — 앱에서 원본 캡처부터 전부 다시 한다. - 어느 쪽이든 렌더링 전에 대상 출력 폴더를 비워, 장수가 달라졌을 때 이전 파일이 섞이지 않게 한다. - 인자로 폴더를 받았으면 거기서, 아니면 현재 디렉토리에서 png/jpg를 스캔한다: `find . -maxdepth 2 \( -iname '*.png' -o -iname '*.jpg' \) -not -path '*/store-screenshots/*'` - 파일이 없으면 **에이전트가 직접 기기를 조작해서 캡처한다**(아래 자동 캡처). 사용자에게 화면 전환을 부탁하지 않는다. - **각 원본 이미지를 열어 무슨 화면인지 파악한다.** 문구는 실제 화면 내용에 근거해야 한다. 직접 캡처한 경우에도 캡처 직후 이미지를 열어 의도한 화면이 맞는지 확인하고, 아니면 다시 탐색해서 재캡처한다. - 앱 이름·아이콘을 찾을 수 있으면 참고한다(Info.plist, strings.xml, ic_launcher, 앱 아이콘 파일 등). - 캡처할 화면 목록(홈, 핵심 기능 화면 등)은 에이전트가 앱 구조를 보고 스스로 정하되, 애매하면 2단계 질문에 선택지로 끼워서 같이 묻는다. #### 자동 캡처 — Android (adb, 완전 자동) 1. `adb devices`로 기기/에뮬레이터 확인. 앱 실행: `adb shell monkey -p <package> 1` 또는 `adb shell am start -n <package>/<activity>`. 2. 현재 화면의 UI 구조를 덤프해서 탭·버튼 좌표를 얻는다: `adb exec-out uiautomator dump /dev/tty` → XML의 `bounds="[x1,y1][x2,y2]"`에서 중심 좌표 계산. 3. 이동 → 안정화 → 캡처를 한 번에 (sleep은 기기 쪽에서 실행): `adb shell "input tap X Y; sleep 1" && adb exec-out screencap -p > 02-mypet.png` 4. 화면마다 2~3을 반복. 스크롤이 필요하면 `adb shell input swipe`, 텍스트 입력은 `adb shell input text`. #### 자동 캡처 — iOS 시뮬레이터 캡처는 `xcrun simctl io booted screenshot 01.png`. 화면 이동은 우선순위대로: 0. **딥링크가 최우선.** 앱 소스에서 URL scheme을 찾는다(Info.plist의 `CFBundleURLTypes`, 라우팅 코드). 있으면 탭이 아예 필요 없다: `xcrun simctl openurl booted "myapp://calendar"` → 1초 대기 → 캡처. simctl만으로 100% 자동화되므로 아래 도구들이 전부 불필요. scheme이 없는 앱이면 "탭별 딥링크를 앱에 추가해줄까?"를 선택지로 제안해볼 것 — 몇 줄이면 되고 이후 재실행도 편해진다. 1. **idb**가 있으면(`command -v idb`): `idb ui describe-all`로 요소 좌표를 얻고 `idb ui tap X Y`. 2. **Maestro**가 있으면(`command -v maestro`): `tapOn`/`takeScreenshot`으로 flow yaml을 만들어 `maestro test`. 3. 둘 다 없으면 AppleScript로 Simulator 창을 직접 클릭(손쉬운 사용 권한 필요): System Events로 Simulator 창의 position/size를 얻고, 기기 해상도 → 창 좌표로 비례 변환해 `click at {x, y}`, 사이사이 `delay 1`. 4. 전부 실패했을 때만 선택지로 묻는다: "idb 설치 후 자동 진행 (Recommended)" / "앱에 딥링크 추가하고 진행" / "내가 직접 화면을 넘길게". 수동을 골랐을 때만 사용자에게 화면 전환을 부탁한다. #### 캡처 전 상태바 정리 (스토어 품질) 모든 캡처의 시계·배터리·안테나를 통일하면 결과물이 한 세트로 보인다. 캡처 시작 전에 걸고, 끝나면 해제한다. - iOS: ```bash xcrun simctl status_bar booted override --time "9:41" --batteryLevel 100 --cellularBars 4 --wifiBars 3 # 캡처 끝난 뒤: xcrun simctl status_bar booted clear ``` - Android (데모 모드): ```bash adb shell settings put global sysui_demo_allowed 1 adb shell am broadcast -a com.android.systemui.demo -e command enter adb shell am broadcast -a com.android.systemui.demo -e command clock -e hhmm 0941 adb shell am broadcast -a com.android.systemui.demo -e command battery -e level 100 -e plugged false adb shell am broadcast -a com.android.systemui.demo -e command network -e wifi show -e level 4 # 캡처 끝난 뒤: adb shell am broadcast -a com.android.systemui.demo -e command exit ``` ### 2. 질문 플로우 (전부 선택지로) 이미 대화에서 답이 나온 항목은 다시 묻지 않는다. 사용자가 타이핑 없이 **선택만으로** 답할 수 있게 선택지로 묻는다. **1차 — 플랫폼** (질문 1개): - App Store (iOS) / Google Play (Android) / 둘 다 **2차 — 세부** (질문 4개를 한 번에, 기종 선택지는 1차 답에 맞춰 구성): | 질문 | 선택지 | |---|---| | 기종 (복수 선택) | iOS: iPhone(Recommended), iPad · Android: Galaxy 폰(Recommended), Fold, Flip, 태블릿 · 둘 다: iPhone, iPad, Galaxy 폰, Fold·Flip | | 스타일 | 기존 앱 디자인에 맞추기(Recommended) / 모던·미니멀 / 밝고 팝하게 / 다크·세련 | | 장수 | 4장 / 5장(Recommended) / 6장 / 스토어 최대 | | 어필 방향 | 알아서 뽑아줘(Recommended) / 핵심 기능 직접 지정 — 직접 지정이면 자유 입력(Other)으로 기능을 적게 한다 | ### 3. 배경 디자인 결정 스타일 답에 따라 배경·장식·톤을 정한다. - **기존 앱 디자인에 맞추기** (기본): 앱의 실제 디자인 시스템에서 뽑는다. - 색: Android는 `res/values/colors.xml`·`themes.xml`, iOS는 `Assets.xcassets`의 Color Set, Flutter는 `ThemeData`, 웹 기반이면 CSS 변수·tailwind config. 소스가 없으면 앱 아이콘·스크린샷에서 주조색과 포인트색을 추출한다. - 톤: 앱 UI가 라이트면 밝게, 다크면 어둡게. 앱의 코너 radius가 크면 배경 장식도 둥글게, 버튼이 각지면 장식도 각지게. - **모던·미니멀**: 밝은 단색 또는 아주 옅은 그라데이션, 여백 크게, 장식 없음. 헤드라인 볼드 + 서브카피 옅게. - **밝고 팝하게**: 채도 높은 그라데이션(주조색 ± 인접색), 큰 블롭·도형 장식 1~2개, 기울임 적극 사용. - **다크·세련**: `#0b0b0f` 계열 어두운 배경 + 주조색 글로우·그라데이션 포인트, 프레임 그림자 강하게. 공통: 텍스트는 상단 12~18%에 배경과 대비 확실한 색, 폰트 `-apple-system, "Apple SD Gothic Neo", "Malgun Gothic", sans-serif`. 슬라이드마다 같은 hue에서 명도만 살짝 바꾸면 세트 느낌이 난다. 기기는 하단 중앙 + bottom bleed(화면 아래로 살짝 잘리게) + `box-shadow`, 홀수 장 -2도 / 짝수 장 +2도 기울이면 리듬감(기울임 여부는 컨펌 때 언급). ### 4. 시안 + 문구 초안 ← 컨펌 게이트 - 슬라이드 구성 (2차 질문의 장수 답 반영, App Store 최대 10장·Play 폼팩터당 2~8장): - 1장: 훅 — 앱의 핵심 가치 한 줄. 목록에서 1~2장만 보이므로 가장 중요하다. - 중간: 자랑할 기능 하나씩 (어필 방향 반영). - 마지막: 신뢰·마무리(리뷰, 다운로드 수, CTA) — 근거가 있을 때만. - 문구 규칙: - 헤드라인: 한글 6~14자, 혜택 중심. "할 일을 잊지 않게" > "알림 기능". - 서브카피: 0~1줄, 20자 이내. - "1위", "최고" 같은 표현은 근거가 있을 때만. - **문구 표 + 시안 1장을 함께 제시한다**: - 표: | # | 원본 파일 | 헤드라인 | 서브카피 | - 시안: 1번 슬라이드만 실제 규격으로 렌더링해서 macOS면 `open <파일>`로 띄워 보여준다. 배경·프레임·문구를 실물로 확인시키기 위함. - 수정 요청이 오면 반영해 다시 제시한다(시안도 다시 렌더링). **OK를 받으면** 전체 렌더링으로. ### 5. 렌더링 - 타깃 × 슬라이드마다 HTML 파일을 생성한다(아래 템플릿). body 크기 = 스토어 규격 픽셀. - 원본 이미지는 상대경로 `<img src="./01.png">`로 참조한다(data URI 불필요 — 같은 폴더에 복사해 두면 된다). - 렌더 명령 (기본: 헤드리스 크롬): ```bash # 크롬 실행 파일 찾기 (OS에 맞게) CHROME="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" # macOS command -v google-chrome >/dev/null 2>&1 && CHROME=google-chrome # Linux command -v chromium >/dev/null 2>&1 && CHROME=chromium "$CHROME" --headless=new --screenshot="$OUT" --window-size=1320,2868 \ --force-device-scale-factor=1 --hide-scrollbars --virtual-time-budget=2000 "$HTML" ``` - 크롬이 없으면 폴백: `npx -y playwright screenshot --viewport-size=1320,2868 "$HTML" "$OUT"` (첫 실행 시 `npx playwright install chromium` 필요할 수 있음). ### 6. 검증·보고 - 픽셀 크기 전수 확인 후 규격 표와 대조: macOS는 `sips -g pixelWidth -g pixelHeight <파일>`, 그 외 OS는 `identify -format '%wx%h\n' <파일>`(ImageMagick). - 슬라이드 최소 1장을 이미지로 직접 열어 확인: 글자 잘림, 프레임 비율 왜곡, 스크린샷 상하단 잘림. - 출력 구조를 보여주고, 스토어 어느 슬롯에 올리면 되는지 안내하며 마무리한다. 출력 구조: ``` store-screenshots/ ├── appstore-iphone-69/01.png … # 1320×2868 ├── appstore-iphone-65/ # 1284×2778 — iPhone은 항상 두 세트 ├── appstore-ipad-13/ ├── play-phone/ └── play-foldable/ ``` ## 스토어 규격 (2026년 8월 기준, 공식 문서 검증 완료) | 타깃 | 크기(px, 세로) | 장수 | 비고 | |---|---|---|---| | App Store iPhone 6.9" | 1320×2868 | 최대 10 | 1290×2796도 허용. iPhone Air·iPhone 17 Pro Max·16 Pro Max 포함 | | App Store iPhone 6.5" | 1284×2778 | 최대 10 | 1242×2688도 허용 | | App Store iPad 13" | 2064×2752 | 최대 10 | iPad 지원 앱이면 필수. 2048×2732 허용 | | Play 폰 | 1080×1920 | 2~8 | 9:16. 피처링 조건: 최소 1080px, 4장 이상 | | Play 태블릿 7"/10" | 1080×1920 또는 1920×1080 | 최대 8 | 태블릿 지원 시 | | Play 폴더블 | 폰 슬롯에 포함 | — | 별도 슬롯 없음. FoldREADME.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/leehueeng-store-screenshots-store-screenshots.md