skills.rest
agentspace-so
agentspace-soOFFICIAL
Explore all skills by this author →
GitHub

codex-pet

Generate a Codex-compatible pet.json and spritesheet.webp from one reference image.

31|9|Updated Apr 30, 2026
Search Tags:#image generation#imagemagick#pixel art#sprite atlas#runcomfy cli#codex pet#desktop companion
One-click install
npx skills add https://github.com/agentspace-so/runcomfy-agent-skills --skill codex-pet-agentspace-so
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-pet
Source: https://github.com/agentspace-so/runcomfy-agent-skills/tree/main/codex-pet
Command: npx skills add https://github.com/agentspace-so/runcomfy-agent-skills --skill codex-pet-agentspace-so

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex Pet creators need a fast way to turn a single reference image into the exact animated sprite atlas and manifest that Codex expects, without setting up Codex Pro image-generation tooling.

Core Features & Use Cases

  • Codex Pet artifact generation: Creates pet.json and spritesheet.webp in the required atlas format (1536x1872, 8x9 cells) from one source image.
  • Deterministic local build pipeline: Runs a single GPT Image 2 edit call via the RunComfy CLI, then assembles the 9 animation-state rows using ImageMagick micro-transforms.
  • Local installation for Codex: Installs the custom pet into ${CODEX_HOME:-$HOME/.codex}/pets/<name>/ for immediate pickup by Codex.
  • Use case: Give your Codex desktop experience a personalized animated companion by uploading or linking a character/mascot image and generating a compliant custom pet.

Quick Start

Tell the agent to create a codex pet from the attached reference image for the pet name my-pet and install it into your 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 create a custom desktop pet sprite atlas from a single image?▼

To create a custom desktop pet sprite atlas from a single image, you need a pipeline that generates a 1536x1872 spritesheet and a manifest. This Skill uses RunComfy and ImageMagick to assemble 9 animation states from one reference image.

What is the exact sprite atlas format required for Codex pets?▼

The Codex pet sprite atlas format requires a 1536x1872 pixel spritesheet arranged in an 8x9 cell grid with 192x208 pixel frames. This Skill generates the compliant spritesheet.webp and pet.json manifest automatically.

Do I need Codex Pro to generate custom pets?▼

You do not need Codex Pro to generate custom pets. This Skill bypasses Codex Pro by using the RunComfy CLI to call openai/gpt-image-2/edit exactly once, followed by deterministic ImageMagick transforms to build the atlas.

How to install a custom pet into the Codex pets directory?▼

To install a custom pet into the Codex pets directory, the generated pet.json and spritesheet.webp files must be written to ${CODEX_HOME:-$HOME/.codex}/pets/<name>/. This Skill handles the local installation automatically.

What dependencies are needed to generate a pixel art pet manifest?▼

To generate a pixel art pet manifest, you need a RUNCOMFY_TOKEN for the RunComfy CLI and ImageMagick installed locally. These tools perform the single image edit call and the chroma-keying for frame normalization.

Can I use a single reference image for all 9 animation states?▼

Yes, you can use a single reference image to generate all 9 animation states. This Skill applies ImageMagick micro-transforms to the source image to deterministically populate the 9 rows of the sprite atlas without requiring multiple inputs.

Related Skills

Explore More Design & Creative Skills→
prime-skillsprime-skills
31

image-to-video

Routes still-image animation requests to the appropriate RunComfy video generation model.

Official
Advanced
runcomfy-comruncomfy-com
12

codex-pet

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

Official
Advanced
pingqLINpingqLIN

hatch-pet

Hatch Codex-compatible animated pets from concepts or reference images.

Community
Advanced
prime-skillsprime-skills
31

codex-pet

Creates a custom Codex Pet from a reference image URL and installs it locally.

Official
Advanced