1
Use a stable id
The id should be lowercase, URL-safe, and short enough to work in install commands, file paths, and public URLs.
Guide - 6 min
Create a valid pet.json for an AgentPets package
Learn the required pet.json fields for AgentPets packages, including stable ids, spritesheet metadata, discovery tags, creator credit, and install-ready URLs.
2
Point to the spritesheet
AgentPets expects a spritesheet with the standard 8 column by 9 row animation atlas. The builder writes this metadata automatically.
3
Add useful discovery fields
Name, description, tags, kind, and vibes help the pet show up in topical pages and public API responses.
Related next steps
Useful API surfaces
Public API, badges, and embeds are versioned under stable URLs so README snippets and integrations can keep working as the product evolves.