PlugWiki

hatch-pet: OpenAI's skill for making a custom Codex pet

hatch-pet is OpenAI's Codex agent skill that turns your character art or idea into a custom animated Codex pet.

Installs
3.4K
on skills.sh
Stars
28.4K
on GitHub
Files
13
besides SKILL.md
Updated
Oct 2026
last repo commit

hatch-pet is OpenAI's Codex agent skill that turns your character art or idea into a custom animated Codex pet. A Codex pet is a small companion in the ChatGPT desktop app and the Codex CLI that shows whether a chat is running, needs input, is ready or is blocked. Describe a character, give a brand name or attach pictures, and the skill generates the art, builds the animation sheet and saves the pet. Pets only show up in Codex, and a good one can take a few tries.

Good for

  • Codex users who want their own pet instead of a built-in one
  • Designers and illustrators who already have character art to animate
  • Teams that want a mascot pet from a company or brand name
  • People who run several agents and want a glanceable status signal

Install hatch-pet

Codex

  1. 1

    Open Settings > Pets in the ChatGPT desktop app and select Create pet.

  2. 2

    The app installs the bundled hatch-pet skill, reloads skills and opens a new chat.

  3. 3

    Describe your pet or attach art, then run it to the end.

  4. 4

    When it finishes, select Refresh in Settings > Pets and choose your pet.

Requires Python 3 with Pillow, jq.

Pets only show in Codex, so there is no Claude Code or Cursor setup. SKILL.md runs its scripts from ~/.codex/skills/hatch-pet, which is where both methods above put the skill. The Codex CLI shows custom pets, and the IDE extension has no pet display. The openai/skills repo is marked deprecated in its README, so the desktop app route is the safer default.

From the vendor's docs. Source.

What's in the skill

When it loads

Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.

Sections in SKILL.md

  1. Overview
  2. Generation Delegation
  3. Storage Controls
  4. Brand Discovery
  5. Pet-Safe Styles
  6. Transparency And Effects
  7. Visible Progress Plan
  8. Default Workflow
  9. Lightweight Visual Workers
  10. Subagent Delegation
  11. Repair Workflow
  12. Rules
  13. Acceptance Criteria

Key facts

Author
OpenAI
Installs on skills.sh
3.4K (Nov 2, 2026)
Last change to the skill
May 12, 2026

What it includes

  • Looks up brand cues on the web when you give only a company name

    Optional. If you give a description or pictures instead, this step is skipped.

    Try: “$hatch-pet make a pet for Stripe”

    Network · Brand discovery

  • Sets up the run folder, prompts and layout guides, and picks a name and style

    Chooses a name (Sprout by default), a style preset and a background color for cutting the art out, then writes the job list.

    Files · prepare_pet_run.py

  • Generates the main look of your pet with Codex's image skill

    One picture of the pet that every animation row is drawn from.

    Network · Base image

  • Generates one strip per state: idle, running, waving, jumping and more

    Up to 10 image jobs in total, one base plus nine rows, with at most two running at once.

    Network · Nine animation rows

  • Mirrors the running-right row into running-left

    Used only after the right-facing row looks safe to flip.

    Files · derive_running_left_from_running_right.py

  • Cuts each strip into 192x208 pixel frames

    Has a stable-slots mode that stops the pet from changing size between frames.

    Files · extract_strip_frames.py

  • Flags frames with stray edge pixels, empty frames or leftover background color

    Writes a review file that the visual check reads.

    Read · inspect_frames.py

  • Builds the 1536x1872 sprite sheet as PNG and WebP

    A grid of 8 columns by 9 rows, one row per pet state.

    Files · compose_atlas.py

  • Checks the sheet size, grid and empty cells

    Writes a validation report next to the finished sheet.

    Read · validate_atlas.py

  • Makes one labeled overview image of every frame for review

    Lets you and the skill spot drift in the pet's look.

    Files · make_contact_sheet.py

  • Makes a GIF preview for each pet state

    Saved in a previews folder so you can watch each animation.

    Files · render_animation_previews.py

  • Reviews previews for look drift, wrong direction and popping, then redraws only the bad ro

    You do not have to restart the whole pet to fix one animation.

    Try: “$hatch-pet repair the waving row of my pet Sprout”

    Network · Visual check and repair

From the official docs

Permissions

Low risk

hatch-pet only runs local image scripts and saves files into your Codex folder, but it deletes its own working files and can search the web when you give only a brand name. The skills.sh audits show Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn, and no security advisories are listed for the repo.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Brand names trigger a web search

    Snyk rates this Warn (medium) because the skill reads outside web pages to find brand cues. Give a description or pictures instead if you want no web search. skills.sh

  • It deletes its own generated images and run files

    After copying each picked image it removes the original from ~/.codex/generated_images, and it clears working files after checks. Ask to keep debug files if you want them. github.com

  • Create pet has overwritten an installed hatch-pet folder

    Users report the app replacing a hatch-pet folder installed another way, and deleting it on some Windows builds. Back up the folder before you click Create pet. github.com

  • Failed image attempts can still use your quota

    A user reports that failed image generation on Windows still counted against usage. Watch your usage if generation keeps failing. github.com

  • Runs eight local Python scripts

    They use Pillow to cut frames, build the sheet and make previews, and contain no network calls or subprocesses. Python with Pillow and jq must be on your machine. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyNo read-only mode. The skill writes a run folder and the finished pet, and deletes its own intermediate files after QA unless you ask to keep debug files.
Talks toImage generation through Codex's built-in $imagegen tool. Web search for brand cues, only when you give a brand name instead of a description or pictures. api.openai.com, only if you ask for the optional OPENAI_API_KEY fallback
Sign-in and keysNo key by default. The optional image fallback reads OPENAI_API_KEY from your environment and runs only if you ask for it.
Data retentionBuilt-in image generation stores image bytes in your Codex session log, and deleting the files later does not shrink it.
Scopes
  • Writes a run folder under the folder you start in (./output/hatch-pet/...)

  • Writes the finished pet to ~/.codex/pets/<pet>/

  • Deletes its own generated images and working files after checks

What people say

People like having a pet that shows what their agents are doing, and complain that a usable pet takes several tries.

What people like

  • A pet gives a visible signal of what your agents are doing and when they need attention.
  • The skill shows labeled previews and checks the sheet before it saves the pet.

Common complaints

  • Getting a usable pet took several tries for people on the OpenAI forum.
  • Pets stay on the machine where they were made and do not sync to ChatGPT web.
  • Create pet fails for some Windows setups and has overwritten an installed hatch-pet folder.

In their words

Examples

  • The default prompt OpenAI ships with the skill

    Use $hatch-pet to create a Codex-compatible animated pet in any pet-safe style from a concept, company brand, or reference image.

    Source
  • Text-only pet: no reference picture, so the skill draws a base image first

    $hatch-pet a sleepy red panda with a tiny laptop, plush style

  • Mascot pet from just a company name, using a web search for brand cues

    $hatch-pet make a pet for Stripe

  • Fix one broken animation row instead of redoing the whole sheet

    $hatch-pet repair the waving row of my pet Sprout

  • Workaround a user posted when Create pet would not start

    Use the https://github.com/openai/skills/tree/main/skills/.curated/hatch-pet skill to generate a pet for me: <Pet Description>

    Source

Questions

How do I install hatch-pet?

Use the install box above. In the ChatGPT desktop app, open Settings > Pets and select Create pet, which installs the skill for you. Or run the install command inside Codex and restart Codex if the skill does not appear.

How do I make and use a custom Codex pet?

Run Create pet or type $hatch-pet in a Codex chat, then describe the character or attach art. When the task finishes, open Settings > Pets, select Refresh and choose your pet. The skill saves it as pet.json and spritesheet.webp in ~/.codex/pets/<pet>/. Type /pet to show or hide it.

Does hatch-pet work in Claude Code?

No. No source documents it. The skill calls Codex's own image skill and saves to ~/.codex/pets, and only Codex shows pets. If you need a Claude Code extra, this is not it.

Does it work in the Codex CLI, the IDE extension and ChatGPT web?

The CLI can show custom pets, in iTerm2 3.6 or newer or a terminal with Kitty graphics or Sixel, and not inside tmux or Zellij. The IDE extension has no pet picker. Pets made in the desktop app do not sync to ChatGPT web, where you can only upload a finished 1536 x 1872 sprite sheet.

Do I need an OpenAI API key for hatch-pet?

No. The default path uses Codex's built-in image tool, which needs no key. Only the optional fallback needs OPENAI_API_KEY, and it runs only if you ask for it.

Is hatch-pet safe?

Mostly. Its scripts only process images on your machine, and it writes to a run folder and ~/.codex/pets. skills.sh shows Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn, where the warning is about web search for brand cues.

Is hatch-pet deprecated?

The openai/skills README says that repository is deprecated and points to openai/plugins, where hatch-pet is not listed. The skill still works, and the desktop app installs its own copy through Create pet.

Why does Create pet say Unable to start pet creation?

On Windows this has two reported causes. With the WSL agent environment, switch the agent environment to Windows, fully restart the app and try again. Microsoft Store builds also fail, and that issue is still open. Another report says the bundled skill was missing, and asking Codex to use the hatch-pet skill from its GitHub URL worked around it.

Why did Create pet delete or overwrite my hatch-pet folder?

Users report that Create pet replaces a hatch-pet folder installed with the skill installer, and on some Windows builds deletes it. Back up the folder first and reinstall the skill if it disappears.

Why does Codex disconnect while making my pet?

A report on the Codex CLI says the stream disconnects when the workflow reaches image generation. Restart and run it again, and ask Codex to repair only the failing row instead of starting over. The issue is still open.

Information

updated Nov 2, 2026

Repository
openai/skills
Folder
skills/.curated/hatch-pet

Codex pets (OpenAI docs)openai/skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 31
  1. Pets · learn.chatgpt.com
  2. openai/skills README · github.com
  3. hatch-pet SKILL.md · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. hatch-pet on skills.sh · skills.sh
  7. github.com · github.com
  8. github.com · github.com
  9. github.com · github.com
  10. github.com · github.com
  11. github.com · github.com
  12. github.com · github.com
  13. github.com · github.com
  14. github.com · github.com
  15. github.com · github.com
  16. github.com · github.com
  17. github.com · github.com
  18. github.com · github.com
  19. imagegen SKILL.md · github.com
  20. Create pet with WSL agent environment · github.com
  21. Create pet on Microsoft Store builds · github.com
  22. Create pet shows Unable to start pet creation · github.com
  23. Hatch Pet skill directory is overwritten after using Create Pet workflow · github.com
  24. Codex CLI stream disconnects when running hatch-pet imagen workflow · github.com
  25. Gen Agent Trust Hub audit · skills.sh
  26. Socket audit · skills.sh
  27. Snyk audit · skills.sh
  28. Image generation unavailable in the Windows app · github.com
  29. openai/skills security advisories · github.com
  30. Show us your custom Codex Pet · community.openai.com
  31. openai.yaml · github.com

Updated Nov 2, 2026.