mcpField
D
duo-gamification

duo-gamification

github.com/hktitanDesign & UI671 installsUpdated 5w ago
Repository

About duo-gamification

A reference skill for product designers studying Duolingo’s gamification patterns. It organizes guidance on feedback, progression, constraints, social mechanics, and anti-grind design as linked topics.

Key features

  1. 01Linked reference graph
  2. 02Feedback and celebrations
  3. 03Progression and difficulty
  4. 04Constraints and power-ups
  5. 05Social pairing and anti-grind

Use cases

  1. 01Reviewing feedback mechanics
  2. 02Planning progression systems
  3. 03Assessing gamification constraints

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hktitan/duolingo --skill duo-gamification

After installing, type/duo-gamificationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
anti-grind.md
beat-your-own-best.md
celebration-artifacts.md
celebration-moments.md
character-reactions.md
co-op-pairing.md
combo-multipliers.md
hearts-and-energy.md
juicy-feedback.md
nested-deadlines.md
power-ups.md
progression-design.md
ramp-up-difficulty.md
rate-by-opponent-strength.md
self-imposed-stakes.md
two-regimes-of-one-counter.md
xp-system.md

Details

From the project README

Duolingo Gamification — Map of Content

Duolingo's Make It Fun principle isn't a sprinkle of rewards on top of a serious product. It's the load-bearing decision: a low-motivation activity (studying) was wrapped in mechanics borrowed from games until learners showed up daily without willpower.

This skill is structured as a graph: scan the descriptions below, follow only the [[wikilinks]] you need.

Feedback layer (where "juicy" lives)

  • [[references/juicy-feedback]] — the bouncy, sound-rich response to every correct answer that turns a checkbox into a moment.
  • [[references/celebration-moments]] — bigger payoffs at session/level/streak boundaries; how often, how loud, how to keep them surprising.
  • [[references/character-reactions]] — Duo, Lily, Eddy: characters as the emotional channel for feedback.
  • [[references/celebration-artifacts]] — milestone rewards the user can print, wear, bake or post, instead of a badge that dies in the app.

Progression layer

  • [[references/xp-system]] — the abstract currency that lets every action contribute to a single forward-motion metric.
  • [[references/progression-design]] — units, sections, paths: how the visible structure of progress shapes effort.
  • [[references/ramp-up-difficulty]] — flow-state pacing: never too easy, never a wall.
  • [[references/two-regimes-of-one-counter]] — one accumulating counter motivates by momentum early and by protected value late; tune for both.
  • [[references/nested-deadlines]] — short horizons inside long ones, so a near-term checkpoint is always live.
  • [[references/beat-your-own-best]] — personal records alongside fixed thresholds, and status placed where other people see it.
  • [[references/rate-by-opponent-strength]] — score the difficulty of what was beaten, not the win count, and ship the caveat that ratings lag real progress.

Constraint layer (where "fun" gets serious)

  • [[references/hearts-and-energy]] — capped attempts as a forcing function for engagement and a monetization lever.
  • [[references/power-ups]] — purchasable or earned consumables that tilt the difficulty curve.
  • [[references/combo-multipliers]] — within-session momentum rewards.
  • [[references/self-imposed-stakes]] — let users voluntarily raise their own stakes, so the constraint is theirs rather than yours.

Social layer

  • [[references/co-op-pairing]] — shared goals between two users, and why partner selection has to filter on recent activity.

Anti-patterns

  • [[references/anti-grind]] — when gamification curdles: the difference between "I want to come back" and "I owe the app a visit."

Sibling skills

  • [[../duo-retention/SKILL]] — gamification's job is retention; the loops live there.
  • [[../duo-design/SKILL]] — the visual and motion implementation of every node in this skill.
  • [[../duo-voice/SKILL]] — celebrations and reactions are also a copy problem; characters need lines.
  • [[../duo-experimentation/SKILL]] — gamification is the most over-tested area in product; every value (XP per lesson, league size, heart cost) is dialled by experiment.

Sources

  • Duolingo Handbook (2025), Principle #5: Make It Fun
  • blog.duolingo.com design and engineering posts — character system, motion, sound
  • blog.duolingo.com — gamification and game-design posts

Comments

Markdown supported