codex-pet
Build Custom Codex Pets from Any Image
Also available from: agentspace-so
Create a custom animated Codex pet spritesheet from a single reference image. The skill generates pixel-art style companions with 9 animation states using RunComfy GPT Image 2 API and ImageMagick. Drop the result into your Codex pets folder for a personalized desktop companion.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "codex-pet". Create a codex pet from https://example.com/photo.jpg
Expected outcome:
Generated pet 'my-pet' installed at ~/.codex/pets/my-pet/ with spritesheet.webp (1536x1872, 9 animation rows) and pet.json manifest. Restart Codex to see the new pet in your selection.
Using "codex-pet". Make a codex pet named ninja-cat from https://example.com/cat.png with description 'A stealthy feline companion'
Expected outcome:
Codex Pet 'ninja-cat' created and installed. Spritesheet includes idle, running-right, running-left, waving, jumping, failed, waiting, running, and review animation states. All cells follow required frame counts per Codex specification.
Using "codex-pet". Adjust my-pet animation to have bigger idle movement
Expected outcome:
Idle row modified: shift changed from shift:0:-1 to shift:0:-2 for stronger breathing effect. Updated spritesheet.webp written to ~/.codex/pets/my-pet/. Reload Codex to preview changes.
Security Audit
Medium RiskThis is a legitimate Codex Pet generator that uses RunComfy CLI and ImageMagick to create animated pet spritesheets. The static analysis flagged many patterns (97 command usages, filesystem access) but these are all legitimate tool invocations. The external commands (`runcomfy run`, `magick`) use hardcoded arguments derived from skill logic, not user-controlled shell input. Network calls go only to runcomfy.net endpoints. Path traversal in PET_NAME is a low concern as writes are scoped to the ~/.codex/pets sandbox. Environment variable access is explicit and documented (RUNCOMFY_TOKEN). No credential exfiltration, no data theft patterns, no command injection vectors confirmed. Skill performs exactly what it claims: generates pet spritesheets via API + ImageMagick transforms.
Medium Risk Issues (1)
Low Risk Issues (2)
Risk Factors
⚙️ External commands (6)
🌐 Network access (2)
📁 Filesystem access (2)
🔑 Env variables (2)
Quality Score
What You Can Build
Build a Personal Codex Companion
Take a photo of yourself, your pet, or a character and turn it into a Codex desktop companion. The skill transforms your image into chibi-style pixel art that floats over your code editor.
Batch Generate Pet Spritesheets
Process multiple source images to create several Codex Pets for a team. Each pet installs alongside Codex built-ins so anyone in the team can select their favorite.
Prototype New Pet Animations
Quickly generate and test custom animation timings for pet rows. Tweak ImageMagick micro-transform values to adjust animation feel without regenerating the entire spritesheet.
Try These Prompts
Create a codex pet from this image: [SOURCE_IMAGE_URL]
Make me a codex pet named [PET_NAME] based on [IMAGE_URL]. Description: [PET_DESCRIPTION]
Adjust [PET_NAME] animation: change idle bob to shift:0:-2, make running cycle faster with shift:3:0
Retry generating [PET_NAME] with tighter identity preservation: emphasize [SPECIFIC_FEATURES] from original image
Best Practices
- Use square or near-square source images for best fit in the 192x208 pixel cells
- Choose images with clear silhouettes and simple color palettes for clean chroma-key processing
- When identity preservation matters, describe specific features in the prompt refinement
Avoid
- Do not use source images with magenta backgrounds (conflicts with chroma-key placeholder)
- Avoid feeding complex multi-character scenes as a single source image
- Do not skip backtick code blocks when installing via skills CLI