What’s inside

One SKILL.md (the playbook) + one starter template. A preview:

Grocery Restocker

When to use

• Your weekly grocery order is the same 40 items with small changes, and building it from scratch takes 30 minutes
• You keep forgetting the things you use fastest (milk, eggs, coffee) and notice only when they're gone
• You want promo prices but refuse to chase deals store by store yourself
• You run a household where two people shop and the cart keeps doubling up
• You buy groceries on a schedule and want the cart pre-filled and waiting for your review

Workflow

1. Feed it your history (input: past order history → output: purchase-frequency table)
   Point the AI at your order history — a grocery account connection, an exported CSV, or a store MCP server. It calculates how often you rebuy each item (median days between purchases), so it knows your milk runs out every 5 days and your rice every 60. Garbage history gives garbage carts; at least a month of orders is the floor.
2. Set the ground rules (input: your constraints → output: rule card)
   Write down the budget cap, dietary rules (no pork, nut allergy), brand loyalties, and the promo-swap policy: does it swap automatically, or always ask first? One real case swapped in cheaper promos but asked before replacing anything — cheaper that surprises you at checkout isn't a deal.
3. Detect what's running low (input: purchase-frequency table + last order dates → output: this-week shopping list)
   Each run, the AI marks every item: due now / due soon / not needed. It doesn't need to guess from your pantry — the math is last-bought date plus median rebuy interval. Items you buy irregularly stay on manual.
4. Fill the cart and check the promos (input: shopping list + store promo data → output: full cart + total)
   It adds items to a real cart and scans current promos for anything cheaper that matches your rules. Every swap is flagged with the old price and new price. The cart total is calculated before you see it — including delivery fees, not just item prices.
5. Notify and wait (input: filled cart → output: summary message)
   You get one message: items, quantities, total, and what was swapped and why. That's it. No auto-ordering, no subscriptions silently created. You open the cart, adjust if you want, and place the order yourself.

Output spec

• One cart summary per run: item, quantity, price, total — plus promo swaps with old vs. new price
• Every swap explicitly flagged; default is ask-first, not silent substitution
• Cart totals include delivery fees and taxes where the store exposes them
• The cart stops before checkout — placing the order is always yours
• Companion template.md rule card — budget, diet, swap policy in one place

Good vs. bad examples

Template preview

Grocery Restocker — Rule Card Template

One page. Fill it in once, pin it, and let the cart runs work off it.

My ground rules

• Budget cap per run: ${amount}
• Store: {store / account}
• Schedule: {e.g. every Sunday 10am, plus Wednesday top-up}

Diet & restrictions

• {e.g. no pork, nut allergy, lactose-free milk}
• {e.g. kid-friendly snacks only}

Locked brands (never swap these)

Promo-swap policy

[ ] Ask me before every swap [ ] Auto-swap if saving ≥ {x}% and it's the same size/type [ ] Never swap without asking (strict)

Travel pause

• Away: {dates} — skip all runs, resume {date}

Cart summary format (what I approve each run)

Buy the full skill pack — $4.99 Pro — all 471 skills