Agent skill

gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/unknown-harleycoops-clawdbot-11

Metadata

Additional technical details for this skill

clawdbot 
{
    "emoji": "\ud83e\uddf2",
    "install": [
        {
            "id": "brew",
            "bins": [
                "gifgrep"
            ],
            "kind": "brew",
            "label": "Install gifgrep (brew)",
            "formula": "steipete/tap/gifgrep"
        },
        {
            "id": "go",
            "bins": [
                "gifgrep"
            ],
            "kind": "go",
            "label": "Install gifgrep (go)",
            "module": "github.com/steipete/gifgrep/cmd/gifgrep@latest"
        }
    ],
    "requires": {
        "bins": [
            "gifgrep"
        ]
    }
}

SKILL.md

gifgrep

Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.

GIF-Grab (gifgrep workflow)

  • Search → preview → download → extract (still/sheet) for fast review and sharing.

Quick start

  • gifgrep cats --max 5
  • gifgrep cats --format url | head -n 5
  • gifgrep search --json cats | jq '.[0].url'
  • gifgrep tui "office handshake"
  • gifgrep cats --download --max 1 --format url

TUI + previews

  • TUI: gifgrep tui "query"
  • CLI still previews: --thumbs (Kitty/Ghostty only; still frame)

Download + reveal

  • --download saves to ~/Downloads
  • --reveal shows the last download in Finder

Stills + sheets

  • gifgrep still ./clip.gif --at 1.5s -o still.png
  • gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
  • Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
  • Tune: --frames (count), --cols (grid width), --padding (spacing).

Providers

  • --source auto|tenor|giphy
  • GIPHY_API_KEY required for --source giphy
  • TENOR_API_KEY optional (Tenor demo key used if unset)

Output

  • --json prints an array of results (id, title, url, preview_url, tags, width, height)
  • --format for pipe-friendly fields (e.g., url)

Environment tweaks

  • GIFGREP_SOFTWARE_ANIM=1 to force software animation
  • GIFGREP_CELL_ASPECT=0.5 to tweak preview geometry

Didn't find tool you were looking for?

Be as detailed as possible for better results