tmux

Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

87%

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

The content is lean, highly actionable, and well-structured with real bundled helper scripts; its only gap is that workflows are presented more as a command catalog than explicitly sequenced processes with feedback loops.

Suggestions

For destructive or interactive actions (e.g. send-keys, kill-session), add a brief validate-then-act checkpoint workflow with retry guidance to strengthen workflow clarity.

Consider trimming the PilotDeck Migration Note (a long temp path) from the skill body or relocating it to keep the overview token-efficient.

Dimension	Reasoning	Score
Conciseness	The body is almost entirely executable commands with minimal prose and no explanation of what tmux is, matching the 'lean and efficient; every token earns its place' anchor (the brief PilotDeck migration note is the only soft exception).	3 / 3
Actionability	It provides concrete, copy-paste-ready tmux commands (e.g. 'tmux capture-pane -t shared:0.0 -p', 'tmux send-keys -t shared:0.0 -l -- "Please continue"'), matching the 'fully executable code/commands' anchor.	3 / 3
Workflow Clarity	The prompt-checks section has a sequence (capture → grep → approve only when understood) with one checkpoint, but most sections are a reference catalog rather than sequenced multi-step workflows with explicit feedback loops.	2 / 3
Progressive Disclosure	SKILL.md is a concise overview and points to two real, one-level-deep helper scripts (scripts/find-sessions.sh, scripts/wait-for-text.sh) clearly signaled under a Helpers section, matching the 'clear overview with well-signaled one-level-deep references' anchor.	3 / 3
	Total	11 / 12 Passed

Description

67%

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

The description is specific and clearly niche-scoped to tmux, but lacks an explicit 'Use when...' trigger clause and leans on slightly technical phrasing for trigger terms.

Suggestions

Add an explicit 'Use when...' clause stating when to invoke the skill (e.g., when interacting with running tmux sessions).

Broaden trigger terms with natural user phrasings such as 'send keystrokes', 'read tmux output', or 'interact with a running terminal session'.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions — 'list, capture output, send keys, paste text, monitor prompts' — rather than vague language, matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	It clearly states what the skill does (control tmux sessions/panes with listed actions) but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2.	2 / 3
Trigger Term Quality	It includes relevant natural terms like 'tmux', 'send keys', and 'capture output', but the framing ('interactive CLIs', 'panes') is somewhat technical and lacks common user phrasings, so it falls between 'some relevant keywords' and full coverage.	2 / 3
Distinctiveness Conflict Risk	tmux session/pane control is a clear niche with distinct triggers and is unlikely to conflict with other skills, matching the 'clear niche with distinct triggers' anchor.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: OpenBMB/PilotDeck
Path: skills/tmux/SKILL.md
Commit: c88d7d1

Reviewed: about 12 hours ago

Table of Contents

Discovery Implementation Validation

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.