HybridAIOne Meme Generation
Generate actual meme images from a topic. Pick a template, write captions, and render a real image file with text overlay.
When to Use
- User asks you to make or generate a meme
- User wants a meme about a specific topic, situation, or frustration
- User says "meme this" or similar
Available Templates
The script supports:
- curated classic templates backed by image URLs
- dynamic imgflip templates by name or ID
- custom images with optional top and bottom bars
Curated templates are grouped into packs and can be filtered with --pack.
Source strategy:
- Curated templates use meme-platform image URLs.
- Dynamic templates come from the imgflip API.
Curated Templates
| ID | Name | Fields | Best for |
|---|---|---|---|
this-is-fine |
This is Fine | top, bottom | chaos, denial |
drake |
Drake Hotline Bling | reject, approve | rejecting or preferring |
distracted-boyfriend |
Distracted Boyfriend | distraction, current, person | temptation, shifting priorities |
two-buttons |
Two Buttons | left, right, person | impossible choice |
expanding-brain |
Expanding Brain | 4 levels | escalating irony |
change-my-mind |
Change My Mind | statement | hot takes |
woman-yelling-at-cat |
Woman Yelling at Cat | woman, cat | arguments |
one-does-not-simply |
One Does Not Simply | top, bottom | deceptively hard things |
grus-plan |
Gru's Plan | step1-3, realization | plans that backfire |
batman-slapping-robin |
Batman Slapping Robin | robin, batman | shutting down bad ideas |
Dynamic Templates
Any template not in the curated list can still be used by name or imgflip ID. Curated search is metadata-aware and matches ids, aliases, tags, people, and pack names.
Examples:
python3 scripts/generate_meme.py --search "disaster"
python3 scripts/generate_meme.py --search "drake" --curated-only
python3 scripts/generate_meme.py --list --pack classic
python3 scripts/generate_meme.py --list --pack classic --show-source
python3 scripts/generate_meme.py --info drake
Procedure
Mode 1: Classic Template
- Read the user's topic and identify the core meme structure: chaos, dilemma, preference, irony, or backfire.
- Pick the template that best matches. Use the curated table above or search with
--search. - Write short captions for each field. Prefer 8 to 12 words maximum per field.
- Run the generator and write the output into the current workspace so HybridClaw can return it as an artifact:
python3 scripts/generate_meme.py <template_id> ./meme.png "caption 1" "caption 2" - Return the generated image artifact.
For curated template discovery:
python3 scripts/generate_meme.py --list --pack classic
python3 scripts/generate_meme.py --search "boyfriend" --curated-only
python3 scripts/generate_meme.py --info this-is-fine
Mode 2: Custom Image
Use this when no classic template fits, or when the user wants something original.
- Write the captions first.
- Generate or locate the source image.
- Run the script with
--imageto overlay text:- Overlay mode:
python3 scripts/generate_meme.py --image /path/to/scene.png ./meme.png "top text" "bottom text" - Bar mode:
python3 scripts/generate_meme.py --image /path/to/scene.png --bars ./meme.png "top text" "bottom text"
- Overlay mode:
- Use
--barswhen the image is visually busy and direct overlay would hurt readability. - Return the generated image artifact.
Examples
"debugging production at 2 AM":
python3 scripts/generate_meme.py this-is-fine ./meme.png "SERVERS ARE ON FIRE" "This is fine"
"choosing between sleep and one more episode":
python3 scripts/generate_meme.py drake ./meme.png "Getting 8 hours of sleep" "One more episode at 3 AM"
"the stages of a Monday morning":
python3 scripts/generate_meme.py expanding-brain ./meme.png "Setting an alarm" "Setting 5 alarms" "Sleeping through all alarms" "Working from bed"
"everyone wants the repo moved":
python3 scripts/generate_meme.py drake ./meme.png "Leaving the repo where it is" "Let's move the repository"
Listing Templates
To see the curated templates:
python3 scripts/generate_meme.py --list
python3 scripts/generate_meme.py --list --pack classic
python3 scripts/generate_meme.py --list --pack classic --show-source
Pitfalls
- Keep captions short. Long meme text usually looks bad.
- Match the number of text arguments to the template's field count.
- Pick the template that fits the joke structure, not just the topic.
- Do not generate hateful, abusive, or personally targeted content.
- Do not use the skill to target a real private individual. For public figures or celebrities, avoid harassment, defamation, or demeaning personal attacks.
- Template downloads and imgflip API data are cached in a per-user temp cache directory.
- Write output files into the current workspace, not
/tmp, when you want HybridClaw to return the image automatically.
Verification
The output is correct if:
- An image file was created at the output path
- Text is legible on the template or custom image
- The joke structure matches the chosen template
- The file is written inside the current workspace so artifact collection can pick it up