hatch-pet

Generate and package Codex-compatible v2 animated pet spritesheets from art or brand references.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill hatch-pet-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hatch-pet
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/hatch-pet
Command: npx skills add https://github.com/Chau165/local_skill --skill hatch-pet-chau165

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve? Creating a Codex-compatible animated pet requires producing a precise 8x11 sprite atlas with 9 animation states and 16 look directions, plus deterministic validation and packaging, which is impractical to do by hand. ## Core Features & Use Cases - End-to-End Pet Generation: Creates a base character from text, reference art, or researched brand cues, then generates all 9 standard animation rows and 16 look directions via the imagegen skill. - Deterministic Assembly and QA: Bundled Python scripts extract frames, mirror running-left, compose atlases, suppress chroma spill, and validate every cell before packaging. - Repair and Upgrade Workflows: Accepts existing 8x9 or 8x11 atlases, repairs failed rows or look cells, and repackages them with spriteVersionNumber 2. - Use Case: Give the assistant a company name; it researches the brand, designs a mascot, generates all animation rows, validates them, and installs a ready-to-use pet package under the Codex pets directory. ## Quick Start Ask the assistant to hatch a new Codex pet named after your brand or character idea and package it as a v2 spritesheet.

Frequently Asked Questions about hatch-pet

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

FAQPage Schema
How do I create a custom Codex pet spritesheet?

Provide a name, description, or reference images and the skill generates a base character, nine animation rows, and sixteen look directions. It then assembles the 8x11 atlas, runs QA, and packages it with spriteVersionNumber 2.

What format does a Codex v2 pet atlas use?

A v2 pet atlas is a 1536x2288 PNG or WebP image with an 8-column by 11-row grid of 192x208 cells. Rows 0-8 hold standard animation states and rows 9-10 hold 16 clockwise look directions.

Can I create a pet from a company or brand name?

Yes, the skill runs a brand discovery step that researches official sources for palette, tone, and mascot cues before generation. The resulting brief guides the pet design without copying logos or trademarked marks.

Can existing pet atlases be repaired or upgraded?

Existing 8x9 atlases are validated and extended with generated look-direction rows, while 8x11 atlases can have failed rows regenerated. Approved standard rows are preserved and the result is repackaged as v2.

Why does pet generation require the imagegen skill?

All visual generation is delegated to the imagegen skill so it controls the built-in image path and fallback rules. The hatch-pet scripts only perform deterministic work like extraction, mirroring, assembly, and validation.

What are the limitations on animation effects in pet sprites?

Effects must be attached to the pet silhouette, opaque, and free of chroma-key colors. Detached sparkles, shadows, motion lines, text, and floating symbols are rejected because they break transparency cleanup and component extraction.