Agent skill
meme-factory
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.
Install this agent skill to your Project
npx add-skill https://github.com/softaworks/agent-toolkit/tree/main/dist/plugins/meme-factory/skills/meme-factory
SKILL.md
Meme Factory
Create memes using the free memegen.link API and textual meme formats.
Triggers
| Trigger | Description |
|---|---|
/meme-factory |
Manual invocation |
/meme-factory {template} {top} {bottom} |
Direct meme generation |
meme-factory: create a meme about X |
Natural language request |
Quick Reference
| Action | Format |
|---|---|
| Basic meme | https://api.memegen.link/images/{template}/{top}/{bottom}.png |
| With sizing | ?width=1200&height=630 |
| Custom background | ?style=https://example.com/image.jpg |
| All templates | https://api.memegen.link/templates/ |
| Interactive docs | https://api.memegen.link/docs/ |
Additional Resources:
- Markdown Memes Guide - 15+ textual meme formats
- Examples - Practical usage examples
- meme_generator.py - Python helper script
Quick Start
Basic Meme Structure
https://api.memegen.link/images/{template}/{top_text}/{bottom_text}.{extension}
Example:
https://api.memegen.link/images/buzz/memes/memes_everywhere.png
Result: Buzz Lightyear meme with "memes" at top and "memes everywhere" at bottom.
Text Formatting
| Character | Encoding |
|---|---|
| Space | _ or - |
| Newline | ~n |
| Question mark | ~q |
| Percent | ~p |
| Slash | ~s |
| Hash | ~h |
| Single quote | '' |
| Double quote | "" |
Popular Templates
| Template | Use Case | Example |
|---|---|---|
buzz |
X, X everywhere | bugs/bugs_everywhere |
drake |
Comparisons | manual_testing/automated_testing |
success |
Victories | deployed/no_errors |
fine |
Things going wrong | server_on_fire/this_is_fine |
fry |
Uncertainty | not_sure_if_bug/or_feature |
changemind |
Hot takes | tabs_are_better_than_spaces |
distracted |
Priorities | my_code/new_framework/current_project |
mordor |
One does not simply | one_does_not_simply/deploy_on_friday |
Template Selection Guide
| Context | Template | Why |
|---|---|---|
| Comparing options | drake |
Two-panel reject/approve format |
| Celebrating wins | success |
Positive outcome emphasis |
| Problems ignored | fine |
Ironic "everything is fine" |
| Uncertainty | fry |
"Not sure if X or Y" format |
| Controversial opinion | changemind |
Statement + challenge |
| Ubiquitous things | buzz |
"X, X everywhere" |
| Bad ideas | mordor |
"One does not simply..." |
Validation
After generating a meme:
- URL returns valid image (test in browser)
- Text is readable (not too long)
- Template matches the message context
- Special characters properly encoded
- Dimensions appropriate for platform
Platform Dimensions
| Platform | Dimensions |
|---|---|
| Social media (Open Graph) | 1200x630 |
| Slack/Discord | 800x600 |
| GitHub | Default |
Anti-Patterns
| Avoid | Why | Instead |
|---|---|---|
| Spaces without encoding | URL breaks | Use _ or - |
| Too much text | Unreadable | 2-6 words per line |
| Wrong template | Message mismatch | Match template to context |
| Missing extension | Invalid URL | Always include .png, .jpg, etc. |
| Unencoded special chars | URL breaks | Use ~q, ~s, ~p, etc. |
| Assuming template exists | 404 error | Check templates list first |
Verification
Meme generation is successful when:
- URL is valid - Returns HTTP 200
- Image renders - Displays correctly in markdown
- Text is visible - Properly formatted on image
- Context matches - Template fits the message
Test command:
curl -I "https://api.memegen.link/images/buzz/test/test.png"
# Should return: HTTP/2 200
Image Formats
| Extension | Use Case |
|---|---|
.png |
Best quality, default |
.jpg |
Smaller file size |
.webp |
Modern, good compression |
.gif |
Animated templates |
Dimensions
?width=800
?height=600
?width=800&height=600 (padded to exact)
Layout Options
?layout=top # Text at top only
?layout=bottom # Text at bottom only
?layout=default # Standard top/bottom
Custom Fonts
View available: https://api.memegen.link/fonts/
?font=impact (default)
Custom Images
Use any image as background:
https://api.memegen.link/images/custom/hello/world.png?style=https://example.com/image.jpg
Code Reviews
Template: fry
https://api.memegen.link/images/fry/not_sure_if_feature/or_bug.png
Deployments
Template: interesting
https://api.memegen.link/images/interesting/i_dont_always_test/but_when_i_do_i_do_it_in_production.png
Documentation
Template: yodawg
https://api.memegen.link/images/yodawg/yo_dawg_i_heard_you_like_docs/so_i_documented_the_documentation.png
Performance Issues
Template: fine
https://api.memegen.link/images/fine/memory_usage_at_99~/this_is_fine.png
Successful Deploy
Template: success
https://api.memegen.link/images/success/deployed_to_production/zero_downtime.png
Generating Memes in Response
Here's a relevant meme:

Dynamic Generation (Python)
def generate_status_meme(status: str, message: str):
template_map = {
"success": "success",
"failure": "fine",
"review": "fry",
"deploy": "interesting"
}
template = template_map.get(status, "buzz")
words = message.split()
top = "_".join(words[0:3])
bottom = "_".join(words[3:6])
return f"https://api.memegen.link/images/{template}/{top}/{bottom}.png"
Using the Helper Script
from meme_generator import MemeGenerator
meme = MemeGenerator()
url = meme.generate("buzz", "features", "features everywhere")
print(url)
Endpoints
| Endpoint | Purpose |
|---|---|
/templates/ |
List all templates |
/templates/{id} |
Template details |
/fonts/ |
Available fonts |
/images/{template}/{top}/{bottom}.{ext} |
Generate meme |
API Characteristics
- Free and open-source
- No API key required
- No rate limiting (normal use)
- Stateless (all info in URL)
- Images generated on-demand
Error Handling
- Check template at https://api.memegen.link/templates/
- Verify text formatting (underscores for spaces)
- Check special character encoding
- Ensure valid extension
- Test URL in browser
References
| Document | Content |
|---|---|
| markdown-memes-guide.md | 15+ textual meme formats (greentext, copypasta, ASCII, etc.) |
| examples.md | Practical usage examples |
Scripts
| Script | Purpose |
|---|---|
| meme_generator.py | Python helper for meme generation |
Summary
Generate contextual memes to:
- Add humor to conversations
- Create social media visuals
- Make code reviews engaging
- Celebrate successes
Golden rule: Keep text concise, match template to context.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
crafting-effective-readmes
Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.
frontend-to-backend-requirements
Document frontend data needs for backend developers. Use when frontend needs to communicate API requirements to backend, or user says 'backend requirements', 'what data do I need', 'API requirements', or is describing data needs for a UI.
feedback-mastery
Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.
openapi-to-typescript
Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. This skill should be used when the user asks to generate types from OpenAPI, convert schema to TS, create API interfaces, or generate TypeScript types from an API specification.
plugin-forge
Create and manage Claude Code plugins with proper structure, manifests, and marketplace integration. Use when creating plugins for a marketplace, adding plugin components (commands, agents, hooks), bumping plugin versions, or working with plugin.json/marketplace.json manifests.
skill-judge
Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Provides multi-dimensional scoring and actionable improvement suggestions.
Didn't find tool you were looking for?