JosiahSiegel/platform-compatibility
plugins/tui-master/skills/platform-compatibility/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add JosiahSiegel/claude-plugin-marketplace platform-compatibilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 26, 2026, 7:41 AM17.8s3 files scanned
SKILL.md
- 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,
TERMand 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.
Related Skills
JosiahSiegel/clerk-sessions-webhooks-security
development
VerifiedTrustedCommunity
Use for Clerk sessions, tokens, webhooks, orgs, and security. PROACTIVELY activate for session tokens, JWT templates, getToken(), custom claims, pending sessions, multi-session UX, organizations, roles, permissions, system vs custom permissions, features/plans, MFA/passkeys/password policy/bot protection, Clerk webhooks, Svix signatures, verifyWebhook(), user/org sync, retries/replays, environment variables, custom domains, secret rotation, logs, and auth security reviews. Provides token semantics, webhook idempotency, authorization defaults, and hardening checklist.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-nextjs-auth
tools
VerifiedTrustedCommunity
Use for Clerk in Next.js. PROACTIVELY activate for @clerk/nextjs setup, App Router auth()/currentUser(), clerkMiddleware(), proxy.ts/middleware.ts, createRouteMatcher(), protected pages/layouts/Route Handlers/Server Actions/API routes/tRPC, auth.protect() role/permission/token checks, ClerkProvider placement, server-only clerkClient, Link prefetch, redirects, 401/404 auth failures, custom domains, __clerk proxy paths, and deployment gotchas. Provides file patterns, server/client boundary rules, matcher templates, and production checks.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-frontend-sdks
development
VerifiedTrustedCommunity
Use for Clerk frontend auth flows. PROACTIVELY activate for React, JavaScript, Vue, Nuxt, Astro, Expo, React Router, TanStack React Start, or SPA setup; ClerkProvider and publishable-key wiring; SignIn/SignUp/UserButton/UserProfile/OrganizationSwitcher; custom useUser/useAuth/useClerk/useSignIn/useSignUp/useSession/useOrganization flows; multi-session UX; cross-origin getToken() fetches; loading states, redirects, routing, CORS/cookies, or hydration bugs. Provides SDK selection, UI patterns, token-fetch templates, and frontend gotchas.
45SKILL.mdUpdated Jun 19, 2026
JosiahSiegel/clerk-environments-deployment
development
VerifiedTrustedCommunity
Use for Clerk dev/prod readiness, deployment, and multi-language implementation planning. PROACTIVELY activate for environment variables, pk_test/sk_test vs pk_live/sk_live, local dev, preview/staging/prod instances, domains/DNS, redirects, OAuth credentials, custom domains/proxy, authorizedParties, CSP, CORS/cookies, webhooks/tunnels, Vercel/Netlify/Cloudflare/API gateways, monitoring/troubleshooting, and backends in Node/Express/Fastify, Python/FastAPI/Django/Flask, Go, Ruby/Rails, Java/Spring, .NET, PHP/Laravel. Provides checklists, rollout plans, and language-portable patterns.
45SKILL.mdUpdated Jun 19, 2026