Agent skill

Hermes Pet Hatch

by asimons81 in asimons81/hermes-pets

Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs.

MITAuto-check passed

Install Hermes Pet Hatch

skills CLI
$ npx skills add asimons81/hermes-pets --skill hermes-pet-hatch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install asimons81/hermes-pets hermes-pet-hatch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/asimons81/hermes-pets.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/hermes-pet-hatch .claude/skills/hermes-pet-hatch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hermes-pet-hatch
GitHub stars
105
Token cost
~1.3k tokens
SKILL.md length
431 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs.

  • A user wants to generate
  • SKILL.md covers Purpose, Package Format, Workflow and Verification
  • Calls python, python3 and node
  • Install custom Hermes Pets animated pets without modifying built-in repo assets

What it does

Hermes Pet Hatch is an agent skill from asimons81/hermes-pets. Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs. Use when a user wants to generate, package, validate, preview, import, or install custom Hermes Pets animated pets without modifying built-in repo assets.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MIT.

When your agent uses it

  • A user wants to generate
  • Install custom Hermes Pets animated pets without modifying built-in repo assets

Example prompts

  • “/hermes-pet-hatch”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 16f3493. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • python3
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hermes Pet Hatch loads about 1.3k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 431 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from asimons81/hermes-pets at commit 16f3493, republished under its MIT licence (© asimons81). 431 words, ~1,349 tokens.

Download SKILL.mdSave it as .claude/skills/hermes-pet-hatch/SKILL.md (or your agent's skills folder).
name
hermes-pet-hatch
description
Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs. Use when a user wants to generate, package, validate, preview, import, or install custom Hermes Pets animated pets without modifying built-in repo assets.

Hermes Pets Hatch

Purpose

Create animated pets for the Hermes Pets overlay runtime. This skill is a Hermes-specific adapter around the general hatch-pet workflow: use hatch-pet for visual generation and row QA, then package the finalized frames into a Hermes custom pet package that can be imported with hermes-pet custom-pet import <path> --name <name>.

Do not add generated pets to overlay/assets/sprites/ by default. Built-in assets are repo-owned. Custom pets should be packaged under output/ first and installed into the user's Hermes Pets state directory only when asked.

Package Format

A Hermes custom pet package is a directory with this shape:

text
custom-pet.json
sprites/
  idle/
    idle_00.png
    idle_01.png
  run_right/
    run_right_00.png
  run_left/
    run_left_00.png
contact-sheet.png       optional
README.md               optional

custom-pet.json:

json
{
  "version": 1,
  "name": "pet-slug",
  "source_format": "hatch-pet",
  "states": {
    "idle": { "fps": 4, "loop": true, "frames": ["idle_00.png"] },
    "waving": { "fps": 8, "loop": false, "fallback": "idle", "frames": ["waving_00.png"] }
  }
}

Required:

  • idle state with at least one real PNG frame.
  • Safe lowercase package name: a-z, 0-9, _, -; starts with a letter or number.
  • Safe PNG filenames without path separators or traversal.

Optional supported states:

  • run_right
  • run_left
  • waving
  • jumping
  • failed
  • waiting
  • running
  • review
  • message_react
  • bubble_react
  • blink

Do not fabricate unsupported states such as drag, hover, walk_left, or walk_right unless the runtime and package validator explicitly support them for the current request.

Workflow

  1. Gather the pet concept, references, display name, and package slug.

If the user does not provide a name, infer a short name from the concept. Keep the slug lowercase and safe. Put all generated work in output/hermes-pet-hatch/<slug>/ or output/hatch-pet-runs/<slug>/.

  1. Use the installed hatch-pet skill for visual generation.

Read and follow:

text
${CODEX_HOME:-$HOME/.codex}/skills/hatch-pet/SKILL.md

Use its normal image generation, row prompt, mirroring, finalization, contact sheet, and review rules. Do not draw, tile, or synthesize replacement visuals with local scripts. Only mirror run_left from run_right when the hatch-pet rules say the pet is safe to mirror.

Show full SKILL.md (167 more words)Show less
  1. Generate only Hermes-supported rows.

Map hatch-pet row names to Hermes states:

text
idle           -> idle
running-right  -> run_right
running-left   -> run_left
waving         -> waving
jumping        -> jumping
failed         -> failed
waiting        -> waiting
running        -> running
review         -> review

Missing optional states are acceptable because the overlay falls back to idle or the manifest state's fallback. Do not invent drag, hover, or walk rows just to fill gaps.

  1. Package the finalized run.

Preferred command:

bash
python scripts/package-custom-pet.py \
  --source output/hatch-pet-runs/<slug> \
  --name <slug> \
  --output output/hermes-pet-hatch/<slug>/package

For a built-in fixture or compatibility test:

bash
python scripts/package-custom-pet.py \
  --builtin-species fox \
  --name fox-fixture \
  --output output/hermes-pet-hatch/fox-fixture/package
  1. Validate the package.
bash
python scripts/validate-custom-pet.py output/hermes-pet-hatch/<slug>/package
hermes-pet custom-pet validate output/hermes-pet-hatch/<slug>/package

Validation must pass before calling the pet ready. It checks required idle, real PNG signatures, safe filenames, safe state names, and manifest-compatible state metadata.

  1. Preview and inspect.

Use the hatch-pet contact sheet and videos from the finalized run first. If a package includes contact-sheet.png, inspect it before import. Confirm identity consistency, transparent backgrounds, readable small silhouette, and state-specific motion.

  1. Import only when requested or when the task explicitly includes installation.
bash
hermes-pet custom-pet import output/hermes-pet-hatch/<slug>/package --name <slug>
hermes-pet custom-pet use <slug>
hermes-pet custom-pet current

The import destination is outside the repo under the active Hermes Pets state dir:

text
${HERMES_PET_HOME:-~/.hermes_pet}/custom-pets/<slug>/

Verification

For creation-only work:

bash
python3 -m compileall -q src/hermes_pet
python3 scripts/validate-custom-pet.py output/hermes-pet-hatch/<slug>/package

For runtime/import work:

bash
hermes-pet custom-pet validate output/hermes-pet-hatch/<slug>/package
hermes-pet custom-pet import output/hermes-pet-hatch/<slug>/package --name <slug>
hermes-pet custom-pet use <slug>
hermes-pet custom-pet current
node --check overlay/src/renderer.js overlay/src/main.js overlay/src/main.windows.js overlay/src/preload.js
python3 scripts/validate-sprite-manifest.py
hermes-pet doctor

Keep generated packages and hatch outputs in output/. Do not push, tag, or add remotes.

© asimons81, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/hermes-pet-hatch of asimons81/hermes-pets.

Open the folder on GitHubat commit 16f3493

Compare with similar skills

Hermes Pet Hatch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hermes Pet Hatch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hermes Pet Hatch this skillasimons81/hermes-pets105—~1.3kAutomated safety check: PassMIT
Hatch Petnexu-io/open-design100k—~6kAutomated safety check: PassApache-2.0
Hatch PethAcKlyc/MyAgents9191 repos~9.5kAutomated safety check: PassApache-2.0
Animejs Animationsickn33/agentic-awesome-skills47k2 repos~681Automated safety check: PassMIT
SVG Character Animationcalesthio/OpenMontage66k—~421Automated safety check: PassMIT
Hermes Importsaffaan-m/ECC276k—~324Automated safety check: PassMIT

Similar skills

  • Hatch Pet

    nexu-io/open-design

    Create, repair, validate, preview, and package Codex-compatible animated pet spritesheets from character art, screenshots, generated images, or visual references.

    100k GitHub stars~6k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Hatch Pet

    hAcKlyc/MyAgents

    Create, repair, validate, visually QA, and package MyAgents/Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual…

    919 GitHub starsUsed in 1 repo~9.5k tokens
    Game DevelopmentAuto-check passed
  • Animejs Animation

    sickn33/agentic-awesome-skills

    Advanced JavaScript animation library skill for creating complex, high-performance web animations.

    47k GitHub starsUsed in 2 repos~681 tokens
    Frontend & DesignAuto-check passed
  • SVG Character Animation

    calesthio/OpenMontage

    Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

    66k GitHub stars~421 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Hermes Imports

    affaan-m/ECC

    将本地 Hermes 操作员工作流转换为经过清理的 ECC 技能和发布包工件。在准备将 Hermes 工作流用于公共 ECC 重用而不泄露私有工作区状态、凭据或仅本地路径时使用。

    276k GitHub stars~324 tokensUpdated yesterday
    Auto-check passed
  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    60k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed

Questions about Hermes Pet Hatch

What does Hermes Pet Hatch do?

Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs. Hermes Pet Hatch is an agent skill from asimons81/hermes-pets. Create Hermes Pets-compatible custom animated pet packages from text prompts, references, or hatch-pet finalized runs.

When should I use Hermes Pet Hatch?

Hermes Pet Hatch fits situations like: A user wants to generate; install custom Hermes Pets animated pets without modifying built-in repo assets.

How do I install Hermes Pet Hatch in Claude Code?

Run `npx skills add asimons81/hermes-pets --skill hermes-pet-hatch -a claude-code`. Or copy the skill folder (.codex/skills/hermes-pet-hatch in asimons81/hermes-pets) into .claude/skills/hermes-pet-hatch in your project. Claude Code loads it when a task matches its description.

How do I install Hermes Pet Hatch in Codex?

Run `npx skills add asimons81/hermes-pets --skill hermes-pet-hatch -a codex`. Or copy the skill folder (.codex/skills/hermes-pet-hatch in asimons81/hermes-pets) into .agents/skills/hermes-pet-hatch in your project. Codex loads it when a task matches its description.

Can I use Hermes Pet Hatch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asimons81/hermes-pets --skill hermes-pet-hatch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hermes-pet-hatch, .gemini/skills/hermes-pet-hatch, .github/skills/hermes-pet-hatch and .opencode/skills/hermes-pet-hatch in your project.

What does Hermes Pet Hatch need to run?

Going by SKILL.md and its folder, Hermes Pet Hatch needs the command-line tools its instructions call (python, python3 and node). Our summary lists: Python 3.

Does Hermes Pet Hatch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hermes Pet Hatch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hermes Pet Hatch use?

Hermes Pet Hatch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hermes Pet Hatch use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hermes Pet Hatch?

Skills that share tags, products or a category with Hermes Pet Hatch: Hatch Pet (nexu-io/open-design, 100k stars), Hatch Pet (hAcKlyc/MyAgents, 919 stars), Animejs Animation (sickn33/agentic-awesome-skills, 47k stars) and SVG Character Animation (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hermes Pet Hatch?

asimons81 (a GitHub user) maintains it in asimons81/hermes-pets, which has 105 GitHub stars. The repository was last updated on July 10, 2026.

Source: asimons81/hermes-pets on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.