mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-25 00:51:20 +00:00

docs(website): dedicated page per bundled + optional skill (#14929 )

Generates a full dedicated Docusaurus page for every one of the 132 skills
(73 bundled + 59 optional) under website/docs/user-guide/skills/{bundled,optional}/<category>/.
Each page carries the skill's description, metadata (version, author, license,
dependencies, platform gating, tags, related skills cross-linked to their own
pages), and the complete SKILL.md body that Hermes loads at runtime.

Previously the two catalog pages just listed skills with a one-line blurb and
no way to see what the skill actually did — users had to go read the source
repo. Now every skill has a browsable, searchable, cross-linked reference in
the docs.

- website/scripts/generate-skill-docs.py — generator that reads skills/ and
optional-skills/, writes per-skill pages, regenerates both catalog indexes,
and rewrites the Skills section of sidebars.ts. Handles MDX escaping
(outside fenced code blocks: curly braces, unsafe HTML-ish tags) and
rewrites relative references/*.md links to point at the GitHub source.
- website/docs/reference/skills-catalog.md — regenerated; each row links to
the new dedicated page.
- website/docs/reference/optional-skills-catalog.md — same.
- website/sidebars.ts — Skills section now has Bundled / Optional subtrees
with one nested category per skill folder.
- .github/workflows/{docs-site-checks,deploy-site}.yml — run the generator
before docusaurus build so CI stays in sync with the source SKILL.md files.

Build verified locally with `npx docusaurus build`. Only remaining warnings
are pre-existing broken link/anchor issues in unrelated pages.

2026-04-23 22:22:11 -07:00

3.2 KiB

Raw Blame History

title	sidebar_label	description
Gif Search — Search and download GIFs from Tenor using curl	Gif Search	Search and download GIFs from Tenor using curl

{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Gif Search

Search and download GIFs from Tenor using curl. No dependencies beyond curl and jq. Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat.

Skill metadata


Source	Bundled (installed by default)
Path	`skills/media/gif-search`
Version	`1.1.0`
Author	Hermes Agent
License	MIT
Tags	`GIF`, `Media`, `Search`, `Tenor`, `API`

Reference: full SKILL.md

:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::

GIF Search (Tenor API)

Search and download GIFs directly via the Tenor API using curl. No extra tools needed.

Setup

Set your Tenor API key in your environment (add to ~/.hermes/.env):

TENOR_API_KEY=your_key_here

Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits.

Prerequisites

curl and jq (both standard on macOS/Linux)
TENOR_API_KEY environment variable

Search for GIFs

# Search and get GIF URLs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Download a GIF

# Search and download the top result
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif

Get Full Metadata

curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'

API Parameters

Parameter	Description
`q`	Search query (URL-encode spaces as `+`)
`limit`	Max results (1-50, default 20)
`key`	API key (from `$TENOR_API_KEY` env var)
`media_filter`	Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm`
`contentfilter`	Safety: `off`, `low`, `medium`, `high`
`locale`	Language: `en_US`, `es`, `fr`, etc.

Available Media Formats

Each result has multiple formats under .media_formats:

Format	Use case
`gif`	Full quality GIF
`tinygif`	Small preview GIF
`mp4`	Video version (smaller file size)
`tinymp4`	Small preview video
`webm`	WebM video
`nanogif`	Tiny thumbnail

Notes

URL-encode the query: spaces as +, special chars as %XX
For sending in chat, tinygif URLs are lighter weight
GIF URLs can be used directly in markdown: ![alt](https://github.com/NousResearch/hermes-agent/blob/main/skills/media/gif-search/url)

3.2 KiB Raw Blame History