claudegoodies
Skill

petdex

From NousResearch

Install and select animated petdex mascots for Hermes.

Installs and selects animated mascot sprites that react to Hermes agent activity via the `hermes pets` CLI.

Use it when

  • User asks for a desktop/terminal mascot or mentions petdex
  • Changing, previewing, or disabling the active pet
  • Diagnosing why a pet isn't rendering in the terminal

Skip it if

  • Only works within the Hermes CLI/TUI/desktop app ecosystem
  • Requires network access to petdex.dev to browse/install pets
  • Full-fidelity rendering needs a graphics-capable terminal (kitty, Ghostty, WezTerm, iTerm2, sixel)

Facts

Repository
NousResearch/hermes-agent
Status
Actively maintained
Last commit
Source file
skills/productivity/petdex/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Petdex Skill

Browse, install, and select animated "pet" mascots from the public
[petdex](https://github.com/crafter-station/petdex) gallery. An installed pet
reacts to agent activity (idle, running a tool, reviewing, error, done) across
the Hermes CLI, TUI, and desktop app. This skill drives the `hermes pets` CLI
and the `display.pet` config — it does not generate sprites.

## When to Use

- The user wants a desktop/terminal mascot or asks about "pets" / petdex.
- The user wants to change, preview, or disable the active pet.
- Diagnosing why a pet isn't showing (terminal graphics support, config).

## Prerequisites

- Network access to `petdex.dev` for the gallery/manifest (read-only, no auth).
- Pillow (a core Hermes dependency) for sprite decoding — already installed.
- For full-fidelity terminal rendering: a graphics-capable terminal (kitty,
  Ghostty, WezTerm, iTerm2, or sixel). Otherwise a truecolor Unicode
  half-block fallback is used automatically.

## How to Run

Use the `terminal` tool to run `hermes pets <subcommand>`.

## Quick Reference

| Goal | Command |
| --- | --- |
| Browse the gallery | `hermes pets list` (add a substring to filter: `hermes pets list cat`) |
| List installed pets | `hermes pets list --installed` |
| Install a pet | `hermes pets install <slug>` (add `--select` to make it active) |
| Set the active pet | `hermes pets select <slug>` (omit slu
View full source on GitHub →

Other skills