Gifgrep
Search Tenor and Giphy from the terminal, preview in a TUI, download GIFs, and pull still frames or sprite sheets for docs, demos, and social posts.
Overview
gifgrep is an agent skill for the Build phase that teaches agents to search GIF providers, run the TUI, download clips, and extract stills or sheets via the gifgrep CLI.
Install
npx skills add https://github.com/steipete/clawdis --skill gifgrepWhat is this skill?
- Search Tenor/Giphy via CLI, JSON, or interactive TUI (`gifgrep tui "query"`)
- GIF-Grab workflow: search → preview → download → extract still or sheet
- Download to ~/Downloads with optional Finder reveal
- Terminal still previews with `--thumbs` on Kitty/Ghostty
- Extract frames with `gifgrep still ./clip.gif --at 1.5s`
- 4-step GIF-Grab workflow: search, preview, download, extract
Adoption & trust: 1.9k installs on skills.sh; 378k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need a specific GIF or a clean still frame for docs or social content but bouncing between browser tabs and manual saves slows down agent-driven shipping.
Who is it for?
Solo builders automating meme reactions, demo GIFs, or support assets from the same terminal session as their coding agent.
Skip if: Teams that only need stock photos, blocked shell/network environments, or workflows with no `gifgrep` binary installed.
When should I use this skill?
You need to find, preview, download, or extract GIFs from Tenor/Giphy using gifgrep in an agent session.
What do I get? / Deliverables
After the skill runs, your agent can query providers, save downloads locally, and produce shareable stills or sheets using documented gifgrep commands.
- Downloaded GIF files
- Still frames or sheets from clips
- JSON or URL lists for scripting
Recommended Skills
Journey fit
Gifgrep is a concrete CLI integration you wire into agent workflows while building tooling and content assets, not a cross-journey methodology. It connects external GIF providers and local filesystem actions (download, reveal, extract) — classic build-phase integration work for solo builders shipping with agents.
How it compares
Use this procedural skill to drive a real CLI instead of asking the model to hallucinate GIF URLs or scrape sites ad hoc.
Common Questions / FAQ
Who is gifgrep for?
Indie developers and agent users who want terminal-first GIF search, download, and frame extraction while building content or internal tools.
When should I use gifgrep?
During Build when wiring CLI integrations or agent-tooling, and whenever you need quick GIF discovery, TUI browse, or still extraction for docs and launch assets.
Is gifgrep safe to install?
Review the Security Audits panel on this Prism page and vet the Homebrew tap or Go module source before granting shell and network access to your agent.
SKILL.md
READMESKILL.md - Gifgrep
# 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