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.