terminal-emulation

Diagnose terminal display issues across terminfo, locale, and Unicode rendering.

2|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/totallyGreg/claude-mp --skill terminal-emulation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-emulation
Source: https://github.com/totallyGreg/claude-mp/tree/main/plugins/terminal-guru/skills/terminal-emulation
Command: npx skills add https://github.com/totallyGreg/claude-mp --skill terminal-emulation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This guide helps users diagnose, fix, and understand Unix terminal display problems such as garbled text, incorrect colors, and emoji rendering, by guiding through terminfo, Unicode/UTF-8 rendering, and locale configurations.

Core Features & Use Cases

  • Terminal Diagnostics: Run a diagnostic workflow to assess TERM, locale, and terminal capabilities.
  • Terminfo & Unicode Troubleshooting: Provide step-by-step guidance with references on terminfo entries and Unicode rendering.
  • Unified Diagnostics Workflow: Produce a structured report that captures environment, terminal capabilities, and encoding issues for remediation.

Quick Start

Run the diagnostic tool to generate a terminal diagnostic report.

Frequently Asked Questions about terminal-emulation

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

FAQPage Schema
Why does my terminal show garbled characters and broken box-drawing lines in SSH?

Garbled characters and broken box-drawing lines in SSH sessions are typically caused by a mismatch between your TERM environment variable and the actual terminal emulator capabilities. The diagnostic workflow reads terminfo data and environment variables to identify the exact mismatch and provide targeted fixes.

How do I fix incorrect colors in tmux and TUI applications?

To fix incorrect colors in tmux and TUI applications, you need to verify that your terminfo entry supports the correct color capabilities and that your terminal supports them. The diagnostic tool assesses terminal capabilities and generates a structured report to guide color remediation.

What causes emoji and Unicode rendering problems in Unix terminals?

Emoji and Unicode rendering problems in Unix terminals are caused by incorrect locale configurations or missing UTF-8 encoding support. The diagnostic workflow checks your locale environment variables and UTF-8 settings to identify encoding issues and suggest corrections.

Does this terminal diagnostic tool work with any Unix terminal emulator?

The terminal diagnostic tool works across Unix terminal environments by reading standard environment variables, terminfo data, and locale configurations. It produces a diagnostic report covering terminfo, locale, and Unicode rendering issues regardless of the specific terminal emulator in use.

What's the best way to diagnose terminal display issues across SSH and tmux?

The best way to diagnose terminal display issues across SSH and tmux is to run a unified diagnostic workflow that reads environment variables, terminfo entries, and UTF-8 configurations. This generates a structured report capturing environment data and encoding issues for precise remediation.