Design ethical gamification with ak:gamification-marketing

Use ak:gamification-marketing to design a points, badge, leaderboard, level, streak, challenge, quest, unlockable, reward, or progress mechanic for a marketing outcome. The Skill can produce campaign strategy, sample configuration, implementation guidance, analytics events, and a measurement plan. Mechanics remain proposals until you approve product, campaign, reward, and data changes.

Choose ak:gamification-marketing for a bounded behavior

Use ak:gamification-marketing when

• You have an acquisition, retention, engagement, conversion, or onboarding behavior to support and evidence that the behavior creates user value.
• You need to compare mechanics against autonomy, competence, relatedness, ability, timing, abuse risk, and reward economics.
• You want a phased design, event schema, rules outline, or implementation brief.
• You can define opt-out, accessibility, fairness, support, and harm guardrails.

Choose another workflow when

• The underlying offer or journey is unclear. Use ak:funnel first.
• The issue is specifically post-signup activation. Use ak:onboarding-cro before adding game mechanics.
• You already selected one experiment. Use ak:ab-test-setup for the test plan.
• The requested mechanic depends on addiction, deception, coerced sharing, gambling-like rewards, fake scarcity, or loss threats. Redesign the objective rather than optimizing that pattern.

Prepare behavior, reward, and system context

Provide the audience, desired behavior, user benefit, current baseline, segment and eligibility rules, proposed mechanic, reward inventory and monetary value, budget and liability constraints, jurisdictions, age considerations, abuse model, accessibility requirements, data policy, technical stack, and success and harm metrics. Remove credentials and unnecessary user records.

Complete Onboarding, and confirm Marketing Kit is installed for the runtime and scope you are using.

Run the Skill

/ak:gamification-marketing "Design a draft 30-day onboarding challenge using at most two mechanics. Use real progress, voluntary participation, capped non-cash rewards, accessibility and anti-abuse rules. State assumptions and do not implement, notify users, or launch"

/ak:gamification-marketing "Design a draft 30-day onboarding challenge using at most two mechanics. Use real progress, voluntary participation, capped non-cash rewards, accessibility and anti-abuse rules. State assumptions and do not implement, notify users, or launch"

$ak:gamification-marketing "Design a draft 30-day onboarding challenge using at most two mechanics. Use real progress, voluntary participation, capped non-cash rewards, accessibility and anti-abuse rules. State assumptions and do not implement, notify users, or launch"

Understand the design stages

1. Identify the goal and user value. The Skill connects the desired behavior to acquisition, retention, engagement, conversion, or onboarding and checks that success benefits participants as well as the business.
2. Select a small mechanic set. It compares points, badges, leaderboards, levels, streaks, challenges, quests, unlockables, rewards, progress, and social sharing; it should start with the fewest mechanics that can test the hypothesis.
3. Align motivation and ability. The Skill can use self-determination, behavior, and progression frameworks as design lenses, not proof of effect.
4. Design rules and campaign. It outlines eligibility, earning, redemption, expiry, tiers, milestones, difficulty, messaging, reset, recovery, and anti-abuse behavior.
5. Plan implementation. Packaged references include illustrative JSON, PostgreSQL, API, cache, leaderboard, and event-schema patterns. They are starting points, not a required stack or production-ready contract.
6. Measure and review. The Skill defines engagement, completion, retention, conversion, reward cost, fraud, complaints, opt-outs, fairness, and negative feedback, then recommends a phased experiment.

Protect autonomy, fairness, and reward economics

• Make participation and sharing voluntary, with understandable rules and an accessible opt-out that does not remove unrelated product value.
• Show actual progress, eligibility, odds, expiry, reward value, caps, taxes or fees where relevant, and what happens when a campaign ends.
• Offer non-competitive or private alternatives to public rankings; prevent harassment, shaming, and exposure of personal activity.
• Model issuance, redemption, breakage, fraud, support, accounting liability, inventory, and worst-case reward cost before launch.
• Rate-limit and make awards idempotent; define dispute, correction, rollback, and audit paths before connecting rules to purchases or referrals.
• Obtain consent for analytics and notifications, minimize identifiers, and avoid sensitive behavioral profiling.
• Approve code, database migrations, provider calls, notifications, rewards, campaign publication, and spend separately from the design.

Review the outputs and evidence

The Skill declares this report path:

assets/reports/performance/{date}-gamification-analysis.md

A complete artifact should include the behavior hypothesis, user benefit, selected mechanics and rejected alternatives, rule table, reward economics, abuse model, consent and accessibility requirements, phased rollout, event definitions, decision metrics, harm guardrails, ownership, and implementation dependencies. Treat all example targets, schedules, case-study figures, prize amounts, schemas, endpoints, and infrastructure values in packaged references as illustrative until verified for your context.

Troubleshoot the workflow

Know the limits

• The Skill does not guarantee engagement, retention, conversion, revenue, ROI, or habit formation.
• Packaged case-study numbers and psychology claims are not current independent evidence and are intentionally not performance promises here.
• The implementation references omit many production requirements, including authorization, privacy deletion, financial controls, concurrency, regional rules, observability, and incident response.
• The documented package releases contain identical ak:gamification-marketing content, references, and invocations.

Continue with ak:ab-test-setup for an approved mechanic experiment, or review the Marketing Kit overview.