skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

petdex

Install and select animated petdex mascots for the Hermes CLI, TUI, and desktop app.

Updated Jul 3, 2026
Search Tags:#cli#terminal#animation#display#mascot#hermes#petdex
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill petdex-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/productivity/petdex
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill petdex-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow.

What problem does it solve? Users who want an animated desktop or terminal mascot in Hermes need a way to browse the petdex gallery, install pets, activate one, and diagnose rendering issues across the CLI, TUI, and desktop app. ## Core Features & Use Cases - Gallery browsing and installation: Search the public petdex gallery with hermes pets list <query> and install pets by slug with hermes pets install <slug> --select. - Pet management and preview: Select, scale (0.1–3.0), preview animations by state (idle, run, error, done), disable, or remove pets via hermes pets subcommands. - Rendering diagnostics: hermes pets doctor reports the resolved pet, render mode, detected terminal graphics protocol (kitty, iTerm, sixel, or Unicode fallback), and readiness. - Use Case: A user wants a cat mascot in their terminal. They run hermes pets list cat, install a slug with --select, preview it with hermes pets show, and confirm setup with hermes pets doctor. ## Quick Start Ask the agent to browse the petdex gallery for a pet, install it with the select flag, and run the doctor command to confirm it renders in your terminal.

Frequently Asked Questions about petdex

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

FAQPage Schema
How do I install and activate a petdex pet in Hermes?▼

Run `hermes pets list <query>` to find a pet's slug, then `hermes pets install <slug> --select` to install and activate it. Preview it with `hermes pets show` and confirm setup with `hermes pets doctor`.

How do I resize the pet mascot in the terminal?▼

Use `hermes pets scale <factor>` with a value clamped between 0.1 and 3.0, such as `hermes pets scale 0.5`. One scale setting resizes the pet across the CLI, TUI, and desktop app.

Which terminals support full-fidelity pet rendering?▼

Graphics-capable terminals such as kitty, Ghostty, WezTerm, iTerm2, or sixel-capable terminals render at full fidelity. Other terminals automatically fall back to a truecolor Unicode half-block mode.

Why is my pet not showing in the terminal?▼

A pet only displays after one is installed, selected, and enabled in `display.pet` config. Rendering is also disabled inside pipes or redirects without a TTY; run `hermes pets doctor` to diagnose the resolved pet and render mode.

Where are petdex pets installed and can I use the npm CLI?▼

Pets install into the profile-scoped `<HERMES_HOME>/pets/<slug>/` directory. The petdex npm CLI installs to `~/.codex/pets`, which Hermes does not use, so install through `hermes pets` instead.

Related Skills

Explore More Personal & Entrepreneur Skills→
FlyFireFFlyFireF

petdex

Install and select animated mascots for the Hermes interface.

Community
Basic
davpatel605-beepdavpatel605-beep

petdex

Manage installation and selection of animated pet mascots for Hermes environments.

Community
Intermediate
thrashr888thrashr888
7

R-DOS Graphics Skill

Implement sixel graphics and retro effects in the R-DOS terminal.

Community
Advanced
hugotownhugotown

petdex

Install and select animated petdex mascots for the Hermes CLI, TUI, and desktop app.

Community
Basic