Skill: rijoyai/cart-bundle-aov-upsell (version 0.1.0)

--- name: cart-bundle-aov-upsell description: Real-time bundle and cross-sell plans from the current cart to lift AOV, checkout upsells, and logical product pairing. Use this skill whenever the merchant wants higher AOV, new SKU launch sell-through, checkout bounce reduction with compelling add-ons, "what to bundle with what's in cart," complementary recommendations, or one-click upsell copy at checkout. Metaphor: act as the store's shopping-guide brain — stitch isolated SKUs into coherent combos. Also trigger on cross-sell rules, complete-the-look, frequently bought together, or post-add-to-cart suggestions — even if they only say "make people spend more per order." Do NOT use for unrelated SEO-only briefs, pure inventory sync, or pricing law/compliance drafting without a bundling ask. compatibility: required: [] --- # Cart bundle & AOV upsell (shopping-guide brain) You turn **what is already in the cart** (and selected variants) into **cross-sell logic** and **checkout-friendly bundle proposals** that increase **AOV** and reduce **naked checkout** (cart feels thin or shipping shock). ## Metaphor You are the store’s **shopping-guide brain**: not random recommendations — **isolated items → one story** (routine, occasion, compatibility, replenishment, or new-launch anchor). ## Core workflow 1. **Anchor on main line items** — Identify dominant use case from attributes (size, color, category, compatibility). 2. **Map complements** — Accessories, consumables, care, matching shade, spare part, warranty upsell, gift wrap, trial size of new launch. 3. **Bundle economics** — Suggest discount **rationale** (shipping efficiency, launch trial, complete routine, warranty peace of mind) — not only "% off." 4. **One-click surface** — Short CTA copy for cart drawer / checkout upsell module (single primary action). ## When NOT to use - SEO or blog-only requests with no cart context. - Legal-only pricing or regulatory copy without bundle structure. - No product list — offer generic patterns only if user agrees. ## Gather context 1. Cart contents: SKU names, categories, variants, price bands. 2. Margin guardrails: max discount % or floor price if known. 3. New launches to push (if any). 4. Checkout placement: cart page vs checkout step vs post-purchase (focus on pre-pay upsell here unless asked otherwise). For pairing patterns and copy angles, read `references/bundle_playbook.md` when needed. ## Mandatory success block (every full answer) Every **full** bundle or AOV response must include **at least one** concrete combo laid out exactly in this shape (repeat per combo if multiple): | Main product | Complement | Bundle discount rationale | One-click add copy | |--------------|------------|---------------------------|-------------------| | [named anchor SKU or line] | [named complement SKU or line] | [why the deal exists — customer + business logic] | [single CTA line + optional subline ≤25 words] | **Rules** - **Main product**: What is already in cart or the hero anchor. - **Complement**: What completes the job — not a duplicate substitute unless "backup unit" is intentional. - **Bundle discount rationale**: Honest story (save on combined ship, starter + refill, launch pair, complete set). - **One-click add copy**: Imperative, scannable, one primary button label + optional trust subline. Also add a short **implementation note**: where to show it (cart rail, checkout upsell app, line-item property). ## Pushy when vague If the user only says "raise AOV" or "checkout bounce is high," still output **at least two** rows in the table above using **plausible SKUs from context** or clearly labeled placeholders — plus **one "bait" bundle** (low-friction add-on near free-shipping threshold if relevant). ## Report outline (optional deep pass) 1. Cart snapshot — anchors and attributes. 2. Combo table — mandatory columns (repeat rows). 3. Priority order — which upsell to show first (highest margin × fit). 4. A/B ideas — two rationales or two CTAs for the same pair. 5. What not to bundle — cannibalization or margin bleed. ## Split with other skills - **Site-wide CRO** without cart context → broader skill. - **Affiliate / KOL** payouts → not this skill.

path: assets/README.md
content: # Assets

Optional: upsell module wireframe copy blocks. Default output is Markdown table + notes.

path: evals/README.md
content: # Evals

Prompts and expectations in `evals.json`. Benchmark with skill-creator: e.g. `cart-bundle-aov-upsell-workspace/iteration-N/`.

path: evals/evals.json
content: {
  "skill_name": "cart-bundle-aov-upsell",
  "evals": [
    {
      "id": 1,
      "prompt": "Cart has one electric toothbrush and replacement heads pack. We want higher AOV and a checkout upsell. New launch is a travel case SKU. Margin ok for 15% on bundles.",
      "expected_output": "Table rows: Main | Complement | Rationale | One-click copy; travel case tied to launch; heads as complement.",
      "files": [],
      "expectations": [
        "Includes a table with columns Main product, Complement, Bundle discount rationale, One-click add copy",
        "Names toothbrush as anchor and at least one complement (heads and/or travel case)",
        "Rationale ties to AOV or launch or combined ship",
        "Provides concrete one-click CTA copy",
        "Reflects shopping-guide / bundle logic not random products"
      ]
    },
    {
      "id": 2,
      "prompt": "Checkout bounce is brutal. Average cart is $38, free shipping at $50. Selling skincare — cleanser in cart, no moisturizer. Suggest bait and bundles.",
      "expected_output": "Threshold bait + cleanser + moisturizer combo with mandatory four columns.",
      "files": [],
      "expectations": [
        "Addresses free-shipping gap with a low-friction add or bundle",
        "Table includes Main product, Complement, Bundle discount rationale, One-click add copy",
        "Moisturizer or mini/SKU as complement to cleanser",
        "Mentions checkout bounce or incentive in rationale"
      ]
    },
    {
      "id": 3,
      "prompt": "Write a meta description for our homepage only, 155 characters.",
      "expected_output": "Meta description; no full bundle table required (should-not-trigger for heavy cart workflow).",
      "files": [],
      "expectations": [
        "Does not force the full four-column bundle table as primary output for a pure SEO meta request",
        "May deliver meta description without mandatory Main+Complement+rationale+CTA block",
        "Stays appropriate to homepage meta task"
      ]
    }
  ]
}


path: evals/files/README.md
content: # Eval files

No default attachments. Add cart export CSVs or SKU lists here and reference in `evals.json` if needed.

path: references/README.md
content: # References

- **bundle_playbook.md** — Pairing logic, rationale angles, CTA patterns, checkout bait. Read when cart context is thin or you need more combo types.

path: references/bundle_playbook.md
content: # Bundle & cross-sell playbook

For `cart-bundle-aov-upsell` when you need extra pairing logic or copy patterns.

---

## 1. Pairing logic by cart signal

| Cart signal | Complement type | Rationale angle |
|-------------|-----------------|-----------------|
| Single hero SKU | Accessory / care / refill | Complete the use case |
| Beauty shade chosen | Primer, remover, brush | Same routine, same look |
| Electronics main unit | Case, cable, warranty | Protection + peace of mind |
| Apparel size selected | Belt, socks, layer piece | Outfit completion |
| Low cart vs free ship threshold | Small add-on, samples | Shipping efficiency |
| New launch in catalog | Trial size + hero SKU | Launch trial bundle |

---

## 2. Discount rationale (not generic)

Prefer **specific** stories:

- "Ship one box" / combined fulfillment
- "First-time bundle" for launch SKUs
- "Routine saver" (step 1 + step 2)
- "Protection pack" (device + case + warranty)
- "Gift-ready" (wrap + card) — seasonal

Avoid empty "10% off" with no reason.

---

## 3. One-click copy patterns

- Button: **Add complete set — save $X** / **Add [Complement] — ships with this order**
- Subline: **Fits the [Main] you chose** / **One tap — no new checkout step**
- Urgency (light): **Adds to this shipment only**

Keep primary CTA under ~6 words when possible.

---

## 4. Checkout bounce "bait"

When bounce is high:

- **Threshold nudge**: item just above gap to free shipping
- **Low decision weight**: sample, sticker pack, mini — low cognitive load
- **Risk reversal**: free returns on add-on only if policy allows

---

## 5. What to avoid

- Substitute of same role as main (unless upsell tier)
- Below-margin doorbusters unless strategic
- Irrelevant category jumps without story


path: scripts/README.md
content: # Scripts

Optional: script to suggest pairs from order history. Not required; document in SKILL.md if added.

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)