terminal-specific-art-fallbacks

SKILL: Terminal-specific Art Fallbacks

Domain: terminal-ui
Trigger: When the same brand art must render on Apple Terminal, xterm, and other hosts with different Unicode/color capabilities while preserving the mascot identity. Source Pattern: Distilled from reviewed terminal rendering and compatibility patterns.

Core Method

Detect the terminal host (e.g., via env.terminal) before rendering and prepare specialized fragments for hosts that need them. Use a default art path for general terminals but route sensitive fragments (eye shapes, raised arms, background fills) through the host-specific data, keeping the fallback path centered on the default segments so the identity stays consistent even when the terminal cannot express the fancy fragments.

Key Rules

• Gate the choice of fragment set on the detected terminal (Apple Terminal uses the APPLE_EYES set; others reuse POSES) so hosts with different capabilities stay readable.
• Keep the identity stable by falling back to the default pose when a specialized host-specific variant is unavailable, rather than constructing a completely new layout.
• When a test host requires a background-fill trick (Apple Terminal’s background-color fill), wrap the fragments in a dedicated render path instead of mixing it with the default path.

Example Application

If your release banner has env.terminal === "Apple_Terminal" users and others, detect the host early, feed Apple with background-filled eye fragments, and serve the general Unicode art to everyone else while maintaining the same mascot name, spacing, and pose structure.

Anti-Patterns (What NOT to do)

• Rendering only a single art variant and letting hosts with lesser glyph support break the UI or show garbage characters.
• Mixing host-specific fragments inside the default render path so every render re-evaluates terminal detection and corrupts memoization caches.
• Creating entirely separate mascots per terminal host instead of sharing the same segments and only swapping fragments.