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