skill-system-tmux

Installation
SKILL.md

Skill System Tmux

Route shell commands through tmux when they risk timeout, require persistence, or need interactive terminal access. This skill provides decision heuristics and session management conventions — not tmux tutorials.

Decision Matrix

Use this matrix to decide: direct bash vs tmux.

Condition Route Examples
Estimated time > 60s tmux git clone <large>, npm install, docker build, training scripts
Command does not self-terminate tmux npm run dev, python app.py, jupyter notebook
Requires TUI or interactive input tmux vim, htop, pudb, claude
Parallel isolated execution needed tmux Multiple agents, concurrent test suites
Remote execution over SSH tmux Commands that must survive connection drops
Atomic, non-interactive, fast (<30s) direct bash ls, grep, git status, cat, mkdir
Single-shot with expected output direct bash python script.py (fast), git diff, npm test (short)

Default: direct bash. Only route to tmux when a condition above is met.

Related skills
Installs
44
GitHub Stars
4
First Seen
Mar 6, 2026