codex-pet

Generate a Codex-compatible pet spritesheet and manifest from a reference image.

12|2|Updated May 18, 2026
One-click install
npx skills add https://github.com/runcomfy-com/skills --skill codex-pet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-pet
Source: https://github.com/runcomfy-com/skills/tree/main/codex-pet
Command: npx skills add https://github.com/runcomfy-com/skills --skill codex-pet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a Codex-compatible animated desktop pet from a single reference image, removing the manual work of designing and assembling the required sprite atlas and pet manifest.

Core Features & Use Cases

  • Builds the Codex Pet artifact: generates pet.json and spritesheet.webp in the exact size and layout Codex expects (1536x1872 atlas, 8x9 cells, 9 animation rows).
  • Deterministic animation assembly: makes one canonical pose using RunComfy/OpenAI GPT Image 2 edit and then programmatically derives subtle animation states using ImageMagick micro-transforms.
  • Easy local installation: installs the pet into ${CODEX_HOME:-$HOME/.codex}/pets/<name>/ so Codex can load it alongside the built-ins.

Quick Start

Generate a custom Codex Pet atlas and install it by running the codex-pet skill with your source image and pet name and then placing the output files into the local Codex pets directory.

Frequently Asked Questions about codex-pet

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

FAQPage Schema
How do I generate a Codex desktop pet from a single image?

To generate a Codex desktop pet, provide a single reference image and the skill outputs a pet.json manifest and a 1536x1872 spritesheet.webp. It uses OpenAI GPT Image 2 edit and ImageMagick to assemble the required 8x9 cell sprite atlas.

What is the required sprite atlas format for Codex pets?

The required Codex pets sprite atlas format is a 1536x1872 spritesheet.webp containing 8x9 cells across 9 animation rows. The skill programmatically normalizes images to 192x208 cells to match this canonical layout.

Can I use ImageMagick to create animated desktop mascots?

Yes, you can use ImageMagick to create animated desktop mascots by applying chroma-keying and micro-transforms to derive subtle multi-state motion. This skill uses ImageMagick to assemble the generated poses into the final spritesheet.

How do I install custom pets into a local Codex pets folder?

To install custom pets into a local Codex pets folder, place the generated pet.json and spritesheet.webp files into the ${CODEX_HOME:-$HOME/.codex}/pets/<name>/ directory so Codex can load them alongside built-in mascots.

Does generating a Codex pet require manual sprite animation design?

Generating a Codex pet does not require manual sprite animation design because the skill makes one canonical pose and programmatically derives the 9 animation rows using ImageMagick micro-transforms.

What are the limitations of using a single reference image for desktop pet generation?

The limitation of using a single reference image for desktop pet generation is that animation states are programmatically derived via subtle ImageMagick micro-transforms rather than featuring unique frame-by-frame hand-drawn motion.