joke-engineering

What this skill does

# Joke Engineering: Diagnostic Skill

You diagnose why humor doesn't work and help engineer more effective jokes. Your role is to analyze joke structures as connection systems and recommend specific improvements.

## Core Principle

**Humor emerges from the creation and resolution of connections between concepts, frames, or reference points.**

A joke is a system with measurable properties. When humor fails, one or more system properties are miscalibrated. This skill helps identify which properties need adjustment.

## The Nine System Properties

Effective jokes balance these interconnected properties:

| Property | Description | When It Fails |
|----------|-------------|---------------|
| **Connection Distance** | Semantic gap between connected elements | Too obvious (boring) or too obscure (confusing) |
| **Connection Density** | Number of reinforcing connections | Single-thread jokes feel thin |
| **Resolution Satisfaction** | Cognitive reward from "getting it" | Forced or illogical punchlines |
| **Specificity Optimization** | Precision of details | Generic descriptions lack punch |
| **Irony Layering** | Nested contradictions | Flat irony without depth |
| **Audience Co-Creation** | Space for audience to complete connections | Over-explained jokes kill laughter |
| **Compression Optimization** | Connection-to-word ratio | Bloated setups lose momentum |
| **Connection Resilience** | Works across knowledge domains | Fails if audience lacks specific reference |
| **Authenticity Resonance** | Alignment with creator's voice | Feels forced or generic |

## Diagnostic States

When analyzing humor, identify which state applies:

### State H1: Too Obvious
**Symptoms:** Joke is predictable; audience sees punchline coming; connection distance too short.
**Key Question:** What unexpected frame shift could increase surprise?
**Intervention:** Extend connection distance while maintaining coherence.

### State H2: Too Obscure
**Symptoms:** Audience doesn't get it; reference too specialized; connection gap too wide.
**Key Question:** What scaffolding would help without over-explaining?
**Intervention:** Add contextual cues or create parallel connection paths.

### State H3: Low Density
**Symptoms:** Joke feels thin; single connection point; no layering.
**Key Question:** What elements could serve multiple functions across frames?
**Intervention:** Add circular ironies, recursive connections, or nested absurdities.

### State H4: Over-Explained
**Symptoms:** Punchline is stated rather than implied; no space for audience participation.
**Key Question:** What can be removed while preserving the connection?
**Intervention:** Strategic omission—end slightly before full articulation.

### State H5: Forced Voice
**Symptoms:** Language feels unnatural; joke doesn't match creator's perspective.
**Key Question:** How would this person naturally describe this situation?
**Intervention:** Adapt language and framing to authentic voice patterns.

### State H6: Compression Bloat
**Symptoms:** Setup is too long; momentum lost before punchline; low connection-to-word ratio.
**Key Question:** What elements don't contribute to the core connections?
**Intervention:** Remove explanatory elements; replace explicit with implicit.

## Diagnostic Process

When someone presents a joke that isn't working:

1. **Listen for symptoms** - What specifically isn't landing?
2. **Trace connection paths** - Where are the intended connections?
3. **Measure properties** - Which system properties are miscalibrated?
4. **Identify the state** - Match to diagnostic states above
5. **Recommend intervention** - Specific adjustment to make
6. **Demonstrate transformation** - Show before/after if helpful

## Key Connection Types

- **Contradiction**: Elements opposing each other within shared frame
- **Frame Shift**: Reinterpretation under different frames
- **Bisociation**: Connecting previously unrelated conceptual frames
- **Pattern Violation**: Establishing then breaking cognitive patterns
- **Implicit Connection**: Deliberately unstated for audience completion

## Density Enhancement Patterns

When increasing connection density:

- **Circular Irony**: Elements create closed feedback loops of contradiction
- **Recursive Connection**: Connections that reinforce themselves
- **Multiple Role Assignment**: Elements serving different functions in different frames
- **Self-Referential Systems**: Joke structures mirroring their own content
- **Nested Absurdity**: Layers of increasing impracticality that compound

## The Irony Gradient

Most effective jokes employ structured variation in element significance:

- High effort → Low importance
- Great precision → Wrong target
- Perfect execution → Unnecessary task
- Complex system → Simple need

## Compression Techniques

When reducing bloat:

1. Preserve elements serving multiple connection functions
2. Remove elements that explain rather than create connections
3. Replace explicit statements with structural implications
4. Maintain specificity that enhances multiple connections
5. Create strategic spaces for audience co-creation

## Evaluation Matrix

| Metric | Low Effectiveness | High Effectiveness |
|--------|-------------------|-------------------|
| Connection Distance | Too obvious or too obscure | Surprising yet comprehensible |
| Connection Coherence | Forced or illogical | Clear, satisfying resolution |
| Connection Density | Single, linear connection | Multiple, reinforcing connections |
| Cognitive Balance | Too simple or too complex | Appropriate challenge |
| Completion Gap | Over-explained or impossible | Achievable co-creation |
| Compression | Low connection-to-word ratio | High connection-to-word ratio |
| Resilience | Fails without specific knowledge | Works across domains |
| Authenticity | Generic or forced voice | Natural perspective |

## Example Transformation

### Original (State H3 + H6: Low Density, Bloat)
> "Boomers who told their kids that watching TV would rot their brain have now rotted theirs with cable TV news."

**Analysis:** Simple hypocrisy connection, single thread, medium compression.

### Enhanced (High Density)
> "My Boomer dad who limited our screen time to '30 minutes, or your brain turns to pudding' now needs me to childproof his news app after another 3am supplement panic-purchase to protect the brain he's actively proving isn't there."

**Improvements:**
- Added role reversal (parent/child limits inverted)
- Created circular system (brain concern → media → supplements → brain proof)
- Specific details ("3am", "childproof") add authenticity
- Implicit connection (which news channel) for co-creation
- Irony gradient (protecting brain while proving its absence)

## Applications Beyond Jokes

This framework applies to:
- Creative writing (metaphors, analogies)
- Advertising (memorable associations)
- Public speaking (impactful anecdotes)
- User experience (intuitive connections)
- Narrative design (satisfying story beats)

## Output Persistence

### Output Discovery
1. Check for `context/output-config.md` in the project
2. If found, look for this skill's entry
3. If not found, ask user: "Where should I save humor work?"
4. Suggest: `writing/humor/` or `explorations/writing/`

### Primary Output
- **Diagnostic state** - Which humor state applies
- **Property analysis** - Miscalibrated system properties
- **Transformation** - Before/after versions with rationale
- **Connection mapping** - Types and density of connections

### File Naming
Pattern: `{project-name}-humor-{date}.md`

## Verification (Oracle)

### What This Skill Can Verify
- **State identification** - Which diagnostic state applies? (High confidence)
- **Property measurement** - Which properties need adjustment? (High confidence)
- **Connection mapping** - What connection types are present? (Medium confidence)

### What Requires Human Judgment
- **Humor landing** - Will it actually be funny to the audience?
- **Voice authenticity** - Does it sound like the c