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
-
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.
-
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.
-
Write a
promo.json(copy assets/promo.template.json)。 -
Render:
python3 scripts/render_promo.py promo.json -
Show the output to the user and revise based on feedback, then
promo.jsonrun 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.