Skip to content
Back to search

shots

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 produce beautiful app store screenshots ready to upload to Apple (or Google)

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/hypersocialinc--shots/badge.svg)](/listings/hypersocialinc--shots)

HTML

<a href="/listings/hypersocialinc--shots"><img src="/api/listings/hypersocialinc--shots/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.

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 cursor

Works with Claude Code, Cursor, Codex, Cline, and [40+ other AI coding agents](https://github.com/vercel-labs/skills#supported-agents).

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 · 195 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/hero.png" alt="Shots — AI-powered App Store screenshots" width="500" />
  3. </p>
  4. <h1 align="center">/shots</h1>
  5. <p align="center">
  6. <strong>Claude Code & Agent Skill to generate Upload-ready App Store screenshots that drive installs — powered by GPT-Image 2.</strong>
  7. </p>
  8. <p align="center">
  9. <video src="https://github.com/user-attachments/assets/bd1a9037-470d-4c75-b6e9-bfed07425057" width="600" />
  10. <br>
  11. <em>Demo — from App Store URL to finished screenshots</em>
  12. </p>
  13. <p align="center">
  14. Type <code>/shots</code> in Claude Code. Paste your App Store URL to scrape your listing,<br>
  15. let the skill research your app, market, theme, colors, and competitors,<br>
  16. add your own screenshots to <code>.shots/app-screenshots/</code>, drop inspo into <code>.shots/inspo/</code>,<br>
  17. and get scroll-stopping App Store screenshots in minutes — not days.
  18. </p>
  19. > **⚠️ API Key Required**
  20. > You need either:
  21. > - `OPENAI_API_KEY` with image generation enabled (GPT Image 2 access), OR
  22. > - `FAL_KEY` for fal.ai generation
  23. >
  24. > Optional: `SEARCHAPI_KEY` from [SearchAPI.io](https://www.searchapi.io/) (free trial available) enables scraping your or other apps' existing App Store screenshots to use as reference.
  25. ## Install
  26. Install the Shots skill to your AI coding agent:
  27. ```bash
  28. # Install to your current project
  29. npx skills add hypersocialinc/shots
  30. # Install globally (available in all projects)
  31. npx skills add hypersocialinc/shots --global
  32. # Install to specific agents
  33. npx skills add hypersocialinc/shots --agent claude-code cursor
  34. ```
  35. Works with Claude Code, Cursor, Codex, Cline, and [40+ other AI coding agents](https://github.com/vercel-labs/skills#supported-agents).
  36. ## Examples
  37. <table>
  38. <tr>
  39. <td><img src="assets/example-tiktok-1.png" width="250" /></td>
  40. <td><img src="assets/example-tiktok-2.png" width="250" /></td>
  41. <td><img src="assets/example-tiktok-3.png" width="250" /></td>
  42. </tr>
  43. <tr>
  44. <td colspan="3"><em>TikTok — bold claims, scroll-stopping color</em></td>
  45. </tr>
  46. <tr>
  47. <td><img src="assets/example-miniparty-1.png" width="250" /></td>
  48. <td><img src="assets/example-miniparty-2.png" width="250" /></td>
  49. <td><img src="assets/example-miniparty-3.png" width="250" /></td>
  50. </tr>
  51. <tr>
  52. <td colspan="3"><em>Miniparty — playful identity, clear value props</em></td>
  53. </tr>
  54. <tr>
  55. <td><img src="assets/example-snapchat-1.png" width="250" /></td>
  56. <td><img src="assets/example-snapchat-2.png" width="250" /></td>
  57. <td><img src="assets/example-snapchat-3.png" width="250" /></td>
  58. </tr>
  59. <tr>
  60. <td colspan="3"><em>Snapchat — high-energy visuals, benefit-first copy</em></td>
  61. </tr>
  62. <tr>
  63. <td><img src="assets/example-chatgpt-1.png" width="250" /></td>
  64. <td><img src="assets/example-chatgpt-2.png" width="250" /></td>
  65. <td><img src="assets/example-chatgpt-3.png" width="250" /></td>
  66. </tr>
  67. <tr>
  68. <td colspan="3"><em>ChatGPT — clean product tour, clear benefit headlines</em></td>
  69. </tr>
  70. </table>
  71. ## Platform Support
  72. | Platform | Status | Composite Size | Final Panel Size |
  73. |----------|--------|----------------|------------------|
  74. | iPhone | ✅ Fully tested | 3456×2400 | 1284×2778 |
  75. | iPad | ⚠️ Not fully tested | 6144×2732 | 2048×2732 |
  76. | Android Phone | ⚠️ Not fully tested | 3240×1920 | 1080×1920 |
  77. | Translation | ⚠️ Experimental | - | - |
  78. | Apple Watch | ❌ Not yet supported | - | - |
  79. | App Store Videos | 🔜 Planned | - | - |
  80. ## Pricing
  81. ~**$0.50** per generation (3 screenshots) · ~**$0.17** per screenshot
  82. 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](https://platform.openai.com/docs/pricing):
  83. | | Tokens | Cost |
  84. |---|---|---|
  85. | Input (text + images) | ~1K-6K | $0.005-0.04 |
  86. | Output (composite image) | 16,554 | $0.497 |
  87. | **Total** | | **~$0.50** |
  88. ## Commands
  89. Everything runs through a single `/shots` command. Sub-flows are triggered conversationally:
  90. | Input | What it does |
  91. |-------|-------------|
  92. | `/shots` | Full creation flow — questionnaire, workspace setup, generate screenshots |
  93. | `/shots <url>` | Scrape the App Store URL, then start creation flow |
  94. | `/shots revise` | Iterate on existing shots with targeted feedback |
  95. | `/shots translate [shot-id] [locale]` | Localize an existing shot/run into another language/locale |
  96. | `/shots scrape <url>` | Scrape App Store metadata only (no generation) |
  97. 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.
  98. ## How It Works
  99. Shots is a research-first screenshot generation system that produces conversion-optimized App Store and Google Play assets:
  100. ### 1. **Initialize Workspace**
  101. Sets up a `.shots/` directory in your project with config schema, manifest tracking, and folders for reference images.
  102. ### 2. **Research Your App**
  103. Automatically gathers context from multiple sources:
  104. - **App Store scraping** — Pulls metadata, ratings, description, and existing screenshots from your listing (iTunes API + optional SearchAPI for device-grouped screenshots)
  105. - **Repository analysis** — Reads your README, package.json, and source code to understand your product
  106. - **Visual references** — Inspects screenshots you drop into `.shots/app-screenshots/` and inspiration images in `.shots/inspo/`
  107. - **Competitor mapping** — Identifies 3-5 direct competitors and analyzes their positioning, visual themes, and review language
  108. **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](https://www.searchapi.io/) — free trial available.
  109. ### 3. **Build Strategy Brief**
  110. Saves a reusable research artifact (`strategyBrief` in `config.json`) containing:
  111. - App summary, target audience, market maturity
  112. - Positioning (core promise, differentiator, proof points)
  113. - Competitor analysis with visual/copy patterns
  114. - Voice and language bank (tone, market words, taboo phrases)
  115. - Visual theme (style family, mood, palette, motifs)
  116. - Panel arc structure (Value → Flow → Trust narrative)
  117. ### 4. **Craft Benefit Headlines**
  118. 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.
  119. ### 5. **Generate Image Composites**
  120. Creates wide panoramic composites via OpenAI's GPT Image 2 (direct API or fal.ai) using:
  121. - Saved strategy brief and benefits (not regenerated each time)
  122. - Reference images for visual consistency
  123. - Platform-specific dimensions (iPhone: 3456×2400, iPad: 6144×2732, Android: 3240×1920)
  124. - Verbatim quote-based prompting for >95% text accuracy
  125. ### 6. **Crop Into Panels**
  126. Automatically splits composites into 3 upload-ready individual screenshots with crop-safe boundaries (no text cutoff or visible seams).
  127. ### 7. **Iterate or Translate**
  128. - **Revise:** Make surgical changes to existing shots while preserving strategy and visual identity
  129. - **Translate:** Localize screenshot copy into other languages/locales without rebuilding visuals
  130. All generated assets are versioned in timestamped run directories under `.shots/runs/` (gitignored).
  131. ## Requirements
  132. - Node.js 18+
  133. - `OPENAI_API_KEY` or `FAL_KEY`
  134. - `SEARCHAPI_KEY` (optional) — improves App Store screenshot scraping with device grouping
  135. ## Project Structure
  136. ```
  137. skills/shots/
  138. SKILL.md # Router, shared setup, config contract
  139. reference/
  140. create.md # Create flow
  141. strategy.md # Research + strategy brief + benefits
  142. prompting.md # GPT Image 2 prompt contract
  143. revise.md # Revision flow
  144. translate.md # Localization flow
  145. scrape.md # App Store scrape flow
  146. scripts/ # generate.mjs, crop.mjs, scrape.mjs
  147. .shots/ # Per-project workspace (created at runtime)
  148. config.json # Scaffold-generated app/workflow schema
  149. runs/ # Generated output (gitignored)
  150. ```
  151. ## Show Us What You Made
  152. Using Shots for your app? We'd love to see it! [Open a PR](https://github.com/hypersocialinc/shots/pulls) adding a link to your App Store or Google Play listing and we'll feature it here.
  153. <!-- Add your app below! -->

Ratings and comments

Sign in to rate this skill.

Sign in

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