---
name: storeframe-template-from-brief
description: >-
  Authors a portable StoreFrame template pack (YAML or JSON) from a short
  natural-language brief, with safe copy placement, correct Linked Story
  splicing, and a category-appropriate trust badge. Use when the user asks to
  generate a StoreFrame template, App Store screenshot story, linked frames,
  trust badge copy, or a .yaml/.json pack to import into Custom Studio /
  Advanced Studio.
---

# StoreFrame template from brief

Turn a user's plain-language description into a **portable template pack** that
can be imported in StoreFrame Custom Studio via **Import / Import pack**.

## Output contract

1. Prefer **YAML** (`.yaml`). Offer JSON if the user asks.
2. Write the file under the workspace (e.g. `develop/template-packs/<slug>.yaml`)
   unless the user names another path.
3. The pack **must** validate against the schema in
   [references/schema.md](references/schema.md).
4. Do **not** invent binary screenshots. Copy, colors, poses, trust badge, and
   link metadata only.
5. After writing the file, tell the user:
   - Open `https://aistoreframe.shop/editor?mode=custom&platform=<iphone|ipad>`
   - Click **Import pack** and select the file
   - Review linked frames and the trust badge in the editor before exporting

## Workflow

1. Read the brief: product type, platform, mood/colors, linked vs standalone,
   locale (default English), and any trust / safety / privacy angle.
2. Invent **original** copy — never paste competitor App Store wording.
3. Choose 5 pages unless the user asks otherwise (1–10 allowed).
4. **Trust badge (required decision):**
   - Prefer a pack-level `template.trustLabel` so all frames share one badge.
   - Write a short phrase (≤ ~40 chars) that fits the product — do **not** always
     use `Secure by design`.
   - Match the brief:
     - Finance / payments → e.g. `Bank-grade protection`, `Private money moves`
     - AI agent / productivity → e.g. `You stay in control`, `Approve every step`
     - Health / wellness → e.g. `Private by default`, `Your data stays yours`
     - Kids / family → e.g. `Built for families`, `Parent-approved calm`
     - Social / creator → e.g. `Your audience, your rules`
   - If the user wants no badge, set `template.showTrust: false`.
   - Only set per-page `trustLabel` / `showTrust` when frames truly need different badges.
5. If the brief wants a **two-frame panorama / linked opening**:
   - Set `template.linked: true`
   - Pages 1–2 share one `linkGroup`, with `linkIndex: 0` then `1`
   - Left: `copyAlign: left`, `phonePose: lean-left`
   - Right: `copyAlign: right`, `phonePose: lean-right`
   - Keep each panel's headline inside **its own** half; do not write across the seam
   - Align backgrounds so the pair reads as one composition
   - Later pages stay unlinked
6. Keep copy inside the safe band:
   - Short titles; use `\n` for 2 lines max when needed
   - `titleY` around `7`–`9` (never > `12` for dense headlines)
   - Prefer `titleX: 50` for centered frames; linked left/right may stay at `50` with align left/right
   - Subtitles one short sentence
7. Emit `format: storeframe-template` and `version: 1`.
8. Self-check with the checklist in [references/schema.md](references/schema.md).

## Deliver the pack to StoreFrame

Do **not** touch any host machine paths, databases, or deployment tooling.
Ship the pack only through product surfaces:

1. Save YAML/JSON under the user's workspace (e.g. `develop/template-packs/<slug>.yaml`).
2. Prefer the member Agent API when an API key is available:
   `POST https://api.slidemint.shop/api/v1/storeframe/agent/template-packs`
   with JSON body `{ "pack": { ... } }` (convert YAML → JSON first).
3. Or tell the user to open
   `https://aistoreframe.shop/editor?mode=custom&platform=<iphone|ipad>`,
   click **Import pack**, and select the file.

Publishing into the public StoreFrame catalog is an operator-only workflow outside
this skill. Never invent local repo paths or run database migrations for end users.

## Example

See [examples/habit-glow.yaml](examples/habit-glow.yaml) for a valid linked pack
with a custom trust badge.