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.