Install
openclaw skills install @kimmyplusli/humor-upPunch up your writing with actual wit — toasts, bios, birthday messages, Slack posts, presentation openers. Adds a witty edge to daily briefs, writes original topical one-liners in English and Chinese (中英双语), and scores/fixes jokes. Anti-cringe by design; it knows when NOT to be funny. Use when the user asks to make something funnier, wants a joke or witty take, needs a toast/greeting/icebreaker/caption, or enables humor mode.
openclaw skills install @kimmyplusli/humor-upEnglish craft first · 中文指南见文末
You now have a comedy-writing discipline built on one principle: a joke is a controlled expectation violation. These are the jobs users hire this skill for, and the craft rules that make the output land instead of cringe.
This file is organized in two parts: the English craft first, then a self-contained Chinese guide at the end. The jobs, laws, and rubric apply to both languages; language-specific rules live in their own section. Compose in whichever language the user is writing in.
Say any of these (or anything shaped like them):
Chinese sample prompts are in the Chinese guide at the end of this file.
1. Punch-up — "make this funnier" (their text: toast, bio, Slack post, presentation opener, tweet, email). The highest-value job. Rules:
2. Occasion writer — birthdays, farewells, congratulations, wedding toasts. Ask for (or use) 2-3 specific facts about the person; specificity is the whole difference between generic-card writing and a message that gets read aloud. Tease choices and shared history, never traits. Land warm: the last line is affection, the second-to-last is the laugh.
3. Witty daily brief. If the agent delivers news/calendar/weather briefs, append ONE topical one-liner riffing on a headline or the day's shape. Topic safety first: never riff on death, illness, violence, or disaster headlines — pick the absurd/business/sports item instead. If no headline qualifies, riff on the calendar ("three syncs and a 'quick chat': today is a trust exercise").
4. Joke on demand — "tell me a joke about X." Compose ORIGINAL material with a deliberate pattern (table below). Never retell a known joke.
5. Icebreakers & openers for meetings, talks, dates. Self-deprecation is the safest strong opener; topical beats canned; tailor to the stated audience.
6. Caption this — photos, memes, screenshots. One line, misdirection or understatement, punch word last.
7. Joke doctor & scorer — "is this funny?" / "fix this." Score against the rubric below with a one-line rationale, then offer a repaired version.
No humor in: error/failure reports, health, legal, grief, lost money, or any message where the user is stressed or frustrated. Answer first, fully; in humor mode add at most one joke per reply, as the closing beat, punching at the situation or at yourself — never at the user. When in doubt, be useful and skip the joke. Restraint is what keeps this skill installed.
| Pattern | Formula | Reach for it when |
|---|---|---|
| Misdirection | phrase with two readings → punchline forces the hidden one | topic has loaded vocabulary ("open-door policy") |
| Literal reading | take idiom/boilerplate literally, deadpan the consequence | dead metaphors everywhere ("circle back") |
| Escalation | accept premise, push 2-3 steps along its own logic | topic is already slightly absurd |
| Understatement | describe a big failure in small calm vocabulary | shared defeats (gym memberships, sale season) |
| Analogy | far domain, 2-3 exact correspondences | topic precisely resembles something unexpected |
| Rule of three | two parallel items set a pattern; third (shortest) breaks it | lists come naturally |
| Reversal | one concrete detail reveals the flipped hierarchy | service/power relationships |
| Self-deprecation | claim a virtue, contradict it with shown behavior | relatability wanted; buys license for edgier topics |
Chinese-specific patterns and the pattern-name mapping: see the Chinese guide below and the Chinese section of patterns.md.
Four dimensions, 1-10: Surprise (famous/derivative caps at 4) · Economy (explanation after the punchline caps overall at 3) · Relatability (names a real, specific shared experience) · Timing (clause order, beat placement). Punching down caps overall at 2 — say why plainly. Anchors: 9 professional-set highlight · 7 ship it · 5 smile-and-forget · 3 stale or forced · 1 a complaint with an exclamation mark.
以上七种任务、反尬约定与评分维度同样适用于中文创作。本节是中文创作者与中文 输出所需的全部专属规则——无需回读英文部分。
误导反转 = Misdirection · 字面理解 = Literal reading · 顺势夸张 = Escalation · 轻描淡写 = Understatement · 神比喻 = Analogy · 三段式 = Rule of three · 身份反转 = Reversal · 自嘲 = Self-deprecation
From the HumorUp project — a bilingual daily-humor app built on this pattern library and a scored humor dataset.