optimize-text-mesh-pro — Claude Code skill for TextMeshPro tuning

What optimize-text-mesh-pro does

The skill is a triage guide. It asks which symptom you have — memory or atlas bloat, visual quality, CPU load, build size, or alignment in mixed-language text — then points to the matching section: font stacks and dynamic fallbacks, padding against sampling point size, font asset scale, SDF16 atlas mode, AutoSize, worldspace text, font normalization, material presets.

The rules are concrete. Keep the main font static with its glyphs baked, and add dynamic fallbacks through the Fallback list. Any dynamic fallback needs Clear Dynamic Data On Build turned on, or glyphs baked while you test in the editor end up in the player. Padding divided by sampling point size has to match across the main font and its fallbacks, since a mismatch shows up as uneven stroke weight on one line. Set font asset Scale to 1 — a value like 0.9 throws off point-size math.

Normalizing mixed Latin and CJK text runs through importing TMP Example & Extras, adding TMP_TextInfoDebugTool to the object, and turning on ShowLines to see where baseline drifts. On some project layouts that import loops forever; restarting Unity clears it on the second try. If you ship multilingual builds for iOS and Android, the skill suggests evaluating Atlas Population Mode = Dynamic OS from TMP 3.2.0-pre.3, where the source font stays out of the player and Unity looks for a matching one on the device.