diff --git a/skills/gifgrep/SKILL.md b/skills/gifgrep/SKILL.md new file mode 100644 index 0000000000..e1204e32ab --- /dev/null +++ b/skills/gifgrep/SKILL.md @@ -0,0 +1,47 @@ +--- +name: gifgrep +description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets. +homepage: https://gifgrep.com +metadata: {"clawdis":{"emoji":"🧲","requires":{"bins":["gifgrep"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gifgrep","bins":["gifgrep"],"label":"Install gifgrep (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/gifgrep/cmd/gifgrep@latest","bins":["gifgrep"],"label":"Install gifgrep (go)"}]}} +--- + +# 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