tmt-avatar-create

Create and validate data-only pixel-avatar packs for TMT Office identities.

11|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/wkh237/tmux-team --skill tmt-avatar-create-wkh237
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmt-avatar-create
Source: https://github.com/wkh237/tmux-team/tree/main/skills/tmt-avatar-create
Command: npx skills add https://github.com/wkh237/tmux-team --skill tmt-avatar-create-wkh237

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing custom character art for TMT Office requires producing a strictly constrained, data-only .tmtavatar.json pack that passes validation and can be safely installed and applied to an identity profile without corrupting revisions or breaking fallback behavior. ## Core Features & Use Cases - Pack Authoring Rules: Enforces the exact schema for v1 (16×24, 16 colors) and v2 (32×48, 256 colors) indexed-pixel avatars, including palette, label, license, and size constraints. - Validation and Preview: Runs read-only validation via tmt office avatar validate and optional preview rendering, interpreting warnings without overriding the user's artistic intent. - Install and Apply Workflow: Discovers the catalog revision, installs the pack, and applies avatarRef to an identity profile using revision-checked writes with conflict recovery. - Use Case: A user wants a custom pixel robot for their reviewer agent. You compose the pixel grid, validate the pack, install it against the current catalog revision, and apply it to the reviewer's profile while preserving their default appearance for fallback. ## Quick Start Create a TMT Office avatar pack for my agent named reviewer, validate it, and apply it to that identity's profile.

Frequently Asked Questions about tmt-avatar-create

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom avatar for TMT Office?

Author a UTF-8 .tmtavatar.json file containing only indexed-pixel data with formatVersion, label, credit, license, palette, and avatars. Validate it with tmt office avatar validate, then install and apply it to an identity profile using revision-checked commands.

What is the difference between avatar formatVersion 1 and 2?

Version 1 uses a 16x24 grid with one hex digit per cell and up to 16 colors. Version 2 uses a 32x48 grid with two hex digits per cell and up to 256 colors, adding detail rather than a larger world footprint.

What constraints apply to tmtavatar pack files?

Files must be at most 32 KiB with no BOM or symlinks, contain 1-16 v1 or 1-4 v2 avatars, and stay under 6,144 total cells. Palette entry zero must be transparent #00000000, and unknown or duplicate members are rejected.

Why does avatar validation report warnings on my pack?

Warnings flag edge clipping, small silhouettes, or single-color artwork. They are advisory only: deliberate minimal art is valid, and you should not change the intended style merely to silence a warning.

What happens to a profile when an avatar pack is removed?

Removal retains saved profile references, and unavailable art falls back to that profile's saved default appearance. Reinstalling the exact original pack restores the custom art without rewriting the profile.