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.
Install
npx skills add jwynia/agent-skills --skill joke-engineeringgit 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-engineeringPersonal 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 |
Details
- Skill name
joke-engineering- Repository
- jwynia/agent-skills
- 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
191jwynia/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.
Adaptation Synthesis
191jwynia/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.
Agent Bootstrap
191jwynia/agent-skills
Bootstrap agentic development environment from agent.toml manifest
Linkedin Post
150guia-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.
Humanize
228pproenca/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.
Made to Stick
150guia-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
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.