variable-rewards

Generates weighted variable rewards with SwiftData-backed claim history and caps for apps.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/jtvaris/sunday-night-dynasty --skill variable-rewards-jtvaris
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: variable-rewards
Source: https://github.com/jtvaris/sunday-night-dynasty/tree/main/.agents/skills/generators/variable-rewards
Command: npx skills add https://github.com/jtvaris/sunday-night-dynasty --skill variable-rewards-jtvaris

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Variable rewards systems help product teams increase user engagement by providing randomized rewards while enforcing ethical caps and transparency, reducing gamification fatigue.

Core Features & Use Cases

  • Weighted reward pool with selectable rarities (common, uncommon, rare, epic) to deliver varied outcomes.
  • Daily spins and mystery boxes with daily/weekly caps, deterministic testing options, and clean history tracking.
  • Transparent reward probabilities and a SwiftData-backed claim history for auditing and analytics.

Quick Start

Initialize the RewardManager and perform a daily-spin to grant the first reward.

Frequently Asked Questions about variable-rewards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement ethical gamification with daily spins and mystery boxes in Swift?

Ethical gamification in Swift involves generating randomized outcomes from a weighted rarity pool while enforcing daily and weekly caps. This approach provides transparent reward probabilities and tracks claim history to reduce gamification fatigue.

What is a weighted reward pool and how does it work for app retention?

A weighted reward pool assigns selectable rarities like common, uncommon, rare, and epic to deliver varied outcomes. It drives app retention by randomizing bonuses while maintaining transparent probabilities and strict claim limits.

Can I track daily spin history using SwiftData for auditing?

Yes, SwiftData can back the claim history for daily spins and mystery boxes. This enables transparent auditing and analytics of user rewards, ensuring the system respects daily and weekly caps accurately.

Does this variable rewards system support deterministic testing options?

Yes, the variable rewards system includes deterministic testing options. This allows developers to verify daily spins, mystery boxes, and reward pool rarities reliably during development without relying on random outcomes.

Why should I enforce daily and weekly caps on random bonuses?

Enforcing daily and weekly caps on random bonuses prevents gamification fatigue and ensures ethical engagement. By limiting mystery box claims and daily spins, apps maintain transparent probabilities and sustainable user retention.