roblox-avatar-appearance

Installation
SKILL.md

Roblox avatar appearance pipeline

How to give avatars real, varied, accurate clothing/hair/skin — the parts that aren't obvious.

The core problem

The Studio search_asset MCP tool only reaches the Creator Store (dev assets: Models/Images/Decals) — NOT the avatar Marketplace (clothing/accessories). And soccer/character "jersey" MODELS it finds are 300+-part 3D meshes, useless as wearable clothing. So you must go to the catalog Web API.

Sourcing assets via the catalog Web API (the breakthrough)

Use WebFetch on the catalog search endpoint — it returns asset IDs by keyword within a category/subcategory filter:

https://catalog.roblox.com/v1/search/items?category=Clothing&subcategory=ClassicShirts&keyword=<X>&limit=10
  • limit MUST be 10 or 28. 6 / 20 return HTTP 400. category=Accessories and creatorTargetId also 400.
  • Subcategories that work: ClassicShirts, ClassicTShirts, ClassicPants. For hair, search category=Clothing won't help — search accessories by STYLE keyword (below).
  • The endpoint returns only asset IDs; you resolve details next.
Installs
44
First Seen
Sep 20, 2026