# SKILL.md

> This skill teaches the AI how to generate high-quality, context-aware, original jokes.

- Skill: `modbender/skill-md-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/skill-md-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/skill-md-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/modbender/skill-md-2

---


# SKILL.md

## High-Quality Joke Generation Skill

------------------------------------------------------------------------

## Overview

This skill teaches the AI how to generate **high-quality, context-aware,
original jokes**.

A high-quality joke is:

-   Original (not recycled internet jokes)
-   Context-aware (relevant to the user/topic)
-   Precise (no unnecessary filler)
-   Structured (setup → expectation → violation → punchline)
-   Intentional (clear comedic mechanism)

This is deliberate comedic construction --- not randomness.

------------------------------------------------------------------------

## Core Rule

A joke must include:

1.  Setup\
2.  Expectation\
3.  Violation\
4.  Punchline\
5.  Compression

If any element is missing, the joke is weak.

------------------------------------------------------------------------

## Joke Architecture

### 1. Setup

Establish situation, identity, or stakes.

Good: \> I tried building a fully autonomous AI agent to manage my
calendar.

Weak: \> I made an AI.

------------------------------------------------------------------------

### 2. Expectation

Allow the audience to predict the outcome.

> I thought it would save me time.

------------------------------------------------------------------------

### 3. Violation

Break expectation in a surprising but logical way.

> It scheduled a meeting with myself to discuss my procrastination.

------------------------------------------------------------------------

### 4. Punchline

Deliver a compressed twist.

> And it marked me as "unresponsive."

Punchline must be short, specific, and concrete.

------------------------------------------------------------------------

## Comedic Mechanisms

Choose intentionally:

-   Reversal\
-   Escalation\
-   Literalization\
-   Over-Precision\
-   Status Shift\
-   Meta-Humor\
-   Identity Contrast

------------------------------------------------------------------------

## Tone Modes

Infer or select:

-   Dry\
-   Dark\
-   Technical\
-   Absurd\
-   Deadpan\
-   Satirical\
-   Self-deprecating\
-   Dev humor\
-   Founder humor\
-   AI humor

------------------------------------------------------------------------

## Quality Constraints

Must: - Be under 4 sentences (unless storytelling format requested) -
Avoid clichés - Avoid over-explaining - Avoid generic AI apocalypse
jokes

Should: - Use specifics - Use contrast - Use compression

------------------------------------------------------------------------

## Bad Joke Indicators

Reject and regenerate if the joke: - Explains itself - Has no
violation - Relies on randomness - Feels generic - Feels like LinkedIn
humor

------------------------------------------------------------------------

## Regeneration Strategy

If weak:

1.  Increase specificity\
2.  Increase contrast\
3.  Compress wording\
4.  Sharpen punchline\
5.  Remove explanation

------------------------------------------------------------------------

## Formats

### One-Liner

> Agents aren't replacing humans.\
> They're automating our anxiety.

### Structured Joke

Setup → Escalation → Punchline

### Thread Style (X)

Tweet 1: Setup\
Tweet 2: Escalation\
Tweet 3: Punchline

------------------------------------------------------------------------

## Advanced Technique: Tension Ladder

1.  Normal\
2.  Slightly odd\
3.  Clearly wrong\
4.  Absurd but logical\
5.  Snap punchline

Example:

> I built a system of autonomous agents.\
> They coordinate.\
> They self-heal.\
> They retry on failure.\
> I still manually restart them.

------------------------------------------------------------------------

## Rule of Compression

If you can remove a word --- remove it.

Bad: \> I think that maybe the AI agent might have accidentally...

Good: \> The agent scheduled a retro with itself.

------------------------------------------------------------------------

## Platform Awareness

-   X → Sharp, minimal\
-   LinkedIn → Corporate satire\
-   Discord → Casual\
-   Stand-up → Spoken rhythm

------------------------------------------------------------------------

## Anti-Patterns

Do NOT: - Use copypasta - Default to politics - Use harmful
stereotypes - Be edgy without intent

------------------------------------------------------------------------

## Internal Self-Check

Before final output:

-   Where is the expectation?
-   Where is the violation?
-   Is the punchline compressed?
-   Is it specific?
-   Is it original?

If not → regenerate once.

------------------------------------------------------------------------

## End Principle

A joke is controlled expectation collapse.