duo-voice

Stars2

Forks0

UpdatedMay 4, 2026 at 16:55

Write product copy in the Duolingo voice — "wholesome but unhinged," character-driven, screenshot-worthy. Covers push notifications, error states, onboarding, empty states, celebrations, and the now-famous threat-copy that turned a green owl into a meme. Use when the user is writing any user-facing string — notifications, microcopy, errors, marketing — and wants it to feel like a person, not a product. Source the Duolingo Handbook (Make It Fun) and observed blog/marketing patterns.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

HKTITAN

HKTITAN/duolingo

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Writers and AuthorsArts, Design, Entertainment, Sports, and Media Occupations·SOC 27-3043

File Explorer

11 files

SKILL.md

readonly

name	duo-voice
description	Write product copy in the Duolingo voice — "wholesome but unhinged," character-driven, screenshot-worthy. Covers push notifications, error states, onboarding, empty states, celebrations, and the now-famous threat-copy that turned a green owl into a meme. Use when the user is writing any user-facing string — notifications, microcopy, errors, marketing — and wants it to feel like a person, not a product. Source the Duolingo Handbook (Make It Fun) and observed blog/marketing patterns.
license	MIT
metadata	{"author":"HKTITAN","version":"1.0.0","graph":true}

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/screenshot-bait]] — copy written so users want to share it; the cheapest growth channel.

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.

Globalization

[[references/localization-voice]] — keeping unhinged consistent across 40+ languages where the joke doesn't always translate.

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

More from this repository

same repository

duo-culture

HKTITAN/duolingo

Build the team the way Duolingo built theirs — the Green Machine operating model, talent density over headcount, candor protocol ("focus on what, not who"), hire-slow / fire-fast, and the "no process unless it makes decisions better" rule. Use when the user is hiring, defining team rituals, debating remote vs. office, choosing a feedback model, or installing an operating system in a team that has none. Source the Duolingo Handbook (Raise the Bar + Green Machine).

2026-05-042

duo-design

HKTITAN/duolingo

UI patterns from the Duolingo design system — juicy motion, the character system as the emotional channel, design tokens (color/type/spacing), sound as a UX surface, accessibility as a default not a checklist, and "error-as-delight" detailing. Use when the user is designing a screen for a gamified or learning product, reviewing a design for "why does this feel flat," picking a motion system, building a character mascot, or auditing for accessibility. Source the Duolingo design system at design.duolingo.com.

2026-05-042

duo-experimentation

HKTITAN/duolingo

Duolingo-style experimentation as a decision protocol — hundreds of A/B tests a week, opinions resolved by data, ideas killed quickly. Covers hypothesis design, metric selection, guardrails, sample size, novelty effects, and explicit kill criteria. Use when the user wants to run an A/B test, decide between two designs without arguing, set up an experiment program, debug why a test isn't moving, or build a culture where "show don't tell" replaces seniority-based decisions. Source the Duolingo Handbook (Show Don't Tell) and engineering blog posts.

2026-05-042

duo-gamification

HKTITAN/duolingo

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. Use when the user asks how to make a product fun, addictive, or "feel like a game," when designing rewards, levels, or progress, or when an existing system feels like a slot machine and they want it to feel like a craft. Source the Duolingo Handbook (Make It Fun) and the Duolingo design system.

2026-05-042

duo-growth

HKTITAN/duolingo

Duolingo-style growth that doesn't break retention — viral loops, brand-as-acquisition (the TikTok playbook), referral mechanics, localization as a growth lever, and the founder-mode marketing that turned a mascot into a meme. Use when the user is planning acquisition, building a referral system, considering paid vs. organic, evaluating a marketing channel, or trying to turn an existing brand into a growth engine. Source the Duolingo Handbook (Make It Fun) and observed marketing patterns from 2022–2025.

2026-05-042

duo-product

HKTITAN/duolingo

Make product decisions the way Duolingo does — long-view over short-term, ruthless prioritization, ship-and-learn over plan-and-ship, dogfooding, and the "intuitive by default" quality bar. Use when the user is roadmapping, deciding what to cut, debating whether to ship, defining a quality bar for a feature, or trying to install a "product-led" culture in a team that defaults to feature factories. Source the Duolingo Handbook principles 1, 2, and 3 (Take the Long View, Raise the Bar, Ship It).

2026-05-042

name	duo-voice
description	Write product copy in the Duolingo voice — "wholesome but unhinged," character-driven, screenshot-worthy. Covers push notifications, error states, onboarding, empty states, celebrations, and the now-famous threat-copy that turned a green owl into a meme. Use when the user is writing any user-facing string — notifications, microcopy, errors, marketing — and wants it to feel like a person, not a product. Source the Duolingo Handbook (Make It Fun) and observed blog/marketing patterns.
license	MIT
metadata	{"author":"HKTITAN","version":"1.0.0","graph":true}

Duolingo Voice — Map of Content

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/screenshot-bait]] — copy written so users want to share it; the cheapest growth channel.

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.

Globalization

[[references/localization-voice]] — keeping unhinged consistent across 40+ languages where the joke doesn't always translate.

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