SuperAPI AI Directory

store-promo-shots

General & other

View repository

Updated 10-16 09:30

About this skill

Store Promo Shots

Batch-composite real screenshots into the promotional images each store needs:Copy + background + screenshotsThree layers, all sizes in one go.

This Skill only handles "compositing". The screenshots themselves, store copy, and privacy policy are handled by three publishing Kits: app-store-release-kit、 wechat-miniprogram-store-kit、 chrome-extension-store-kit. Take the screenshots they produce and feed them straight in here.

First, one hard rule

Screenshots must come from a real running interface. Apple reviews features against screenshots; if you draw an interface that doesn't exist in the product, it will be rejected as "inconsistent with actual functionality". This Skill adds copy, backgrounds, and device frames to real screenshots; it does not generate fake interfaces. If the user can't provide screenshots, have them run the app and capture them first—don't draw them for them.

How to start

  1. Find the screenshots. Prefer the set already produced by the publishing Kit; otherwise ask the user where the screenshot directory is. Confirm which feature each image corresponds to, and whether it's a phone, desktop web, or mini program.

  2. Confirm the brand: primary color, text color, whether the font is sans-serif or serif, and whether the device frame has a white or black border. If the user can't provide it, take the primary color from the screenshots and clearly tell them which color you took.

  3. Write a promo.json(copy assets/promo.template.json)。

  4. Render:

    python3 scripts/render_promo.py promo.json
    
  5. Show the output to the user and revise based on feedback, then promo.json run it again. Changing copy and colors doesn't require re-screenshotting.

To preview just one first:--slide 2; to output just one size:--only iphone-6.9。

How to order the sequence

Store listing pageonly shows the first two, so always put what you most want people to see in the first one—don't put a settings page.

A conventional 5-image layout:

Position What to put Suggested layout
1 Explain in one sentence what this product is statement or headline-top-bleed
2 The strongest feature headline-top-bleed
3 Second feature, change the rhythm headline-top-float or headline-bottom
4 Differentiating point / effect comparison tilted or before-after
5 Breadth: multiple interfaces, multiple platforms, ecosystem stack

Using the same layout for all five is dull; after three, definitely change the composition or the background color once.

Eight layouts

For detailed explanations and when to use which, see references/layouts.md。

Layout What it looks like Suitable for
headline-top-bleed Copy on top, screenshot bleeding from the bottom Default first choice, best balance of information and display area
headline-top-float Copy on top, full device centered with whitespace The interface itself looks good and you want to show it fully
headline-bottom Device on top, copy below Change the rhythm in the sequence
statement Copy only, no screenshot Opening for the first image, or call to action for the last
tilted Device with perspective tilt Most eye-catching for a single image; don't use two in a row
full-bleed Screenshot fills the frame, copy pressed to the top Content-type products like photos and videos
before-after Two images compared top and bottom, with BEFORE/AFTER Retouching, cleaning, optimization types
stack Three devices stacked Show breadth or multiple platforms

Copy rules

  • The main title should be no more than 8 Chinese characters per line, capped at two lines. The renderer will automatically shrink the font size based on available width, but if it shrinks to a very small size, that means the sentence itself is too long. Go back and revise the copy; don't expect font shrinking to save it.
  • The subtitle can be omitted. If you include one, write something specific ("voice, paste, and share all work"), not something like "efficient and convenient."
  • If you want a few characters in a sentence to stand out, wrap them in ** :到点提醒**不到点不打扰**. The bolded characters will stay bold, and the rest will automatically fall back to regular weight.
  • Use \nfor line breaks. Control the line breaks yourself; don't let it wrap at strange places.

For more, see references/copy-rules.md。

Size

sizes Write a few in there and you get that many sets. The same manifest works for both portrait and landscape: portrait automatically uses a phone frame, and landscape automatically switches to a browser window frame (Chrome extensions and web apps are desktop, so cramming in a whole phone looks weird). If you want to force a specific one for a single image, write it on that slide: "frame": "phone" | "browser" | "none"。

Common:iphone-6.9(the current mainstay for the App Store),ipad-13、wx-share(5:4 share card for mini programs), chrome-marquee(1400×560 homepage recommendation slot),chrome-tile(440×280 small list image),og(1200×630). For the full table, see references/store-sizes.md。

Theme

Six presets:light dark brand editorial gradient ink。 theme Writing it at the top level unifies the whole set; writing it on a single slide changes only that one. A common approach in reference images is to intersperse one dark or one brand-color slide among five, giving the sequence some breathing room.

Any item can be overridden individually:bg supports solid colors and CSS gradients,fg text color,sub subtitle color, device takes white / black / none,font takes sans / serif。

Implementation Notes

The copy, background, and device frames are all HTML/CSS, captured at exact pixels with headless Chrome. So the text is rendered as vectors and is always crisp; there is no situation where an image model blurs the text. Changing the brand color is just changing one variable, with no need to redo a whole set of images.

Requires Chrome / Chromium / Edge to be installed locally. No internet connection is needed, and no image API is called.

Boundaries

  • It does not generate interfaces. Screenshots have to be real.
  • It does not do video previews (App Preview).
  • Mini program codes, QR codes, and the like must be exported from the official backend; here only the placeholder is left.
  • The output images are design drafts. Before submitting, double-check the current store's size requirements yourself; the rules change.