SuperAPI AI Directory

duo-voice

Writing & research

View repository

Updated 10-15 22:13

About this skill

Duolingo Voice — Map of Content

Duolingo's brand voice is the most copyable competitive advantage in modern consumer software: the rules are public, the examples are everywhere, and the upside is enormous (free distribution from screenshots). The handbook describes it as "wholesome but unhinged" — the friction between those two words is the whole job.

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

Foundation

  • [[references/wholesome-unhinged]] — the two-word brand brief and how to operationalize it.
  • [[references/character-archetypes]] — Duo, Lily, Zari, Eddy and what each one is allowed to say.
  • [[references/persona-as-generator]] — define a persona as a desire blocked by an obstacle, and write far more biography than you will ever show.
  • [[references/screenshot-bait]] — copy written so users want to share it; the cheapest growth channel.
  • [[references/in-group-vocabulary]] — why borrowing a community's words ends their usefulness, and when a brand still has standing to use them.

Surfaces (one node per copy surface)

  • [[references/push-notification-copy]] — the highest-leverage surface; the "Duo is watching you" template and what makes it work.
  • [[references/error-copy]] — wrong answers, network failures, validation errors as moments of brand instead of friction.
  • [[references/onboarding-copy]] — the first three screens that decide retention; how Duolingo makes them feel like meeting a person.
  • [[references/empty-states]] — the loneliest screens; how to fill them with character.
  • [[references/celebration-copy]] — what to say when something good happens, without sounding corporate.
  • [[references/threat-copy]] — the deliberately-funny menace that turned an owl into a meme.

Failure and framing

  • [[references/no-fault-phrasing]] — write the bad outcome as something that happened to the user, not something they caused.
  • [[references/staff-failure-stories]] — your most credentialed people publishing their own mistakes is the strongest permission structure you have.
  • [[references/unmarked-framing]] — to make something ordinary, depict it without comment and describe differences symmetrically.

Content at volume

  • [[references/recurring-cast-in-content]] — a rigid template, a fixed named cast, and one running example turn commodity content into brand.

Globalization

  • [[references/localization-voice]] — keeping unhinged consistent across 40+ languages where the joke doesn't always translate.
  • [[references/one-name-per-entity]] — proper names stay identical in every locale, because shared references are what let user culture compound.

Sibling skills

  • [[../duo-retention/SKILL]] — the highest-leverage voice surface (push notifications) is a retention tool; designs interlock.
  • [[../duo-gamification/SKILL]] — celebrations and threats are voice + gamification at the same time.
  • [[../duo-growth/SKILL]] — voice is growth: the social TikTok voice and the in-app voice are the same character.

Sources

  • Duolingo Handbook (2025), Principle #5: Make It Fun
  • @duolingo on TikTok / Instagram / Twitter — observed brand voice
  • blog.duolingo.com — voice and marketing posts