rodeo — Claude Code skill: what it does, how to install
Connects meme-rodeo MCP utilities to search, inspect, and retrieve meme collection statistics via CLI or stdio proxy.
npx skills add harperreed/dotfiles --skill rodeo -a claude-codeWhat rodeo does
The tool is a Go CLI built to communicate with https://mcp.meme.rodeo. It handles meme lookups by keyword, pulls specific entries by ID, lists fresh uploads, and retrieves general catalog metrics.
It runs in two distinct modes. You can execute direct queries using rodeo call or launch a persistent stdio server via rodeo serve. Registering that command inside .mcp.json makes tools like search_memes, random_memes, and meme_stats accessible to agents.
Running queries without building the binary or passing an API key triggers an immediate failure. Authentication prioritizes the --api-key flag and RODEO_API_KEY before checking OAuth tokens or ~/.config/rodeo/config.yaml.
What it helps with
- search the meme catalog using keyword queries
- fetch random memes for visual ideas
- retrieve collection statistics from meme-rodeo
- expose meme-rodeo tools as a local stdio MCP proxy
Example prompts for the agent
- Search for cat memes using rodeo
- Check the meme-rodeo collection stats
- Give me three random memes from rodeo
How to install rodeo
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill rodeo -a claude-code2Manually: put the files in place
~/.claude/skills/rodeo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rodeo/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill rodeo -a codex2Manually: put the files in place
.agents/skills/rodeo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill rodeo -a cursor2Manually: put the files in place
.cursor/skills/rodeo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles rodeo2Manually: put the files in place
.github/skills/rodeo/SKILL.md1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill rodeo -a gemini-cli2Platform CLI
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills-archive/rodeoManually: put the files in place
.devin/skills/rodeo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill rodeo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rodeo
How do I install rodeo in Claude Code?
Run npx skills add harperreed/dotfiles --skill rodeo -a claude-code in your terminal.
What does rodeo do?
It provides terminal and MCP access to meme-rodeo, letting agents search entries, pull recent additions, and read database metrics.
What is required before using rodeo?
You must build the executable using go build -o rodeo . and configure an API key via rodeo login or rodeo config set api-key <key>.