hktitan/duolingo

duo-gamification

Add Duolingo-style play to any product — XP systems, juicy feedback, leagues, celebration moments, hearts/energy, and the anti-grind discipline that keeps gamification from turning toxic.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/hktitan/duolingo --skill duo-gamification

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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