Joke Engineering

Diagnose and improve humor using systems thinking. Use when jokes fall flat, when humor feels forced, when punchlines don't land, or when you want to systematically enhance comedic writing. Treats jokes as engineerable connection systems.

191 stars 24 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jwynia/agent-skills --skill joke-engineering
Manual install
git clone --depth 1 https://github.com/jwynia/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/creative/humor/joke-engineering ~/.claude/skills/joke-engineering

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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 |
Read the full skill on GitHub

Details

Skill name
joke-engineering
Path
skills/creative/humor/joke-engineering/SKILL.md
Repo updated
24 February 2026

FAQ

What does the Joke Engineering skill do?

Diagnose and improve humor using systems thinking. Use when jokes fall flat, when humor feels forced, when punchlines don't land, or when you want to systematically enhance comedic writing. Treats jokes as engineerable connection systems.

How do I install the Joke Engineering skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jwynia/agent-skills --skill joke-engineering. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Joke Engineering popular?

It lives in jwynia/agent-skills, which has 191 GitHub stars and 24 forks.

Related skills

Abstract Strategy

191

jwynia/agent-skills

Design abstract strategy games with perfect information, no randomness, and strategic depth. Use when designing a board game, exploring abstract strategy games, brainstorming game mechanics, or evaluating game balance. Keywords: board game, game design, strategy, mechanics, balance.

Other24

Adaptation Synthesis

191

jwynia/agent-skills

Synthesize new works from extracted functional DNA documents. Use when adapting a source work to a new context, when combining multiple source extractions, or when generating variations that preserve function while changing form.

Other24

Agent Bootstrap

191

jwynia/agent-skills

Bootstrap agentic development environment from agent.toml manifest

AI, LLMs & Agents24

Linkedin Post

150

guia-matthieu/clawfu-skills

Generate high-quality LinkedIn posts for GEO thought leadership. Use when asked to write LinkedIn content, create social media posts, or generate content about SEO/GEO topics.

Writing & ContentIn 1 list32

Humanize

228

pproenca/dot-skills

Remove signs of AI-generated writing from text (formerly human-writing). Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Writing & Content19

Made to Stick

150

guia-matthieu/clawfu-skills

Make your messages unforgettable using the Heath brothers' SUCCESs framework Use when: **Crafting a core message** for a product, campaign, or company that needs to stick; **Presenting complex ideas** to audiences who may forget 90% of what you say; **Writing headlines, taglines, or slogans** that people remember and repeat; **Training or educating** when retention matters more than coverage; **Pitching investors or stakeholders** where one memorable idea beats ten forgettable ones

Writing & ContentIn 1 list32

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.