add-skill-giphy

name	add-skill-giphy
description	Add GIF search and sending to NanoTars agents via Giphy API. Enables humorous GIF reactions in conversations. Guides through free API key setup. Triggers on "add giphy", "gif search", "add gifs", "giphy setup".

Add GIF Search (Giphy)

Configures Giphy API access for agent containers, enabling GIF search and sending for humorous reactions in conversations.

Preflight

Before installing, verify NanoTars is set up:

[ -d node_modules ] && echo "DEPS: ok" || echo "DEPS: missing"
docker image inspect nanoclaw-agent:latest &>/dev/null && echo "IMAGE: ok" || echo "IMAGE: not built"
if grep -q "ANTHROPIC_API_KEY\|CLAUDE_CODE_OAUTH_TOKEN" .env 2>/dev/null || [ -f "$HOME/.claude/.credentials.json" ]; then echo "AUTH: ok"; else echo "AUTH: missing"; fi

If any check fails, tell the user to run /nanotars-setup first and stop.

Prerequisites

• A Giphy API key (free tier: 100 requests/hour)

Install

1. Copy plugin files:

   cp -r ${CLAUDE_PLUGIN_ROOT}/files/ plugins/gif-search/
   

2. Plugin Configuration: By default this plugin is available to all groups and channel types. To restrict access, edit plugins/gif-search/plugin.json and set:

   • "groups" to specific group folder names (e.g., ["main"]) instead of ["*"]
   • "channels" to specific channel types (e.g., ["whatsapp"]) instead of ["*"]

   Ask the user if they want to restrict access. Most users will keep the defaults.

3. Get a free API key:

   • Go to https://developers.giphy.com/
   • Click "Create an App" and sign up / log in
   • Choose API (not SDK)
   • Copy your API key from the app dashboard

4. Add to .env:

   echo 'GIPHY_API_KEY=YOUR_KEY_HERE' >> .env
   

5. Rebuild and restart:

   npm run build
   nanotars restart  # or launchctl on macOS
   

Verify

Test the API key:

source .env
curl -s "https://api.giphy.com/v1/gifs/search?q=thumbs+up&limit=1&api_key=$GIPHY_API_KEY" | python3 -c "
import sys, json
r = json.load(sys.stdin)
d = r.get('data', [])
if d:
    print(f\"OK - got {len(d)} result(s): {d[0].get('title', 'untitled')}\")
else:
    print(f\"FAILED - {r.get('message', 'no results')}\")
"

Per-group overrides: If a specific group needs a different Giphy API key, add GIPHY_API_KEY=... to groups/{folder}/.env. See /create-skill-plugin for details.

Remove

1. rm -rf plugins/gif-search/
   

2. Remove GIPHY_API_KEY from .env
3. Rebuild and restart