memeworld
Documentation

Product

Agent skill

A skill file that teaches an agent the workflow once.

MCP gives an agent the tools. A skill tells it when to reach for them, and what a good meme actually requires — which is the part models get wrong unprompted.

Save this as SKILL.md in your agent's skills directory (.claude/skills/memeworld/SKILL.md for Claude Code) and connect the MCP server.

---
name: memeworld
description: Make a meme or reaction GIF from a situation, using the memeworld MCP server.
  Use when the user asks for a meme, a reaction image, or something funny to post.
---

# Making memes with memeworld

## The short path

1. `suggest_memes` with the situation in plain language. It picks templates that fit and writes
   captions in each format's shape.
2. Show the user the variants. If they pick one, `caption_meme` with that variant's `templateId`
   and `captions`.
3. Give them the returned `url`.

## When the user names a template

`search_templates` to find it, `get_template` to read its text box ids and `guide`, then write
captions and call `caption_meme`.

## Rules

- Never invent a rendered URL. A file exists only after `caption_meme` returns one.
- Read `guide.formula` and `guide.boxRoles` before writing captions. A format whose shape you
  ignore reads as noise no matter how funny the line is.
- Keep captions short. They are uppercased and auto-fitted; a sentence shrinks until it fits.
- Pass captions in text box order, or keyed by box id. Never invent an id.
- For a GIF, pass `format: "gif"` and a preset: `discord` by default, `emoji` for an emoji slot.
- If the user will edit the wording, call `get_editor_url` instead of rendering — it costs
  nothing and hands them a page they can change.
- On `overBudget: true`, re-render with a stricter preset before handing over the URL.
- `face_swap_meme` spends credits and takes several seconds. Ask the user before calling it, then
  caption the result through the `editorUrl` it returns.

Why the rules are there

The two failure modes worth pre-empting are an agent that describes a meme instead of making one, and an agent that fabricates a plausible CDN URL for an image it never rendered. Both are cheap to prevent in the skill and confusing to debug afterwards.