Joke Engineering

Treats jokes as engineerable systems with nine measurable properties like connection distance, density, and compression ratio. You feed it a flat joke and it diagnoses why it's not landing (too obvious, too obscure, over-explained) then shows you specific fixes. The framework is surprisingly transferable once you internalize it. Comes with a detailed diagnostic state machine (H1 through H6) and before/after examples showing how to layer multiple ironies or tighten bloated setups. More systems thinking than comedy theory, which either clicks with how your brain works or feels unnecessarily analytical about something intuitive. Worth trying if you write humor regularly and want vocabulary for why punchlines succeed or fail.

skills.sh installs: 727
GitHub stars: 182
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jwynia/agent-skills --skill joke-engineering --agent claude-code

Installs into .claude/skills of the current project.

Files

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.