Meme

Documents

meme

Meme is an Agent Skill for documents published in the x-cmd/x-cmd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate meme images by overlaying text onto templates. Zero barrier — works with Python + Pillow, no framework needed. Templates are fetched on demand from the awesome-meme data repo. Use for "meme", "meme generator", "text overlay", "distracted boyfriend", "image macro".

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/x-cmd/x-cmd/blob/HEAD/mod/skill0/lib/skill0/skills/meme/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/meme, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

meme — skill0

Generate meme images. 30+ templates. Zero barrier.

An AI agent reads this file and knows how to make memes. No x-cmd needed.

Quick Start

# Install dependencies
pip install pillow pyyaml

# Generate a meme (auto-downloads template from GitHub)
python3 scripts/meme_render.py distracted-boyfriend "ZIG" "ME" "RUST"

More Examples

python3 scripts/meme_render.py this-is-fine "ERROR LOG" "THIS IS FINE"
python3 scripts/meme_render.py drake-hotline-bling "Write tests" "Ship it"
python3 scripts/meme_render.py expanding-brain "Copy paste" "Google it" "Read docs" "Ask AI"

Options

Option	Values	Default	Description
`--backend`	pillow, magick	pillow	Rendering backend
`--layout`	chest-label, above-head, bottom-label	(spec default)	Text placement preset
`--output`	file path	meme_output.jpg	Output file path

Font selection

Text language	Font used
English / Latin	Impact (default)
Chinese / CJK	PingFang (macOS) / Noto Sans CJK (Linux)
Mixed	Each slot auto-detected independently

Impact has no CJK glyphs — Chinese text will be invisible. The renderer auto-detects CJK and falls back to system fonts. On Linux: apt install fonts-noto-cjk.

Pure Shell (no Python)

bash scripts/meme_render.sh distracted-boyfriend "ZIG" "ME" "RUST"

Upgrade with x-cmd

If you have x-cmd installed:

eval "$(curl https://get.x-cmd.com)"
x meme distracted-boyfriend "ZIG" "ME" "RUST"

Same result, cleaner integration with the x-cmd ecosystem.

Data Source

Templates live in awesome-meme. The renderer fetches specs and images from GitHub on demand.

Docs

references/INSTALL.md — Dependencies (Pillow, ImageMagick, fonts)
references/PILLOW.md — Pillow backend details
references/IMAGE_MAGICK.md — ImageMagick backend details
references/GUIDELINES.md — AI agent usage guidelines