All skills
softaworks avatar

/meme-factory

@1c0662a
by softaworkssoftaworks/agent-toolkit2.5k stars
230

Generate memes using the memegen.link API. Use when users request memes, want to add humor to content, or need visual aids for social media. Supports 100+ popular templates with custom text and styling.

Use this Skill: https://skilld.dev/gh/softaworks/agent-toolkit/meme-factory

This session only. Nothing lands on disk.

README.md

≈1.7k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Meme Factory

A Claude Code skill for generating memes using the memegen.link API and textual meme formats.

Purpose

The Meme Factory skill enables you to quickly create visual memes for various contexts - from code reviews to deployment celebrations. It uses the free memegen.link API to generate memes with custom text on popular templates, and also supports textual meme formats like greentext and copypasta.

When to Use

Use this skill when you want to:

  • Add humor to technical conversations
  • Create visual content for social media
  • Make code reviews more engaging
  • Celebrate successful deployments
  • Generate memes about bugs, features, or tech decisions
  • Need quick visual aids without design tools

How It Works

The skill leverages the memegen.link API, which generates memes on-demand using URL parameters:

https://api.memegen.link/images/{template}/{top_text}/{bottom_text}.png

Key features:

  • No API key required - Free and open-source
  • 100+ templates - Popular meme formats built-in
  • URL-based - All parameters in the URL (stateless)
  • Custom styling - Control dimensions, fonts, and backgrounds
  • Special character encoding - Handles spaces, symbols, newlines

Key Features

1. Popular Templates

  • buzz - "X, X everywhere" format
  • drake - Two-panel comparison
  • success - Celebrating wins
  • fine - "This is fine" irony
  • fry - "Not sure if..." uncertainty
  • changemind - Controversial opinions
  • distracted - Wrong priorities
  • mordor - "One does not simply..."

2. Text Formatting

  • Spaces: Use _ or -
  • Newlines: Use ~n
  • Special chars: ~q (question), ~p (percent), ~s (slash), ~h (hash)

3. Customization Options

  • Image formats: PNG, JPG, WebP, GIF
  • Dimensions: Custom width/height
  • Layout: Top, bottom, or default
  • Fonts: Multiple options available
  • Custom backgrounds: Use any image URL

4. Textual Memes

Includes 15+ text-based meme formats:

  • Greentext stories
  • Copypasta
  • ASCII art
  • Reaction emojis
  • And more (see markdown-memes-guide.md)

Usage Examples

Basic Meme

/meme-factory buzz memes memes_everywhere

Generates: https://api.memegen.link/images/buzz/memes/memes_everywhere.png

Code Review Context

/meme-factory fry not_sure_if_feature or_bug

Generates: https://api.memegen.link/images/fry/not_sure_if_feature/or_bug.png

Deployment Success

/meme-factory success deployed_to_production zero_downtime

Generates: https://api.memegen.link/images/success/deployed_to_production/zero_downtime.png

Comparing Options

/meme-factory drake manual_testing automated_testing

Generates: https://api.memegen.link/images/drake/manual_testing/automated_testing.png

Production Issues

/meme-factory fine memory_usage_at_99~ this_is_fine

Generates: https://api.memegen.link/images/fine/memory_usage_at_99~/this_is_fine.png

With Custom Dimensions

/meme-factory buzz features features_everywhere

Add query params: ?width=1200&height=630 for social media

Natural Language

meme-factory: create a meme about deploying on friday

Claude will select appropriate template (likely mordor) and generate the meme.

Quick Start

  1. Invoke the skill:

    /meme-factory
  2. Specify template and text:

    /meme-factory {template} {top_text} {bottom_text}
  3. Or use natural language:

    meme-factory: create a meme about {your topic}
  4. Browse templates: Visit https://api.memegen.link/templates/ to see all available templates

  5. Test the URL:

    curl -I "https://api.memegen.link/images/buzz/test/test.png"

Template Selection Guide

Context Recommended Template Why
Comparing two options drake Two-panel reject/approve
Celebrating wins success Positive emphasis
Things going wrong fine Ironic "everything is fine"
Uncertainty fry "Not sure if X or Y"
Controversial take changemind Statement + challenge
Something ubiquitous buzz "X, X everywhere"
Bad ideas mordor "One does not simply..."
Wrong priorities distracted Boyfriend looking at other girl

Validation Checklist

After generating a meme, verify:

  • URL returns valid image (HTTP 200)
  • Text is readable (not too long - keep 2-6 words per line)
  • Template matches the message context
  • Special characters properly encoded
  • Dimensions appropriate for platform

Platform Dimensions

Platform Recommended Size
Social media (Open Graph) 1200x630
Slack/Discord 800x600
GitHub Default

Common Pitfalls

Mistake Why It Fails Solution
Spaces without encoding URL breaks Use _ or -
Too much text Unreadable Keep it short (2-6 words)
Wrong template Message mismatch Match template to context
Missing extension Invalid URL Always use .png, .jpg, etc.
Unencoded special chars URL breaks Use ~q, ~s, ~p
Assuming template exists 404 error Check templates list first

Additional Resources

Example Workflow

In Code Review

Great catch on that edge case!

![Code Review](https://api.memegen.link/images/fry/not_sure_if_feature/or_bug.png)

Let's add a test to clarify the expected behavior.

In Deployment Notification

Production deployment complete!

![Success](https://api.memegen.link/images/success/deployed_to_production/zero_downtime.png)

All health checks passing.

In Bug Report

Found an interesting issue in the payment flow:

![Bug](https://api.memegen.link/images/fine/payment_service_down/this_is_fine.png)

Rolling back to previous version while we investigate.

Summary

Meme Factory makes it easy to add humor and visual interest to technical communication. Whether you're celebrating a successful deploy, highlighting a code review comment, or just making your team laugh, this skill helps you quickly generate contextual memes without leaving Claude Code.

Golden rule: Keep text concise, match template to context, and have fun!

Source: SKILL.md on GitHub

No alerts17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The Meme Factory skill is a safe utility for generating memes using the memegen.link API. It includes a Python script that properly sanitizes user input and comprehensive documentation. No malicious patterns or security risks were identified.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    1/5 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 1c0662a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 9 months ago
  • API
  • Python
  • memegen
  • meme-generation
  • image
  • social-media
  • humor
  • url-encoding

README badge

README badge for softaworks/agent-toolkit/meme-factory

Generates memes using the memegen.link API with support for 100+ templates and custom text formatting. Use to add humor to conversations, create social media visuals for specific contexts like deployments or code reviews, or celebrate team wins with appropriate template selection.

Generated from the current SKILL.md.

Does this skill require an API key?
No. The skill uses the free memegen.link API, which requires no API key and has no rate limiting for normal use.
How do I add spaces or special characters to meme text?
Use underscores or hyphens for spaces, and special encodings like ~q for question marks, ~s for slashes, and ~p for percent signs. See the text formatting table in the SKILL.md for the complete list.
Can I use custom images as meme backgrounds?
Yes. Pass a custom image URL via the ?style parameter with the custom template, e.g. ?style=https://example.com/image.jpg.
How many meme templates are supported?
100+ templates are available. You can browse the full list at https://api.memegen.link/templates/ or use popular ones like drake, buzz, success, fine, and fry.
Can I control meme dimensions or image format?
Yes. You can specify width and height via query parameters (e.g. ?width=1200&height=630) and choose image formats including PNG, JPG, WebP, or GIF.

Generated from the current SKILL.md. These answers refresh after source changes.