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.