--- name: dealcraft description: Put a DealCraft promotion game on a website and take its reward codes at checkout. Use when a task mentions DealCraft, dealcraft.io, a spin-to-win/scratch-card/mystery-box promotion, a `pk_live_`/`sk_live_` DealCraft key, `w.js`, or redeeming a DealCraft reward code. --- # Integrating DealCraft DealCraft attaches a chance-based game (wheel, scratch card, mystery box) to a shop. The server decides every outcome before any animation runs, against a win rate and hard spending caps the shop set. A winner walks away with a reward code the shop's checkout can take. Canonical copy of this file: `https://dealcraft.io/agents/dealcraft/SKILL.md` Full contract: `https://dealcraft.io/agents/dealcraft/API.md` ## Install this guide - **Claude Code** — `mkdir -p .claude/skills/dealcraft && curl -fsSL https://dealcraft.io/agents/dealcraft/SKILL.md -o .claude/skills/dealcraft/SKILL.md` - **Codex / Cursor / any agent that reads AGENTS.md** — `curl -fsSL https://dealcraft.io/agents/dealcraft/SKILL.md >> AGENTS.md` - **Anything else** — fetch the URL and put it wherever that tool keeps project instructions. ## Before writing any code, settle three things 1. **Which keys exist.** The shop creates them on the DealCraft dashboard under *Integrations*. A `pk_live_…` public key belongs in a page. An `sk_live_…` / `sk_test_…` secret key belongs on a server and nowhere else. If the task has no keys yet, stop and ask for them — do not invent placeholders that ship. 2. **Which delivery mode the shop wants.** Ask if it is not stated. 3. **Whether the checkout has to take reward codes.** If yes, that is a separate server-side integration; read *Take a code at checkout* below and do it properly. | Mode | For | What you write | |---|---|---| | Public link or QR | A shop with no site | Nothing. The dashboard issues the link | | Website pop-up | A shop with a site | One script tag | | Inline iframe | The game sitting inside a page | One iframe | | API | A team with its own backend and accounts | Two HTTP calls | ## Website pop-up ### Plain HTML, Shopify, Wix, WordPress Paste once, before the closing `` tag (Shopify: `theme.liquid`; Wix: Settings → Custom code → body end; WordPress: a header-and-footer scripts plugin). ```html ``` ### Next.js (App Router) **A plain `