Skip to content
Skills Library
Programming · Review & audit

platform-compatibility

/platform-compatibility

This skill should be used when the user asks about terminal emulator compatibility, operating-system differences, tmux/screen/Zellij, SSH/remote terminals, Windows ConPTY/classic console/Windows Terminal, Unix PTYs, macOS Terminal/iTerm2, Kitty/Alacritty/WezTerm/foot/GNOME Terminal/Konsole, terminal feature matrices, escape-sequence passthrough, latency, resize propagation, or graceful degradation. PROACTIVELY activate for: compatibility audits, emulator bugs, remote TUI performance, multiplexer passthrough. Provides: support matrices, platform caveats, and fallback rules.

Licence
MIT
Last repository change
18.06.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 18.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

This skill should be used when the user asks about terminal emulator compatibility, operating-system differences, tmux/screen/Zellij, SSH/remote terminals, Windows ConPTY/classic console/Windows Terminal, Unix PTYs, macOS Terminal/iTerm2, Kitty/Alacritty/WezTerm/foot/GNOME Terminal/Konsole, terminal feature matrices, escape-sequence passthrough, latency, resize propagation, or graceful degradation. PROACTIVELY activate for: compatibility audits, emulator bugs, remote TUI performance, multiplexer passthrough. Provides: support matrices, platform caveats, and fallback rules.

Original author description

This skill should be used when the user asks about terminal emulator compatibility, operating-system differences, tmux/screen/Zellij, SSH/remote terminals, Windows ConPTY/classic console/Windows Terminal, Unix PTYs, macOS Terminal/iTerm2, Kitty/Alacritty/WezTerm/foot/GNOME Terminal/Konsole, terminal feature matrices, escape-sequence passthrough, latency, resize propagation, or graceful degradation. PROACTIVELY activate for: compatibility audits, emulator bugs, remote TUI performance, multiplexer passthrough. Provides: support matrices, platform caveats, and fallback rules.

How it works

  1. Compatibility mindset
  2. Support matrix to define
  3. Platform rules
  4. Multiplexer rules
  5. Remote rules
  6. Reference files
Original SKILL.md headings · 44 lines, 350 words
SKILL.md preview
---
name: platform-compatibility
description: |
  This skill should be used when the user asks about terminal emulator compatibility, operating-system differences, tmux/screen/Zellij, SSH/remote terminals, Windows ConPTY/classic console/Windows Terminal, Unix PTYs, macOS Terminal/iTerm2, Kitty/Alacritty/WezTerm/foot/GNOME Terminal/Konsole, terminal feature matrices, escape-sequence passthrough, latency, resize propagation, or graceful degradation. PROACTIVELY activate for: compatibility audits, emulator bugs, remote TUI performance, multiplexer passthrough. Provides: support matrices, platform caveats, and fallback rules.
---

# Platform, Emulator, Multiplexer, and Remote Compatibility

Use this skill when a TUI must behave across operating systems, terminal emulators, multiplexers, SSH sessions, containers, CI, or embedded pseudo-terminal hosts.

## Compatibility mindset

Terminal capability is a chain: application library, OS console or PTY, shell, multiplexer, SSH transport, terminal emulator, font, theme, and user settings. A feature is reliable only if each link preserves it. Treat every advanced protocol as optional unless the app owns the whole environment.

## Support matrix to define

For production TUIs, document and test:

- OS: Linux, macOS, Windows Terminal, classic conhost if supported, WSL, containers.
- Terminal emulators: Terminal.app, iTerm2, Kitty, Alacritty, WezTerm, foot, GNOME Terminal/VTE, Konsole, Windows Terminal.
- Multiplexers: tmux, GNU screen, Zellij.
- Remote: SSH, mosh-like links, serial/slow links, jump hosts, agent forwarding policy.
- Shell and locale: UTF-8 locale, code page on Windows, `TERM` and terminfo availability.
- Constraints: minimum size, color level, Unicode/ASCII mode, mouse/paste support.

## Platform rules

- On Windows, distinguish Windows Terminal/ConPTY from legacy console hosts. Enable virtual terminal processing when using low-level console APIs, prefer UTF-8, and test child-process hosting through ConPTY when relevant.
- On Unix-like systems, handle PTY semantics, `SIGWINCH`, termios raw/cbreak restoration, process signals, and locale-dependent encoding.
- On macOS, Terminal.app and iTerm2 differ in proprietary protocols, option-key behavior, clipboard/image features, and default color/theme settings.

## Multiplexer rules

- tmux/screen/Zellij can rewrite `TERM`, filter OSC/DCS, transform mouse events, mediate alternate screen, and require passthrough wrappers for clipboard, images, truecolor, or keyboard protocols.
- Always test inside and outside the multiplexer versions you claim.
- Prefer text fallbacks over hard dependencies on OSC 52, OSC 8, Kitty graphics, iTerm2 images, focus events, or extended keyboard protocols.

## Remote rules

- Minimize write volume and cursor churn over SSH.
- Coalesce resize storms and high-frequency metrics.
- Do not assume clipboard, local file paths, image protocols, or agent forwarding are present or allowed.
- Provide low-bandwidth, no-mouse, no-animation, plain, and batch modes.

## Reference files

- `references/emulator-platform-matrix.md` - OS, emulator, PTY, and feature compatibility guidance.
- `references/multiplexer-remote.md` - tmux/screen/Zellij, SSH, latency, passthrough, and resize practices.
Files in this package (3)
  • SKILL.md 3 KB
  • references/emulator-platform-matrix.md 7 KB
  • references/multiplexer-remote.md 3 KB

Versions

The database has no other skills named platform-compatibility.

Database snapshot: 13.11.2026 · package version 06e83e49e405 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100terminal-standards
    This skill should be used when the user asks about ANSI, VT100, VT220, ECMA-48, ISO 6429, xterm control sequences, terminal capability detection, terminfo, environment variables, alternate screen protocols, SGR colors, OSC, CSI, DCS, terminal graphics, Windows virtual terminal…
  • 100terminal-check
    Run prismantis in the real terminals installed on this machine (Windows Terminal, conhost, Warp, WezTerm, Alacritty on Windows; Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty, Warp on macOS), across a matrix of option sets and scripted scenarios that type keys and click,…
  • 100tui-troubleshooting
    Use this skill when a terminal UI freezes, hangs, shows a blank screen, corrupts terminal state, leaves raw mode stuck, stops responding to input, garbles output, breaks colors/cursor state, fails over SSH/tmux/screen, behaves differently on Windows/ConPTY, or needs deep…
  • 100zellij
    Use when manipulating Zellij sessions, creating tabs or panes, or looking up Zellij CLI commands for terminal multiplexer operations
  • 95terminal-superpowers-cheatsheet
    Use when the user wants modern terminal tools that upgrade classic Unix commands, or asks for a faster or friendlier alternative to cd, ls, cat, find or grep: zoxide, fzf, fd, ripgrep, eza, bat, starship, lazygit, tldr, btop, tmux and zellij. What each tool does, how to install…
  • 90kitty-remote-control
    Safe kitty remote control from an agent — read panes with kitty @ ls/get-text, notify, and never mutate the live terminal unasked. Use when running inside kitty.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.