# Create a Custom Codex Pet from One Image

Custom Codex Pet atlases are difficult to size, animate, and install correctly. This skill generates one canonical sprite and assembles the required atlas and manifest.

## Install

```bash
npx skillstore add agentspace-so/codex-pet
```

## Metadata

- Status: approved
- Slug: agentspace-so-codex-pet
- Skillstore revision: r2
- Version status: missing
- Tree hash: 88f96bc7301b4395cba49a87f9307dad2423d79b0eb47c8d170ceb7a661470f2
- Author: agentspace-so
- GitHub username: agentspace-so
- License: MIT
- Repository: https://github.com/agentspace-so/runcomfy-agent-skills/tree/main/codex-pet/
- Ref: 181fdefcafd96b041926e61c4b2e306ca7e7820e
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/agentspace-so-codex-pet
- Manifest: https://skillstore.pages.dev/api/skills/agentspace-so-codex-pet/manifest

## Capabilities

- Generates one canonical pet sprite from a public reference image URL.
- Normalizes the sprite into transparent 192 by 208 pixel cells.
- Builds nine animation rows with fixed frame counts and transparent trailing cells.
- Composes a 1536 by 1872 WebP atlas using ImageMagick.
- Creates the pet manifest and installs both files in the Codex pets directory.

## Use Cases

- Personal Desktop Companion: Turn a portrait, mascot, or object into a pet for a personal Codex installation.
- Team Mascot Pack: Create consistent pets from approved brand images for team members who use Codex.
- Repeatable Pet Production: Apply the same atlas recipe to several source images while reviewing each generated pose.

## Prompt Templates

### Create a Basic Pet

```
Create a Codex Pet named {safe_slug} from {public_image_url}. Use the default style and install it after I approve the preview.
```

### Preserve Key Features

```
Create a Codex Pet from {public_image_url}. Preserve {identity_features}, avoid magenta details, and show the canonical pose before atlas assembly.
```

### Tune the Animation

```
Build a pet named {safe_slug}. Use {public_image_url}, increase the jump slightly, and keep all other motion subtle.
```

### Produce an Approved Batch

```
Generate pets for these public image URLs. Use unique safe slugs, review every canonical pose, and install only approved results.
```

## Limitations

- Requires a RunComfy account, authentication token, RunComfy CLI, and ImageMagick.
- Sends the source image URL and generation prompt to a third-party service.
- Uses transforms of one pose, so it cannot create complex frame-by-frame motion.
- Chroma-key removal can damage near-magenta details, and generated identity may drift.

## Best Practices

- Use a public, non-sensitive image URL and confirm third-party processing before generation.
- Choose a short lowercase slug and verify the resolved installation path before writing files.
- Review the canonical sprite before building the atlas because later steps reuse that pose.

## Anti Patterns

- Do not use private, signed, or internal image URLs for remote processing.
- Do not place unvalidated user text into shell variables or destination paths.
- Do not increase movement beyond the fixed cell boundaries or required frame counts.

## Security Audit

- Audited at: 2026-07-23T08:34:12.583\+00:00
- Summary: Most static alerts are false positives caused by Markdown code formatting, documentation links, and safe shell arithmetic. Confirmed risks include mutable package installation and an unvalidated pet name that can redirect local writes. The workflow also sends image data to a third-party service.

## Stats

- Views: 79
- Downloads: 7
- Favorites: 0
- Popularity score: 0