codex-pet

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

31|9|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/prime-skills/runcomfy-agent-skills --skill codex-pet-prime-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-pet
Source: https://github.com/prime-skills/runcomfy-agent-skills/tree/main/codex-pet
Command: npx skills add https://github.com/prime-skills/runcomfy-agent-skills --skill codex-pet-prime-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a single reference image into a ready-to-install custom Codex Pet, eliminating the need to manually design animation frames, assemble sprite atlases, or create the required manifest files.

Core Features & Use Cases

  • Reference-Based Generation: Uses one source image and RunComfy GPT Image 2 to create a canonical chibi Codex Pet pose.
  • Deterministic Animation Assembly: Builds nine Codex-compatible animation states with ImageMagick transforms, including idle, running, waving, jumping, failed, waiting, and review.
  • Ready-to-Install Output: Produces the required pet manifest and 1536x1872 WebP spritesheet and installs them in the local Codex pets directory.
  • Use Case: Create a personalized mascot from a pet, character, or brand image and add it to Codex as a desktop companion.

Quick Start

Use the codex-pet skill with a publicly accessible reference image URL to generate and install a custom Codex Pet named my-pet.

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 animated Codex Pet from a single image?

To create a custom animated Codex Pet, you provide a single reference image URL to generate a canonical chibi pose, then automatically assemble nine animation states and a 1536x1872 WebP spritesheet with a matching manifest for local installation.

What is a sprite atlas and do I need to design animation frames manually for Codex?

A sprite atlas is a composite image containing multiple animation frames. You do not need to design frames manually; the process uses ImageMagick transforms to deterministically build nine Codex-compatible animation states from one reference image.

Do I need a RunComfy account and ImageMagick to generate a Codex Pet spritesheet?

Yes, generating a Codex Pet spritesheet requires a RunComfy account and token, the RunComfy CLI, and ImageMagick to process the single reference image into the required animation states and manifest.

What is the best way to automate sprite atlas assembly for a personalized mascot?

The best way to automate sprite atlas assembly is using a reference-based generation pipeline that converts one source image into a 1536x1872 nine-row WebP spritesheet, eliminating manual frame design and atlas configuration.

Can I use any image URL to generate a Codex Pet manifest and spritesheet?

You must use a publicly fetchable image URL to generate the Codex Pet manifest and spritesheet. The pipeline processes this single reference image into a ready-to-install WebP spritesheet and manifest file.

What animation states are included in a Codex Pet spritesheet?

A Codex Pet spritesheet includes nine animation states: idle, running, waving, jumping, failed, waiting, and review. These are built deterministically using ImageMagick transforms from a single reference image.