hatch-pet

Generate Codex-compatible pet spritesheets and package assets from reference art.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/BoChao1Zhang/dotfiles --skill hatch-pet-bochao1zhang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hatch-pet
Source: https://github.com/BoChao1Zhang/dotfiles/tree/main/dot_codex/skills/hatch-pet
Command: npx skills add https://github.com/BoChao1Zhang/dotfiles --skill hatch-pet-bochao1zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides an end-to-end workflow to generate Codex-compatible animated pet spritesheets from reference art, manage QA, and package the result for the Codex app.

Core Features & Use Cases

  • End-to-end pet sprite generation: base art to 1536x1872 atlas; deterministic row generation; built-in QA and packaging.
  • Supports reference images, layout guides, and chroma-keyed backgrounds; integrates with $imagegen for visual generation.
  • Use Case: Hatch a Codex pet from art and references and produce a packaged asset bundle.

Quick Start

Run the hatch-pet process with your reference images to generate a ready-to-package Codex pet.

Frequently Asked Questions about hatch-pet

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

FAQPage Schema
How do I generate animated pet spritesheets from reference art?▼

Animated pet spritesheets are generated by coordinating base art, layout guides, and deterministic row generation via the built-in imagegen skill. This workflow hatches Codex-compatible pets from reference images, producing a complete 1536x1872 atlas and packaged assets.

What is the process for assembling a sprite atlas with chroma-keyed backgrounds?▼

Assembling a sprite atlas with chroma-keyed backgrounds involves using deterministic scripts for automated row generation and atlas assembly. The workflow supports chroma-key handling to isolate ground-truth reference art before packaging the final spritesheet.

Can I use Pillow to package spritesheet assets for the Codex app?▼

Pillow is required to package spritesheet assets for the Codex app. The workflow uses Pillow to handle image processing tasks, chroma-keying, and the final assembly of the 1536x1872 atlas into a packaged asset bundle.

Does Codex pet sprite generation support automated QA and validation?▼

Codex pet sprite generation supports automated QA and validation through deterministic scripts. These scripts handle atlas assembly, chroma-key validation, and packaging to ensure the final pet.json and spritesheet.webp meet quality standards.

What's the best way to automate pet.json and spritesheet.webp creation?▼

The best way to automate pet.json and spritesheet.webp creation is through the end-to-end hatch-pet workflow. It coordinates base art generation, deterministic row assembly, and automated validation to deliver a complete, packaged Codex asset bundle.

Why does my sprite atlas need layout guides and ground-truth references?▼

Layout guides and ground-truth references are needed to ensure deterministic row generation in the sprite atlas. They provide the structural framework and visual baseline required for accurate chroma-key handling and consistent atlas assembly.