v1.1.0 to v1.2.0

---

name: promote-app-release

description: >-

Builds a release marketing pack from README Version History: device

license: MIT

metadata:

author: carrick87

---

# Promote app release

## Goal

After a version is already published (or while marketing an existing current version), produce a **promotional pack**: real device screenshots, feature highlight board, mockup posters, newsletter banner + copy. Save under **Desktop** and **`marketing/<VERSION>/`**.

**This skill does not bump versions.** Changelog and semver come from `publish-new-version` / README. Do not run a version bump unless the user also asks for `/publish-new-version`.

## Triggers

Apply when the user says any of:

- promote release / promote app release

- marketing posters / promo images

- release newsletter

- App Store / Play Store promo images

- “make posters for vX.Y.Z”

## Preconditions — ask before generating

**Stop and confirm these inputs before screenshots or `GenerateImage`.** Do not assume StockApp / iOS defaults when the current project or chat has not already defined them.

### 1) Target version + baseline

1. Confirm **target version** (default: README `### vX.Y.Z (Current)`).

2. Confirm **baseline** for “what’s new” copy (default order):

- User-stated baseline version, else

- Previous `marketing/<version>/` folder if present, else

- Last **3 patch** versions of user-facing notes from Version History

### 2) Brand / app icon (required)

Ask for a **brand icon or app icon** unless one is already clearly defined in this conversation or the project (e.g. user attached an image, or a known path such as `marketing/<VERSION>/app-icon.png` / asset catalog was already agreed).

When asking, accept any of:

- An attached image in chat

- An absolute or repo-relative file path

- A short instruction to reuse the last icon from this chat / `marketing/<VERSION>/app-icon.png`

Copy the chosen icon to `marketing/<VERSION>/app-icon.png` and pass it via `reference_image_paths` on every marketing image.

**Do not invent or substitute a different logo** (e.g. leaf icons) when the dual-H / project icon is available or the user supplied one.

### 3) Platform (required)

Ask which platform this promo pack is for unless already stated in the trigger (e.g. “Play Store only”, “iOS App Store”, “web release”):

| Choice | Use for |

|--------|---------|

| **Android** | Google Play — Android phone frames, punch-hole / flat bezel (not iPhone notch / Dynamic Island), CTA **“GET IT ON Google Play”** / **“Update on Google Play”** |

| **iOS** | App Store — iPhone frames, CTA **“Download on the App Store”** / **“Update available”** |

| **Web** | Browser / product marketing — desktop or responsive web frames (not phone-first unless user asks), CTA **“Try it now”** / **“Update available”** |

If the user picks more than one platform, produce **separate asset sets** (or clearly labeled variants) per platform — do not mix iPhone frames into an Android-only Play Store pack.

### Optional HAR StockApp defaults

Only apply these when the project is clearly **HAR StockApp** (or the user says to reuse StockApp defaults):

- Brand name: **HAR StockApp**

- Icon: `StockMaster/StockMaster/Assets.xcassets/AppIcon.appiconset/1024.png` (dual-H navy/blue) — still confirm if missing from disk

- Palette: Harbour Teal + navy — **no purple neon**

- OTP bypass for screenshots (if needed): email `admin@testing.local`, username `csd.exec`

- Default platform if unspecified for StockApp: **iOS**

For other apps (e.g. LeaveApp), derive brand name from the repo/README and **always** ask for icon + platform when not already defined.

## Pipeline

```mermaid

flowchart TD

trigger[User: promote release / marketing posters]

ask[Ask icon if missing + ask platform if missing]

readPub[Read publish-new-version skill + README Version History]

delta[Diff features since baseline]

shots[Capture screenshots for chosen platform]

news[Draft newsletter copy]

out[Save to Desktop and marketing/VERSION/]

trigger --> ask --> readPub --> delta --> shots --> gen --> news --> out

```

Execute in order. **Do not start step 2 (screenshots) until icon and platform are resolved.**

### 1) Read changelog source of truth

1. Skim personal/project **`publish-new-version`** skill so you know where versions live — do **not** bump.

2. Parse `README.md` **`## Version History`** from `(Current)` back to the baseline.

3. Optionally cross-check `git log` / tags since baseline.

4. Build a **user-facing** feature table (no SQL, no branch/internal names). Group into poster themes.

### 2) Capture real screenshots

Match capture tooling to the chosen **platform**:

| Platform | Prefer | Notes |

|----------|--------|-------|

| **iOS** | Booted iPhone Simulator | Commands: [references/sim-screenshots.md](references/sim-screenshots.md) |

| **Android** | Booted Android emulator / device (`adb`) | Capture key tabs; use `screencap` |

Minimum set depends on the app. For **HAR StockApp** (iOS default):

| File | Screen |

|------|--------|

| `01-search.png` | Search |

| `02-sales.png` | Sales Opportunities |

| `03-stock-age.png` | Stock Age (filters expanded if possible) |

| `04-more.png` / `05-reports.png` | More hub and/or Custom Reports |

For other apps, capture the product’s primary tabs/screens (e.g. LeaveApp: Dashboard, Apply, History, Calendar, key detail states).

Write to `marketing/screenshots/<VERSION>/`.

If UI automation fails, drive as far as possible, document any missing screen in the newsletter footnote, and continue with available shots + icon.

### 3) Generate marketing images

Use **`GenerateImage`** with `reference_image_paths` = **confirmed app icon** + real screenshots. Follow **`imagegen-frontend-mobile`** (device frames, readable UI) and **`brandkit`** (sparse boards) spirit: Harbour Teal / navy when that is the brand palette, readable type.

**Frame and CTA rules by platform:**

| Platform | Device frames in mockups | Store / CTA wording |

|----------|--------------------------|---------------------|

| **Android** | Android phones only (punch-hole / thin bezel) | Google Play |

| **iOS** | iPhones | App Store |

| **Web** | Browser / laptop / responsive web chrome | Product URL / “Try it now” |

Deliverables (16:9 unless user asks otherwise). Filename prefix = product short name (e.g. `LeaveApp`, `HAR-StockApp`):

| Asset | Filename pattern | Spec |

|-------|------------------|------|

| Feature highlight board | `<Product>-<VER>-feature-board.png` | “What’s New” cards from delta; include icon; platform badge optional |

| Hero mockup poster | `<Product>-<VER>-hero-mockup.png` | 1–2 devices with real key screens |

| Feature mockup strip | `<Product>-<VER>-feature-strip.png` | 3 frames of primary screens |

| Newsletter banner | `<Product>-<VER>-newsletter-banner.png` | Brand + headline + platform CTA |

Copy outputs to:

- `~/Desktop/`

- `marketing/<VERSION>/`

### 4) Newsletter draft

Write `marketing/<VERSION>/NEWSLETTER.md` (and Desktop copy) that:

- Summarizes user-facing bullets for Slack/email paste

- Includes a short subject line and CTA matching the chosen platform (Google Play / App Store / web)

### 5) Completion message

List absolute paths for:

- Screenshots folder

- Newsletter path

- Icon path used

- Platform targeted

- Any screens that could not be captured

Remind: version was **not** bumped; for the next semver release use **publish-new-version**, then re-run this skill.

## Related skills

- **publish-new-version** — bump + changelog (run before or separately)

- **imagegen-frontend-mobile** — phone mockup framing

- **brandkit** — feature board composition

- **create-skill** — skill authoring rules (when editing this skill)