gifgrep

Search Tenor or Giphy GIFs and extract still frames or grid sheets.

87|20|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/openaeon/OpenAEON --skill gifgrep-openaeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/gifgrep
Command: npx skills add https://github.com/openaeon/OpenAEON --skill gifgrep-openaeon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gifgrep.

What problem does it solve?

Searching for the right GIFs and turning them into usable still images for sharing, documentation, or quick review is slow and manual.

Core Features & Use Cases

  • GIF provider search with CLI/TUI: Find relevant GIFs from Tenor and Giphy, and browse results in a terminal UI for faster selection.
  • Preview, download, and reveal: Preview matches and download them directly to your Downloads folder, with an optional Finder reveal to verify the result immediately.
  • Stills and sheets extraction: Extract a single still at a given timestamp or generate a frame grid (“sheet”) for quick visual review in PRs, chats, or docs.

Use Case: When preparing a changelog or PR description, generate a sheet from a chosen GIF so reviewers can understand the content without opening animated files.

Quick Start

Use the gifgrep skill to find GIFs by running gifgrep cats --max 5 --format url.

Frequently Asked Questions about gifgrep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract still images from a GIF for documentation?

You can extract still images from a GIF by generating a single still at a specific timestamp or creating a frame grid sheet. This allows reviewers to understand content in PRs or docs without opening animated files.

How do I search and download GIFs from Tenor or Giphy via CLI?

You can search and download GIFs from Tenor or Giphy by running CLI commands with query terms and limits. Results download directly to your Downloads folder, with an optional Finder reveal to verify the output immediately.

Can I preview GIF search results in a terminal UI before downloading?

Yes, you can preview GIF search results in a terminal UI before downloading. The TUI allows you to browse matches from providers like Tenor and Giphy for faster selection and direct download to your local folder.

Do I need an API key to search Giphy for GIFs?

Yes, you need an API key to search Giphy for GIFs. The system requires proper API key handling for Giphy access, alongside a local binary with provider selection support, to execute search and download operations.

What is a GIF frame grid sheet and when should I use one?

A GIF frame grid sheet is a static image containing sampled frames from an animated GIF. You should use it when preparing changelogs or PR descriptions so reviewers can quickly visually review the content without playing the animation.

Are there limitations when extracting still frames from animated GIFs?

Limitations when extracting still frames depend on the local gifgrep binary and CLI operations used. Frame sampling controls dictate extraction quality, and you must ensure the binary supports provider selection and sheet generation for successful output.