Meme Generator Skill

A modular skill for AI agents (like OpenClaw) to generate memes and share them via Slack.

Features

• Smart Template Matching: Fuzzy search to find the best meme template for a user's prompt (e.g., "coding" -> finds relevant dev memes).
• Unicode Support: Full support for non-English text (Vietnamese, emojis, etc.) using notosans font.
• Slack Integration: Verification hook to send generated memes to a channel.
• Resilient: Fallback to random templates if no match is found.

Installation

npm install

Configuration

Create a .env file:

# Optional: Self-hosted instance, defaults to api.memegen.link
MEMEGEN_URI=https://api.memegen.link

# Required for Slack notification
SLACK_HOOK_URL=https://hooks.slack.com/services/YOUR/HOOK/URL

Usage

CLI

Run directly from the terminal with any number of text lines:

# 2 lines (classic)
node index.js "doge" "Much Skill" "Very Wow"

# 3 lines (Captain America)
node index.js "captain" "Look at me" "I am the captain" "now"

# 5 lines (Elmo choosing cocaine)
node index.js "elmo" "option 1" "option 2" "option 3" "option 4" "option 5"

# 6 lines (American Chopper Argument)
node index.js "chair" "point 1" "point 2" "point 3" "point 4" "point 5" "point 6"

# Unicode support
node index.js "success" "Tài đức" "Vẹn toàn"

Wrapper Script

Use the simplified pipe syntax:

./meme.sh "drake | not using memes | using memes"
./meme.sh "elmo | option 1 | option 2 | option 3 | option 4 | option 5"

Programmatic

const { executeSkill } = require('./index');

// Generate with 2 texts
const result = await executeSkill('doge', ['Much Skill', 'Very Wow'], false);
console.log(result.url);

// Generate with 5 texts
const result2 = await executeSkill('elmo', ['option 1', 'option 2', 'option 3', 'option 4', 'option 5'], false);
console.log(result2.url);

// Generate and Send to Slack
await executeSkill('doge', ['Much code', 'Very works'], true);

AI Agent Integration (OpenClaw)

1. Install Skill

Clone this repository into your OpenClaw skills directory or configure it as a remote skill:

• Repository: https://github.com/plainlab/meme-skill

git clone https://github.com/plainlab/meme-skill
cd meme-skill
npm install

2. Tool Definition (skill.json)

To register this skill with an AI agent, use the definition found in skill.json:

{
  "name": "generate_meme",
  "description": "Generate a meme image based on a search prompt and captions. Can optionally send to Slack.",
  "parameters": {
    "type": "object",
    "properties": {
      "prompt": {
        "type": "string",
        "description": "Keyword to find a meme template (e.g., 'doge', 'cat', 'coding')."
      },
      "topText": {
        "type": "string",
        "description": "Text to appear at the top of the meme."
      },
      "bottomText": {
        "type": "string",
        "description": "Text to appear at the bottom of the meme."
      },
      "sendToSlack": {
        "type": "boolean",
        "description": "Whether to send the generated meme to the configured Slack channel.",
        "default": true
      }
    },
    "required": ["prompt", "topText", "bottomText"]
  }
}

Testing

Run unit tests:

npm test