Agent skill

Mate Desktop Pet Creator

Creates a custom animated desktop pet for MiMo Desktop: a WebP spritesheet plus a manifest.json that describes its frames and animations.

MITAuto-check passedGame Development

Install Mate Desktop Pet Creator

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .claude/skills/mate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .claude/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .agents/skills/mate && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .agents/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .cursor/skills/mate && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .cursor/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/XiaomiMiMo/MiMo-Code.git --path packages/cli/src/skill/builtin/.bundle/mate

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .gemini/skills/mate && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .gemini/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .github/skills/mate && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .github/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add XiaomiMiMo/MiMo-Code --skill mate -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install XiaomiMiMo/MiMo-Code mate --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/cli/src/skill/builtin/.bundle/mate .opencode/skills/mate && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mate" agent skill from https://github.com/XiaomiMiMo/MiMo-Code/tree/main/packages/cli/src/skill/builtin/.bundle/mate into .opencode/skills/mate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mate", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: mate
GitHub stars: 14k
Token cost: ~1.5k tokens
SKILL.md length: 643 words
Files: 1
Skills in repo: 22
Repo updated: Oct 3, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Creates a custom animated desktop pet for MiMo Desktop: a WebP spritesheet plus a manifest.json that describes its frames and animations.

Works in 4 steps: Understand the Character → Generate the Spritesheet → Write the Manifest → …
Making a custom desktop companion character for MiMo Desktop
SKILL.md covers Output Structure, Manifest Schema, Spritesheet Layout and Workflow, plus 1 more section
Calls brew

What it does

This skill produces the two files a custom pet needs in its own folder: manifest.json and spritesheet.webp. The manifest requires an id, a name, a version of 1, the spritesheet filename, frame width and height, column count, total frame count and an animations object that must include `idle`. A description and a horizontal anchor are optional. Each animation entry gives a row index, a frame count, a playback speed (6 to 12 frames per second is recommended) and whether it loops.

The spritesheet is a grid read left to right and top to bottom, with one row per animation, identical frame sizes and a transparent background, since the pet window has none. A frame size of 240 by 240 pixels is recommended, saved as lossless or near-lossless WebP. The workflow begins by asking what character you want, the art style (pixel art, cartoon, flat vector or kawaii) and any colors or features. You then place the folder in the custom pets directory and press Refresh under Settings, Mate. The excerpt is cut off before the later steps.

When your agent uses it

Making a custom desktop companion character for MiMo Desktop
Generating a spritesheet and manifest for an animated pet
Fixing a pet that fails to load because its manifest or grid is wrong

Example prompts

“Make a pixel-art fox desktop pet with idle and walking animations.”
“Design a kawaii cat mate and generate its spritesheet and manifest.”
“My custom pet will not load. Check that the manifest rows match the spritesheet grid.”

Requirements

MiMo Desktop with the Mate feature

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Understand the Character
Generate the Spritesheet
Write the Manifest
Deliver

What it can do on your machine

Read from SKILL.md and the folder at commit 6babeb0. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- brew
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mate Desktop Pet Creator loads about 1.5k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 643 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~88
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from XiaomiMiMo/MiMo-Code at commit 6babeb0, republished under its MIT licence (© XiaomiMiMo). 643 words, ~1,524 tokens.

Download SKILL.mdSave it as .claude/skills/mate/SKILL.md (or your agent's skills folder).

name: mate
description: Create custom desktop pet (Mate) characters with spritesheet and manifest. Use when the user asks to 'create a pet', 'make a desktop companion', 'design a mate character', 'generate a spritesheet for my pet', or wants to customize their desktop buddy. Generates a WebP spritesheet + manifest.json that can be loaded by MiMo Desktop's Mate system.

Mate Pet Creator

Create animated desktop pet characters for MiMo Desktop's Mate (桌面伙伴) system.

Output Structure

A valid custom pet lives in a folder with this structure:

<pet-id>/
├── manifest.json     # Required — animation metadata
└── spritesheet.webp  # Required — all animation frames in a grid

The user places this folder in their MiMo Desktop custom pets directory (userData/pets/<pet-id>/), then clicks "Refresh" in Settings → Mate to load it.

Manifest Schema

json

{
  "id": "my-pet",
  "name": "My Pet",
  "description": "A cute custom pet",
  "version": 1,
  "spritesheet": "spritesheet.webp",
  "frameWidth": 240,
  "frameHeight": 240,
  "columns": 8,
  "totalFrames": 16,
  "animations": {
    "idle": { "row": 0, "frames": 8, "fps": 8, "loop": true }
  }
}

Required Fields

Field	Type	Description
`id`	string	Unique identifier (kebab-case)
`name`	string	Display name
`version`	number	Always `1`
`spritesheet`	string	Filename of the spritesheet image
`frameWidth`	number	Width of each frame in pixels
`frameHeight`	number	Height of each frame in pixels
`columns`	number	Number of columns in the spritesheet grid
`totalFrames`	number	Total number of frames across all animations
`animations`	object	At minimum must include `idle`

Optional Fields

Field	Type	Description
`description`	string	Shown in settings UI
`anchorX`	number	Horizontal anchor (0–1, default 0.5) for centering

Animation Definition

Each animation entry:

Field	Type	Description
`row`	number	Row index in the spritesheet (0-based)
`frames`	number	Number of frames in this animation
`fps`	number	Playback speed (recommended: 6–12)
`loop`	boolean	Whether the animation loops

The idle animation is required — it plays by default when the pet is loaded.

Spritesheet Layout

Frames are arranged left-to-right, top-to-bottom in a grid.
Each row corresponds to one animation (matched by the row field in the animation definition).
All frames must have identical dimensions (frameWidth × frameHeight).
Transparent background (alpha channel) is required — the pet window has no background.
Recommended frame size: 240×240 px (renders well at 1× scale on desktop).
Format: WebP with transparency (lossless or near-lossless for crisp pixel art).

Workflow

Step 1: Understand the Character

Ask the user:

What animal/creature/character?
Art style preference (pixel art, cartoon, flat vector, kawaii)?
Any specific colors or features?

Step 2: Generate the Spritesheet

Use the imagegen skill to generate the spritesheet image. Construct the prompt with these guidelines:

Request a sprite sheet with specific grid layout (e.g., "8 frames in a single horizontal row, each frame 240×240 pixels")
Specify transparent background (alpha channel)
Describe the idle animation motion: gentle breathing, blinking, tail wag, bobbing, etc.
Keep the character centered in each frame with consistent sizing
Style: match the user's preference; default to cute/kawaii if unspecified

If the generated image is already WebP, use it directly. If it is PNG or another format, convert to WebP:

bash

# Convert to lossless WebP preserving transparency
cwebp -lossless -q 100 spritesheet.png -o spritesheet.webp

If cwebp is not available, check for sips (macOS Ventura+ supports WebP export):

bash

sips -s format webp spritesheet.png --out spritesheet.webp

If neither tool is available, instruct the user to install one:

brew install webp   # provides cwebp

Do NOT silently rename a PNG to .webp — the file must have valid WebP encoding (RIFF/WEBP header). If conversion genuinely cannot be performed, fail explicitly and tell the user what tool to install.

If imagegen is unavailable (skill not enabled or image generation fails), fall back to generating pixel-art frames directly as SVG, then rasterize. Compute dimensions from the manifest:

bash

# Calculate actual spritesheet dimensions from manifest
WIDTH=$((frameWidth * columns))
HEIGHT=$((frameHeight * rows))  # rows = max animation row index + 1

# Rasterize SVG to PNG, then convert to WebP
rsvg-convert -w $WIDTH -h $HEIGHT spritesheet.svg -o spritesheet.png
cwebp -lossless spritesheet.png -o spritesheet.webp

As a last resort, output the SVG file directly and instruct the user to convert it manually.

Show full SKILL.md (165 more words)Show less

Step 3: Write the Manifest

Generate manifest.json with correct dimensions matching the actual spritesheet output. Verify:

frameWidth × columns = spritesheet total width
frameHeight × (max animation row index + 1) = spritesheet total height
animations.idle exists with valid row, frames, fps, loop
Each animation's frames ≤ columns (frames per row cannot exceed grid columns)

Step 4: Deliver

Write both files to the current working directory under a folder named with the pet ID. Tell the user to:

Copy the folder to their MiMo Desktop pets directory (Settings → Mate → click "Open Folder" to find it)
Click "Refresh" in Settings → Mate
Select their new pet from the list

Constraints

The idle animation MUST exist — the system falls back to it.
Frame dimensions must be consistent across the entire spritesheet.
Keep total file size under 2MB for smooth loading.
Pet ID must be unique; if it conflicts with a preset (koala, panda), the preset wins.
Do NOT reference or depend on any external URLs — all assets must be local files.

Files

Just SKILL.md in packages/cli/src/skill/builtin/.bundle/mate of XiaomiMiMo/MiMo-Code.

Open the folder on GitHubat commit 6babeb0

Compare with similar skills

Mate Desktop Pet Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mate Desktop Pet Creator compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mate Desktop Pet Creator this skillXiaomiMiMo/MiMo-Code	14k	—	~1.5k	Automated safety check: Pass	MIT	4 days ago
Game Asset Generatorhtdt/godogen	7.1k	—	~2.8k	Automated safety check: Pass	MIT	6 days ago
Code-Drawn 2D Game Art0x0funky/agent-sprite-forge	4.3k	—	~2.5k	Automated safety check: Pass	MIT	yesterday
Sprite Genaldegad/sprite-gen	2.6k	—	~4.4k	Automated safety check: Pass	Apache-2.0	yesterday
Hatch PethAcKlyc/MyAgents	915	1 repos	~9.5k	Automated safety check: Pass	Apache-2.0	today
2D Sprite Generator0x0funky/agent-sprite-forge	4.3k	—	~3.6k	Automated safety check: Pass	MIT	yesterday

Similar skills

Game Asset Generator
htdt/godogen
Generates game art from text prompts: PNG images, GLB 3D models, rigged characters, animations and sprites, with background removal.
7.1k GitHub stars~2.8k tokensUpdated 6 days ago
Game DevelopmentAuto-check passed
Code-Drawn 2D Game Art
0x0funky/agent-sprite-forge
Draws 2D game art from code with no image model: pixel sprites, SVG props and icons, rigged characters, FX, autotiles and layouts, only when explicitly asked for.
4.3k GitHub stars~2.5k tokensUpdated yesterday
Game DevelopmentAuto-check passed
Sprite Gen
aldegad/sprite-gen
Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation.
2.6k GitHub stars~4.4k tokensUpdated yesterday
Game DevelopmentAuto-check passed
Hatch Pet
hAcKlyc/MyAgents
Create, repair, validate, visually QA, and package MyAgents/Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual…
915 GitHub starsUsed in 1 repo~9.5k tokens
Game DevelopmentAuto-check passed
2D Sprite Generator
0x0funky/agent-sprite-forge
Produces game-ready 2D characters, creatures, props, icons and effects as master stills, sheets or clips, and exports frames for common game engines.
4.3k GitHub stars~3.6k tokensUpdated yesterday
Game DevelopmentAuto-check passed
Img Gen Avatar
4thfever/cultivation-world-simulator
A skill your agent uses when working on tools/imggen avatar image generation, OpenAI-compatible image API config, human or yaoguai portrait prompts, qi-refining base generation, image-to-image realm…
2.1k GitHub stars~641 tokensUpdated 1 mo ago
Game DevelopmentAuto-check passed

Questions about Mate Desktop Pet Creator

What does Mate Desktop Pet Creator do?

Creates a custom animated desktop pet for MiMo Desktop: a WebP spritesheet plus a manifest.json that describes its frames and animations. webp. The manifest requires an id, a name, a version of 1, the spritesheet filename, frame width and height, column count, total frame count and an animations object that must include `idle`.

When should I use Mate Desktop Pet Creator?

Mate Desktop Pet Creator fits situations like: making a custom desktop companion character for MiMo Desktop; generating a spritesheet and manifest for an animated pet; fixing a pet that fails to load because its manifest or grid is wrong.

How do I install Mate Desktop Pet Creator in Claude Code?

Run `npx skills add XiaomiMiMo/MiMo-Code --skill mate -a claude-code`. Or copy the skill folder (packages/cli/src/skill/builtin/.bundle/mate in XiaomiMiMo/MiMo-Code) into .claude/skills/mate in your project. Claude Code loads it when a task matches its description.

How do I install Mate Desktop Pet Creator in Codex?

Run `npx skills add XiaomiMiMo/MiMo-Code --skill mate -a codex`. Or copy the skill folder (packages/cli/src/skill/builtin/.bundle/mate in XiaomiMiMo/MiMo-Code) into .agents/skills/mate in your project. Codex loads it when a task matches its description.

Can I use Mate Desktop Pet Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add XiaomiMiMo/MiMo-Code --skill mate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mate, .gemini/skills/mate, .github/skills/mate and .opencode/skills/mate in your project.

What does Mate Desktop Pet Creator need to run?

Going by SKILL.md and its folder, Mate Desktop Pet Creator needs the command-line tools its instructions call (brew). Our summary lists: MiMo Desktop with the Mate feature.

Does Mate Desktop Pet Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mate Desktop Pet Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mate Desktop Pet Creator use?

Mate Desktop Pet Creator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mate Desktop Pet Creator use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mate Desktop Pet Creator?

Skills that share tags, products or a category with Mate Desktop Pet Creator: Game Asset Generator (htdt/godogen, 7.1k stars), Code-Drawn 2D Game Art (0x0funky/agent-sprite-forge, 4.3k stars), Sprite Gen (aldegad/sprite-gen, 2.6k stars) and Hatch Pet (hAcKlyc/MyAgents, 915 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mate Desktop Pet Creator?

XiaomiMiMo (a GitHub organization) maintains it in XiaomiMiMo/MiMo-Code, which has 13,601 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 3, 2026.

Source: XiaomiMiMo/MiMo-Code on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Mate Desktop Pet Creator

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Mate Pet Creator

Output Structure

Manifest Schema

Required Fields

Optional Fields

Animation Definition

Spritesheet Layout

Workflow

Step 1: Understand the Character

Step 2: Generate the Spritesheet

Step 3: Write the Manifest

Step 4: Deliver

Constraints

Files

Compare with similar skills

Similar skills

More from XiaomiMiMo/MiMo-Code

Related

Questions about Mate Desktop Pet Creator