Skip to main content
skill CX Codex

scenario-chatgpt-pet-update — Claude Code pet sprite skill

scenario-chatgpt-pet-update edits existing ChatGPT and Codex pet sprite sheets with Scenario by fixing frame jumps, redrawing cycles, and exporting preview GIFs.

MIT 592 installs ★ 3,964 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add scenario-labs/skills --skill scenario-chatgpt-pet-update -a claude-code
Open on GitHub

What scenario-chatgpt-pet-update does

This skill manages edits on existing pet sprite sheets stored as PNG, WebP, or Codex folders containing pet.json. Instead of overwriting source files, the process exports an updated package alongside the run directory. It drives frame extraction, baseline alignment, and health checks through command-line utilities.

You can tweak isolated states like running or jumping while leaving untouched animation rows intact. For deeper overhauls, it guides prompt adjustments to recolor characters or add accessories. The scripts fail immediately if the sibling skill scenario-chatgpt-pet-create is missing from the environment.

What it helps with

  • realign jittery frames along a shared ground anchor
  • regenerate single animation rows without touching other states
  • apply accessories or new outfits to an existing pet sheet
  • generate an animated GIF preview to verify pet motions

Example prompts for the agent

  • Check pepper.png and render an animated GIF preview
  • Reregister frames in the running row for ~/.codex/pets/pepper/
  • Clean up stray pixels under transparency in this pet sheet

How to install scenario-chatgpt-pet-update

1Skills CLI (Vercel)

npx skills add scenario-labs/skills --skill scenario-chatgpt-pet-update -a claude-code

2Manually: put the files in place

~/.claude/skills/scenario-chatgpt-pet-update/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/scenario-chatgpt-pet-update/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about scenario-chatgpt-pet-update

How do I install scenario-chatgpt-pet-update in Claude Code?

Run npx skills add scenario-labs/skills --skill scenario-chatgpt-pet-update -a claude-code in your terminal.

What does scenario-chatgpt-pet-update do?

It adjusts existing ChatGPT and Codex pet sheets, letting you fix frame drift, swap single animations, or recolor assets.

What prerequisites are required?

You must have the sibling skill scenario-chatgpt-pet-create installed because the update workflow runs its internal helper scripts.

Source text

SKILL.md · MIT
---
name: scenario-chatgpt-pet-update
description: "Use when changing an existing ChatGPT pet or Codex pet sprite sheet with Scenario: fixing a broken row, frame, jump or edge, regenerating one animation state, adding the sixteen look directions to a 1536x1872 v1 sheet, giving the pet a new outfit, color or accessory, renaming it in its pet.json, or checking a pet sheet and previewing it as an animated GIF."
license: MIT
---

# Scenario ChatGPT Pet: Update

## Overview

An existing pet is its sprite sheet: a PNG or WebP the user downloaded from ChatGPT, a Codex pet
folder (`pet.json` plus the sheet it names), or a Scenario asset id of a sheet made earlier. That
file is the pet's identity here; there is no pet record to look up. The update never overwrites it:
the result is a new package next to the run, with the same id and name unless the user changes them.

This skill runs the scripts and follows the sheet contract of `scenario-chatgpt-pet-create`, which
must be installed; run each script by its path in that skill's `scripts/` folder, from the user's
working folder, and read the contract before generating a row or writing direction verdicts:
[pet_frames.py](../scenario-chatgpt-pet-create/scripts/pet_frames.py),
[pet_prepare.py](../scenario-chatgpt-pet-create/scripts/pet_prepare.py),
[pet_build.py](../scenario-chatgpt-pet-create/scripts/pet_build.py),
[pet_check.py](../scenario-chatgpt-pet-create/scripts/pet_check.py),
[pet_preview.py](../scenario-chatgpt-pet-create/scripts/pet_preview.py),
[pet_package.py](../scenario-chatgpt-pet-create/scripts/pet_package.py), and
[the contract](../scenario-chatgpt-pet-create/references/sheet-contract.md). Generation follows that
skill's loop and model order (`model_openai-gpt-image-2-5-sunburst`, then
`model_google-gemini-nano-banana-2-1`, then `recommend` only when both are blocked); connection and
scope: the `scenario` skill. If a sibling skill named here is missing from your available skills,
load it with `skill_get` (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.

## Quick reference

Read the sheet first, then pick the smallest change that does the job. Every row below runs in a run
made by `pet_prepare.py init --from-split` (step 3 of the example): it records the original sheet,
which the build, the check and the package all need. Unattended, the approvals are your own judgment
against the request, recorded in the run, and nothing is installed.

| The user wants                                 | Do                                                                                                                  | Generations   |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------- |
| To see or check it                             | `pet_check.py`, `pet_preview.py contact` and `gif`                                                                  | 0             |
| A rename or new description                    | `init`, `pet_check.py <sheet> --run RUN`, then `pet_package.py make RUN --sheet <sheet> --name ...`                 | 0             |
| Leftover pixels, color under transparency      | `pet_build.py RUN --clean`                                                                                          | 0             |
| A row whose frames pop up and down or sideways | `pet_build.py RUN --reregister <row>`: re-places the existing frames on one ground line and anchor                  | 0             |
| One or a few states redone                     | `init --only <rows>` (a look row too), generate those rows, `pet_build.py RUN`: every other row stays byte for byte | one per row   |
| Look directions on a v1 sheet                  | `init --version 2 --only look`: cardinals, then rows 9 and 10                                                       | 3             |
| A new look (outfit, color, accessory)          | `init --change "<the change>"`: edit the identity, approve it, regenerate every row                                 | 1 + every row |

`split` refuses anything that is not 1536x1872 or 1536x2288: other art is a new pet, made with
`scenario-chatgpt-pet-create` using that art as a reference.

## Worked example: Pepper's stiff run, then a red scarf for next season

1. **Get the sheet.** The user points at `~/.codex/pets/pepper/`: read `pet.json` (`id`,
   `displayName`, `description`, `spritesheetPath`) and copy the sheet into a work folder. From an
   asset id: `asset_download` with `format: "png"`, then `curl -L`.
2. **Read it.** `pet_frames.py split pepper.png --out work/split` prints the version, a background
   key that contrasts with the pet, and `pixel_grid` (set when the sheet is pixel art with on/off
   alpha; the update then keeps that grid and palette).
   `pet_check.py pepper.png --json-out work/before.json` measures it: height per row against idle,
   jump lift, look-row drift. `pet_preview.py contact` and `pet_preview.py gif` show the current
   pet. Ask what should change if the request is vague, naming what the check found.
3. **Redo the run.**
   `pet_prepare.py init --name Pepper --id pepper --description "<from pet.json>" --from-split work/split --only running-right,running-left --out work/run`
   (every row of the table starts with an `init --from-split` like this; `--only` names the rows to
   generate). The `match` style keeps the sheet's look; each job's `references` are
   `references/base.png` (the idle frame, enlarged on the key) and `references/rows/<row>.png` (the
   current row). Each job maps onto one `model_run`: its `references` uploaded with `upload_asset`
   and passed as `referenceImages` (an array), its `prompt` verbatim, its `sizes` for the model,
   `background: "opaque"` on Sunburst, priced with `dry_run` first; download the result to the job's
   `output`. When the old row's motion or directions are what is wrong (a jump that never lifts, a
   run that does not alternate, a head that turns the wrong way), add `--no-current-row` to `init`
   so the old strip is not a reference, since the model copies what it is shown, and say what
   changes with `pet_prepare.py note work/run --jobs <row> --text "..."`; a redone look row still
   references the kept other half of the sweep. Then
   `pet_frames.py extract work/run --job running-right`, read the report and preview, and mirror it
   with `--mirror-left` or generate `running-left` the same way.
4. **Rebuild.** `pet_build.py work/run --mirror-left`. With the original sheet as the base (recorded
   by `init`), only the rebuilt rows change, scaled to the existing idle row's height, ground line
   and anchor; the edge cleanup touches only them.
   `pet_check.py work/run/final/spritesheet.webp --run work/run` must print `ok: true`; kept look
   rows only bring a warning that they were not reviewed, while a redone look row needs fresh
   verdicts in `qa/direction-semantics.json` (format in the contract) or the check fails.
5. **Show and package.**
   `pet_preview.py gif work/run/final/spritesheet.webp --out-dir work/run/previews`, show `pet.gif`,
   upload the sheet and both GIFs into a collection as the create skill does, then
   `pet_package.py make work/run --id pepper`. Ask before `pet_package.py install work/run --force`,
   which backs up the installed Pepper into the run before replacing it.
6. **The scarf, later.** A new look changes every frame, so it is a new generation grounded in the
   old pet:
   `init --name Pepper --id pepper --description "<from pet.json>" --from-split work/split --change "add a red knitted scarf" --out work/scarf`
   adds an edit job on the identity image. Approve the edited base, then run every row as
   `scenario-chatgpt-pet-create` does from its rows step (look rows included for a v2 sheet, with
   fresh direction verdicts). The old sheet still sets the pet's size, so the new pet does not grow
   or shrink.

For a v1 to v2 upgrade (`init --version 2 --only look`), run `look-cardinals`, `look-9` and
`look-10` as the create skill describes and write the direction verdicts; the build keeps rows 0-8
and adds the two look rows.

## Common mistakes

- Overwriting the user's file or installed pet: work on a copy, and replace an installed Codex pet
  only after a yes, with `--force` (which backs it up).
- Regenerating the whole pet for one bad row: redo that row; the build copies the others byte for
  byte.
- Sending the whole sheet to an image model as the reference: it reads as a grid of small frames and
  the model copies the grid. Use `references/base.png` and the row strip `split` made.
- Regenerating to fix what the build can fix: leftover pixels, color under transparency and a row
  that drifts are `--clean` and `--reregister`, at no cost.
- Rebuilding without the original sheet: a new row is then sized from nothing; `init --from-split`
  records the sheet so the build keeps the pet's size.
- Changing the pet's id on a rename: Codex finds the pet by its folder, so keep the id and change
  `displayName`.
- Handing a v2 result to someone uploading on ChatGPT web: give them `package/spritesheet-v1.png`.

© scenario-labs · MIT · scenario-labs/skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set172

The whole set →
scenario-unity-animation scenario-unity-animation is a Claude Code skill for character animation and camera setup in Unity 6.3, including Mixamo retargeting, Animator layers, root motion, IK, Timeline, and Cinemachine. CX Codex +1 602installs scenario-unity-shaders scenario-unity-shaders — a skill for authoring and debugging shaders in Unity 6.3 URP: hand-written HLSL, Shader Graph, compute, variants and optimization. Solves pink materials, non-working effects, first-frame hitches and build bloat. CX Codex +1 600installs scenario-unity-performance The scenario-unity-performance skill investigates low FPS, stutter, and CPU or GPU pressure in Unity 6.3. Use it to measure the cause and verify a fix in a player build. CX Codex +1 600installs scenario-unity-rendering-lighting scenario-unity-rendering-lighting guides Unity URP setup, scene lighting and post-processing, with checks for shadow, bake, image-quality and mobile rendering issues. CX Codex +1 598installs scenario-chatgpt-pet-create scenario-chatgpt-pet-create creates an animated ChatGPT or Codex pet from text and reference art, with sprite sheets, GIFs, and a pet.json package. CX Codex +1 591installs scenario-unity-gameplay scenario-unity-gameplay — a skill for building and debugging Unity combat systems: enemy AI, NavMesh, projectile physics, Netcode multiplayer, audio. Built on measurements from shipped games. CX Codex +1 591installs scenario-blender-2d-animation scenario-blender-2d-animation — a skill for Claude Code that automates 2D scene creation in Blender using images generated in Scenario. Use it when building animations, game trailers, or parallax cutscenes. CX Codex +1 589installs scenario-unity-world-building The scenario-unity-world-building skill guides Unity 6.3 world building, from TerrainData and graybox work to additive scene streaming and Player profiling. CX Codex +1 579installs

Project sponsors

Companies that keep this analytics open