Gamification

MyClaude awards XP for 8 actions, tracks 45 achievements across 9 categories, and assigns ranks from Newcomer to Legend based on a square-root level curve. Every number on this page is pulled directly from the production codebase.

How does the XP system work?

You earn XP by taking actions on the marketplace. Each action has a fixed XP reward.

Publishing and selling are weighted highest because they create the most marketplace value. Passive actions (downloads, likes) earn less but accumulate over time.

How is XP deduplicated?

Every XP award is logged to a xp_logs/{uid}_{action}_{key} document in Firestore. The deduplication key is either the specific product ID or a 1-minute time window (floor of Date.now() / 60000). If a log entry already exists for that combination, no XP is awarded.

This prevents farming. You cannot earn download XP twice for the same product from the same user, and generic actions are rate-limited to once per minute.

How does the level curve work?

Levels follow a square-root curve:

level = floor(sqrt(xp / 100))

To find the XP required for any level: xp = level^2 * 100.

The curve is deliberately steep. Reaching Diamond (L10) requires 10,000 XP. Reaching Legend (L20) requires 40,000 XP -- four times as much. This ensures high ranks represent sustained contribution, not a single viral product.

What are the 8 ranks?

Each rank corresponds to a minimum level and has a distinct visual presentation.

Ranks from Platinum onward receive a glow effect on their profile badge. Your rank updates automatically when your level crosses a threshold -- there is no manual promotion.

What achievements exist?

MyClaude tracks 45 achievements across 9 categories. Each achievement has a tier (bronze, silver, gold, or diamond) that determines its visual treatment.

Publishing (5 achievements)

Downloads (5 achievements)

Followers (5 achievements)

Likes (4 achievements)

Revenue and sales (5 achievements)

Reviews (3 achievements)

Rank milestones (8 achievements)

The Immortal achievement sits beyond the named rank system. Level 30 requires 90,000 XP -- this is a long-term goal for the most active creators on the platform.

Special and social (3 achievements)

Category masters (7 achievements)

Category masters reward depth in a single product type. Each requires 5 published products in that category.

All category master achievements are gold tier. There are no category masters for claude-md or systems categories.

How does the rankings page work?

The /rankings page shows a leaderboard sorted by XP. Each entry displays the user's rank badge, level, total XP, and achievement count. Rankings are computed client-side from Firestore queries ordered by the xp field.

The leaderboard is public. Anyone can see it without authentication. Profile links from the leaderboard go to the user's public profile page at /u/{username}.

How are XP and achievements verified?

XP increments are written to the user's Firestore document using FieldValue.increment(), which is atomic. Firestore security rules restrict users to incrementing only their own XP field.

Achievements are checked by checkAndUnlockAchievements(), which reads the user's profile stats and evaluates each achievement's condition function. If a condition is met and the achievement hasn't been unlocked yet, a document is written to the users/{uid}/achievements/{achievementId} subcollection. The write uses setDoc with merge: true, making it idempotent even if two calls race past the existence check.

Achievement tier distribution

The distribution skews toward gold and diamond because most categories have high-tier milestones. Bronze and silver achievements serve as early engagement hooks.

Related pages

• Pricing and Revenue -- the 92/8 creator/platform split
• Concepts Overview -- marketplace mental model
• Rankings -- live leaderboard