# Design Minigame

> Design a marketing mini-game / interactive — spin-the-wheel, quiz, scratch-card, playable ad, advent-calendar — for engagement, lead capture, or virality. Produces a game-design spec: the mechanic + win condition, the reward economics, the data-capture value exchange, and the conversion funnel. Honest by construction (no fake-win dark patterns). Not for building the game's code (that's an enginee…

- **Type:** Skill
- **Install:** `agentstack add skill-hungv47-meta-skills-design-minigame`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hungv47](https://agentstack.voostack.com/s/hungv47)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hungv47](https://github.com/hungv47)
- **Source:** https://github.com/hungv47/meta-skills/tree/main/skills/marketing/design-minigame
- **Website:** https://skills.forsvn.com/

## Install

```sh
agentstack add skill-hungv47-meta-skills-design-minigame
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Design Mini-Game — Interactive Spec Builder

3 agents (mechanic-designer → reward-and-funnel → critic) turn a marketing goal into a **playable mini-game spec**: one dead-simple mechanic, sustainable reward economics, an honest value-exchange for the data, and the conversion path out. The spec an engineer or a no-code tool builds from. Method: [`references/agent-manifest.md`](references/agent-manifest.md).

**Core question:** Is it fun in one action, honest in its odds, and does it hand off to a real next step — or is it a dark-pattern email trap?

## Critical Gates — load first

1. **Serves a marketing goal.** Lead capture, engagement, or virality — named, with the metric. A game with no goal is a toy.
2. **One action to fun.** The core loop is one obvious action (spin, pick, scratch). Friction before the first hit of fun kills it.
3. **Honest by construction.** Real odds, real prizes, no fake "you won!" then a paywall. Dark patterns are a hard FAIL (and a legal/brand risk).
4. **Has a funnel.** The game ends in a real next step (claim → email value-exchange → offer), not a dead end or a forced wall.

## Before Starting

Apply [`references/_shared/before-starting-check.md`](references/_shared/before-starting-check.md). Resolve via ≤4 Cold Start questions only what's unstated:

| Dimension | Why |
|---|---|
| Game type + the marketing goal | the mechanic + the success metric |
| The reward/incentive | drives participation + the economics |
| Placement (landing / email / social / event kiosk) | constraints + the funnel target |
| Data capture (email? none?) | the value-exchange + compliance |

Mode per [`references/_shared/mode-resolver.md`](references/_shared/mode-resolver.md). `budget: standard`. `--fast` → mechanic + funnel sketch, skip the deep reward-economics model; **never** skips the honesty check (the safety floor). Per the mode-resolver, `--fast` does drop the critic gate.

## Quality Gate — 5 dimensions

Full rubric: [`references/agent-manifest.md`](references/agent-manifest.md) § Rubric.

- [ ] Goal fit — the mechanic serves the named marketing goal + metric
- [ ] One-action fun — the core loop is instantly playable; minimal pre-fun friction
- [ ] Honest mechanics — real odds, real prizes, no dark patterns
- [ ] Reward economics — the incentive is enticing AND sustainable (cost/redemption modelled)
- [ ] Funnel — a real value-exchange capture + a next step out

Pass ≥35/50 AND no dim 0. FAIL twice → `BLOCKED`.

## Artifact Contract

- **Path:** `docs/forsvn/artifacts/marketing/design-minigame/[game-type]-[YYYY-MM-DD]-[slug].md`. **Lifecycle:** `execution`.
- **Frontmatter (11):** `skill`, `version`, `date`, `stack`, `type`, `id`, `review_surface`, `status`, `game_type`, `capture_mode`, `keywords`.
- **Body:** Concept (game + goal + metric) · Mechanic (the loop · win condition · odds) · Reward economics (prizes · odds · cost model · redemption cap) · Funnel (entry → play → capture value-exchange → next step) · Build notes (states, accessibility, anti-cheat) · Critic verdict. Full contract: [`references/format-conventions.md`](references/format-conventions.md).

## Routing + Dispatch

Sequential graph (mechanic-designer → reward-and-funnel → critic): [`references/agent-manifest.md`](references/agent-manifest.md).

## Chain Position

**Prev:** `plan-campaign` (the campaign the game sits in) OR `create-brand`. **Next:** an engineer / no-code tool builds it; `measure-results` after, on the placement's channel. **Re-run:** new game type, reward change, goal pivot.

**Deference:** building the game's code → engineering (out of this stack's scope); a static ad/asset → `write-ad` / `brief-graphic` / `produce-asset`; the campaign → `plan-campaign`.

## Anti-Patterns

[`references/anti-patterns.md`](references/anti-patterns.md) — 7 patterns (fake-win-dark-pattern, friction-before-fun, broken-prize-economics, no-funnel, gambling-regulation-blind, inaccessible, off-brand). Re-read before ship.

## Durable Rules (protected)

## Completion Status

- **DONE** — mechanic + economics + funnel, honest by construction, critic ≥35.
- **DONE_WITH_CONCERNS** — delivered; critic 25-34 OR an unresolved prize-cost / compliance unknown (flagged).
- **BLOCKED** — critic FAIL twice; dark pattern unremovable; goal undefined.
- **NEEDS_CONTEXT** — no goal or reward; recommend defining the goal + incentive first.

## Worked Example

A spin-the-wheel for a launch email-list (real odds, capped prize budget, email value-exchange, the dark-pattern + prize-economics guards): [`references/examples/minigame-walkthrough.md`](references/examples/minigame-walkthrough.md).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hungv47](https://github.com/hungv47)
- **Source:** [hungv47/meta-skills](https://github.com/hungv47/meta-skills)
- **License:** MIT
- **Homepage:** https://skills.forsvn.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hungv47-meta-skills-design-minigame
- Seller: https://agentstack.voostack.com/s/hungv47
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.