Claude Code/Agent Skill for making App Store screenshots with GPT Image 2 that you can upload. Give it your App Store link & screenshots of your app and it will
Claude Code/Agent Skill for making App Store screenshots with GPT Image 2 that you can upload. Give it your App Store link & screenshots of your app and it will
/shots
Claude Code & Agent Skill to generate Upload-ready App Store screenshots that drive installs — powered by GPT-Image 2.
Demo — from App Store URL to finished screenshots
Type /shots in Claude Code. Paste your App Store URL to scrape your listing,
let the skill research your app, market, theme, colors, and competitors,
add your own screenshots to .shots/app-screenshots/, drop inspo into .shots/inspo/,
and get scroll-stopping App Store screenshots in minutes — not days.
⚠️ API Key Required You need either:
OPENAI_API_KEYwith image generation enabled (GPT Image 2 access), ORFAL_KEYfor fal.ai generationOptional:
SEARCHAPI_KEYfrom SearchAPI.io (free trial available) enables scraping your or other apps' existing App Store screenshots to use as reference.
Install the Shots skill to your AI coding agent:
# Install to your current project
npx skills add hypersocialinc/shots
# Install globally (available in all projects)
npx skills add hypersocialinc/shots --global
# Install to specific agents
npx skills add hypersocialinc/shots --agent claude-code cursorWorks with Claude Code, Cursor, Codex, Cline, and 40+ other AI coding agents.
TikTok — bold claims, scroll-stopping color
Miniparty — playful identity, clear value props
Snapchat — high-energy visuals, benefit-first copy
ChatGPT — clean product tour, clear benefit headlines| Platform | Status | Composite Size | Final Panel Size |
|---|---|---|---|
| iPhone | ✅ Fully tested | 3456×2400 | 1284×2778 |
| iPad | ⚠️ Not fully tested | 6144×2732 | 2048×2732 |
| Android Phone | ⚠️ Not fully tested | 3240×1920 | 1080×1920 |
| Translation | ⚠️ Experimental | - | - |
| Apple Watch | ❌ Not yet supported | - | - |
| App Store Videos | Planned | - | - |
~$0.50 per generation (3 screenshots) · ~$0.17 per screenshot
Output image tokens account for ~95% of the cost and are fixed per composite size — prompt length and reference images are negligible. Based on real generation data and OpenAI GPT Image 2 pricing:
| Tokens | Cost | |
|---|---|---|
| Input (text + images) | ~1K-6K | $0.005-0.04 |
| Output (composite image) | 16,554 | $0.497 |
| Total | ~$0.50 |
Everything runs through a single /shots command. Sub-flows are triggered conversationally:
| Input | What it does |
|---|---|
/shots |
Full creation flow — questionnaire, workspace setup, generate screenshots |
/shots |
Scrape the App Store URL, then start creation flow |
/shots revise |
Iterate on existing shots with targeted feedback |
/shots translate [shot-id] [locale] |
Localize an existing shot/run into another language/locale |
/shots scrape |
Scrape App Store metadata only (no generation) |
You can also trigger sub-flows mid-conversation by saying "revise", "translate to Japanese", "scrape", etc. Benefit headlines are crafted from a saved strategy brief during the create flow.
Shots is a research-first screenshot generation system that produces conversion-optimized App Store and Google Play assets:
Sets up a .shots/ directory in your project with config schema, manifest tracking, and folders for reference images.
Automatically gathers context from multiple sources:
.shots/app-screenshots/ and inspiration images in .shots/inspo/SearchAPI Integration: When SEARCHAPI_KEY is set, the scraper fetches device-grouped screenshots (iPhone, iPad, etc.) from the App Store, providing richer visual references than the iTunes API alone. Sign up at searchapi.io — free trial available.
Saves a reusable research artifact (strategyBrief in config.json) containing:
Generates 6-8 problem-first benefit statements ranked for install intent (transformations, not features). Headlines are saved to config.json and reused across revisions/translations.
Creates wide panoramic composites via OpenAI's GPT Image 2 (direct API or fal.ai) using:
Automatically splits composites into 3 upload-ready individual screenshots with crop-safe boundaries (no text cutoff or visible seams).
All generated assets are versioned in timestamped run directories under .shots/runs/ (gitignored).
OPENAI_API_KEY or FAL_KEYSEARCHAPI_KEY (optional) — improves App Store screenshot scraping with device grouping…Using Shots for your app? We'd love to see it! Open a PR adding a link to your App Store or Google Play listing and we'll feature it here.
No open issues yet, or sync has not completed.