A CLI tool for searching, downloading, and converting GIF assets.

Install

mkdir -p .claude/skills/gifgrep && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2260" && unzip -o skill.zip -d .claude/skills/gifgrep && rm skill.zip

Installs to .claude/skills/gifgrep

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
79 charsno explicit “when” trigger
Beginner

Key capabilities

  • Search GIF providers like Tenor and Giphy
  • Preview GIFs in a terminal interface
  • Download GIF assets to local storage
  • Extract still frames from animated files
  • Generate frame sheets as PNG grids

How it works

It interfaces with GIF provider APIs to search and retrieve assets, then uses local processing to extract frames or grids based on user-defined parameters.

Inputs & outputs

You give it
Search query string
You get back
Downloaded GIF file or extracted PNG still/sheet

When to use gifgrep

  • Extracting a still frame from a GIF for documentation
  • Creating a frame sheet for UI testing
  • Searching for GIFs via terminal
  • Downloading assets for web content

About this skill

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)

GIF asset hygiene

  • Before recommending or using an animated GIF URL, verify it resolves successfully, has Content-Type: image/gif, and is actually animated (multiple frames or loop metadata; e.g. inspect with file, identify, or a small script).
  • Record attribution/license/source URL alongside the asset.
  • Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file.

Environment tweaks

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

When not to use it

  • When the target environment lacks support for terminal-based previews or image processing tools

Prerequisites

gifgrep binary installed via brew or goGIPHY_API_KEY for Giphy source

Limitations

  • Requires external API keys for specific providers
  • Preview functionality limited to specific terminal emulators

How it compares

It enables direct terminal-based searching and asset extraction instead of manual browser-based searching and external conversion tools.

Compared to similar skills

gifgrep side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gifgrep (this skill)92moNo flagsBeginner
infographic-generator07moNo flagsBeginner
pdf-to-markdown1,1758moReviewBeginner
markitdown1772moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

infographic-generator

vfarcic

Generate retro arcade style infographic prompts for documentation pages

05

pdf-to-markdown

aliceisjustplaying

Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.

1,1752,667

markitdown

K-Dense-AI

Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing. Use when converting documents to markdown, extracting text from PDFs/Office files, transcribing audio, performing OCR on images, extracting YouTube transcripts, or processing batches of files. Supports 20+ formats including DOCX, XLSX, PPTX, PDF, HTML, EPUB, CSV, JSON, images with OCR, and audio with transcription.

177310

word

Fergana-Labs

Create, read, edit, and manipulate Microsoft Word documents (.docx files). Use when users ask to work with Word files, create documents, read .docx files, or format text documents.

26172

task-management

anthropics

Simple task management using a shared TASKS.md file. Reference this when the user asks about their tasks, wants to add/complete tasks, or needs help tracking commitments.

1664

marker

benchflow-ai

Convert PDF documents to Markdown using marker_single. Use when Claude needs to extract text content from PDFs while preserving LaTeX formulas, equations, and document structure. Ideal for academic papers and technical documents containing mathematical notation.

2248

Search skills

Search the agent skills registry