CtrlK
BlogDocsLog inGet started
Tessl Logo

tmux

Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

75

2.00x
Quality

68%

Does it follow best practices?

Impact

86%

2.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./openclaw/skills/tmux/SKILL.md

The canonical home for this skill is tmux in Hung-Reo/hungreo-openclaw

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, token-efficient command reference with strong copy-paste examples, but it reads as a command catalog rather than a guided workflow — verification steps after sending input are missing, and the bundled helper scripts are never mentioned. Wiring the body's patterns to the existing scripts and adding a verify-after-send loop are the highest-leverage fixes.

Suggestions

Reference the bundled helpers where they fit, e.g. under a 'Scripts' section: "List sessions across sockets: scripts/find-sessions.sh -A" and "Block until a pane shows a pattern: scripts/wait-for-text.sh -t worker-3 -p 'permission'".

Add a verify-after-send feedback loop to the Claude Code patterns: after send-keys, re-capture the pane (or run wait-for-text.sh) to confirm the input was received before proceeding.

Trim the environment-specific Example Sessions table and note that kill-session is destructive and should be preceded by a capture-pane check on the target session.

DimensionReasoningScore

Conciseness

The body is a lean, comment-annotated command catalog that assumes tmux knowledge and never explains background concepts, matching the 'efficient; minor instances that could be trimmed' anchor. Not a 5 because the environment-specific "Example Sessions" table (worker-2 through worker-8) and some overlap between the Session Management section and the When-NOT-to-Use list are padding that could be cut.

4 / 5

Actionability

Nearly every line is a copy-paste-ready command with inline comments ("tmux capture-pane -t shared -p -S -", "tmux send-keys -t shared -l -- \"...\""), and the common cases — listing, capturing, sending text/special keys, navigation, session lifecycle, and Claude Code prompt-approval patterns — are all covered with concrete examples, matching the fully-executable anchor. Not a 4 because there are no pseudocode or missing-detail gaps.

5 / 5

Workflow Clarity

A usable sequence exists across the Claude Code patterns (capture output, grep for prompts, then send 'y'/Enter), but validation checkpoints are implicit — there is no step verifying that sent input actually landed or that a task finished, and the destructive kill-session command appears with no confirmation guidance, matching the 'sequence present but checkpoints missing or implicit' anchor. Not a 4 because verification (e.g., re-capturing the pane after sending, or using a wait-for-text loop) is entirely absent rather than a minor gap.

3 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but the bundle's actual scripts (scripts/find-sessions.sh, scripts/wait-for-text.sh) are never referenced anywhere in the SKILL.md, so content that belongs in — or is already in — separate files is neither surfaced nor navigable. This sits between anchor 2 (references buried/unused bundle structure) and anchor 4 (references mostly clear); it is a 3 rather than a 4 because the existing reference paths go completely unmentioned, and better than a 2 because the inline content itself is well organized and appropriately sized.

3 / 5

Total

15

/

20

Passed

Description

65%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, third-person description with a clear 'what' and a distinctive tmux niche, but it lists only two capabilities and entirely lacks a 'Use when...' trigger clause. Adding explicit when-to-use guidance and one or two more capabilities would raise both completeness and specificity.

Suggestions

Append an explicit trigger clause, e.g. "Use when sending input to or reading output from processes already running in tmux, monitoring Claude/Codex sessions, or checking on background work."

Mention one or two more concrete capabilities (e.g., navigating panes/windows, managing sessions) to move specificity beyond the 1-2-action level.

Include a natural variation such as "send keys to a tmux session" or "capture pane output" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("tmux sessions for interactive CLIs") and exactly two concrete actions ("sending keystrokes", "scraping pane output"), matching the anchor for 1-2 concrete actions that are not comprehensive. It is not a 4 because it omits other capabilities the body actually covers (pane/window navigation, session creation/kill/rename), so there are more than minor gaps.

3 / 5

Completeness

The 'what' is clear ("Remote-control tmux sessions... by sending keystrokes and scraping pane output"), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines; the 'when' is only weakly implied by "for interactive CLIs". Not a 4 because the when-guidance is absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Good keyword coverage with the dominant natural terms users would say — "tmux", "sessions", "keystrokes", "interactive CLIs", "pane output" — anyone needing this skill would plausibly say "tmux". Not a 5 because common variations like "send keys/text to a session", "capture output", or "check on a running session" are missing.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — tmux session control specifically — with distinct triggers ("tmux", "keystrokes", "pane output") that are unlikely to fire for other skills, matching the anchor for a clear niche with minimal conflict risk. Not a 4 because there is no meaningful overlap with closely related skills; tmux is named explicitly.

5 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
trpc-group/trpc-agent-go
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.