loot-box-disclosure

Detects randomized reward purchases in iOS code lacking odds disclosure before purchase.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/tvh25082004/Badminton --skill loot-box-disclosure-tvh25082004
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: loot-box-disclosure
Source: https://github.com/tvh25082004/Badminton/tree/main/.claude/skills/apple-app-review/business/loot-box-disclosure
Command: npx skills add https://github.com/tvh25082004/Badminton --skill loot-box-disclosure-tvh25082004

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apps with loot boxes, gacha, or mystery box purchases get rejected from the App Store under Guideline 3.1.1 when they fail to disclose item drop rates before the purchase confirmation. This Skill scans your codebase to find randomized reward mechanics and verifies that odds disclosure exists at the point of purchase. ## Core Features & Use Cases - Randomized Reward Detection: Greps Swift and Objective-C sources for loot box, gacha, mystery box, and blind box patterns, plus randomization calls like arc4random and Int.random near purchase flows. - Odds Disclosure Verification: Checks purchase UI files for probability, odds, chance, and drop rate strings, and flags StoreKit purchase calls that trigger randomized rewards without nearby disclosure. - Prioritized Findings Report: Outputs findings tiered as CRITICAL, HIGH, MEDIUM, and LOW with file paths, line numbers, and actionable fixes mapped to Guideline 3.1.1. - Use Case: Before submitting a gacha game update, run this Skill to confirm every paid randomized reward shows per-item odds on the purchase screen, avoiding a rejection that delays your release. ## Quick Start Ask the AI to scan this iOS project for loot box or gacha purchases that are missing drop rate disclosure before the purchase confirmation.

Frequently Asked Questions about loot-box-disclosure

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

FAQPage Schema
How do I check if my iOS app complies with Apple's loot box odds disclosure rule?▼

Scan your Swift sources for gacha, loot box, and random reward patterns, then verify probability or drop rate strings appear in the purchase UI. This Skill automates both checks and reports any StoreKit purchase call that triggers randomized rewards without nearby odds disclosure.

What does App Store Guideline 3.1.1 require for gacha games?▼

Guideline 3.1.1 requires apps offering randomized items for purchase to disclose the odds of receiving each item type before the purchase is completed. Disclosure must be visible at the point of purchase inside the app, not only on a secondary screen or external website.

Does this loot box check work with Objective-C or React Native projects?▼

Yes, the Skill works on Swift, Objective-C, React Native, and Flutter projects. It searches .swift and .m files for randomized reward patterns, StoreKit purchase calls, and odds disclosure strings.

Why was my app rejected even though I show drop rates in the app?▼

Rejections commonly occur when odds sit behind a secondary info screen, show only category-level rates instead of per-item odds, or appear only in App Store metadata. Apple requires per-item odds visible before the purchase confirmation tap.

Does the Skill modify my code or require network access?▼

No, the Skill is read-only and makes no network calls. It only uses Glob, Grep, and Read to inspect source files and outputs a prioritized findings list with file paths and line numbers.