CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tmux

Use when a CLI task needs an interactive terminal or control of a tmux session.

61

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./nanobot/skills/tmux/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, highly actionable reference: copy-paste-ready tmux commands, real helper scripts clearly referenced one level deep, and a solid start→send→capture→cleanup flow with a completion-polling example. The only real gaps are minor: slight redundancy with the frontmatter's OS gating and a few implicit validation checkpoints around destructive cleanup.

DimensionReasoningScore

Conciseness

The body is command-first with almost no concept explanation — the quickstart, targeting, sending, capture, and cleanup sections are lean and assume Claude's competence. Minor trimmable redundancy keeps it below anchor 5: the Windows/WSL section repeats OS gating already stated in frontmatter metadata ('This skill is gated to darwin/linux and requires tmux on PATH' duplicates metadata), and tips like 'pnpm install first before running codex in fresh clones' are niche. It is well above anchor 3, which requires unnecessary explanation.

4 / 5

Actionability

Everything is executable: the quickstart is a copy-paste-ready bash block (socket dir setup, new -d, send-keys with PYTHON_BASIC_REPL=1, capture-pane), cleanup gives exact kill-session/kill-server pipelines, and the helper section documents wait-for-text.sh flags (-t, -p, -F, -T, -i, -l) with defaults. Both referenced scripts exist in the bundle and match their documented usage. This matches anchor 5: copy-paste ready commands covering the common cases.

5 / 5

Workflow Clarity

The quickstart sequences a clear start→send→capture flow, instructs printing monitor commands after start, and the orchestration example includes a poll-for-completion feedback loop (capture-pane | grep for prompt). It falls short of anchor 5 because some checkpoints are implicit rather than explicit: no 'verify the session exists via list-sessions before sending input', no error-recovery guidance when send-keys produces no output, and cleanup's destructive kill-session commands lack an inspection step before killing (though list-sessions is mentioned elsewhere).

4 / 5

Progressive Disclosure

The body is a well-organized overview with clear section headers, and detailed helper logic is correctly split into real bundle scripts ({baseDir}/scripts/find-sessions.sh and {baseDir}/scripts/wait-for-text.sh), both of which exist and are clearly signaled with a dedicated 'Helper: wait-for-text.sh' section documenting flags. References are one level deep and navigation is easy, matching anchor 5; the inline agent-orchestration example is a headline use case rather than content that clearly belongs in a separate file, so anchor 4's 'minor organization gaps' does not fit better.

5 / 5

Total

18

/

20

Passed

Description

61%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.

The description has an explicit and useful 'Use when' trigger with good natural keywords and a distinct tmux niche, but it never states what the skill does — the capability side is entirely implied by 'control of a tmux session'. Adding concrete actions would raise both specificity and completeness.

Suggestions

Prepend a capability statement in third person, e.g. 'Creates and manages tmux sessions, sends keystrokes, and captures pane output' before the 'Use when' clause.

Add common trigger synonyms such as 'TTY', 'terminal session', or 'run a command in a terminal' to broaden natural keyword coverage.

Distinguish the trigger from plain background execution, e.g. 'Use when a CLI task needs an interactive TTY (not exec background mode) or control of a tmux session.'

DimensionReasoningScore

Specificity

The description names the domain ("CLI task", "interactive terminal", "tmux session") and one semi-concrete capability ("control of a tmux session"), but lists no concrete actions like creating sessions, sending input, or capturing output. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 2 because 'control of a tmux session' is more specific than the generic 'Processes PDF files' example, but it is not the several specific actions of anchor 4.

3 / 5

Completeness

The 'when' is explicit ("Use when a CLI task needs an interactive terminal or control of a tmux session"), but the 'what' is only weakly implied — no statement of what the skill actually does (create/manage tmux sessions, send keystrokes, capture output). This mirrors anchor 3 (one half explicit, the other missing or weak) rather than anchor 4, which requires both a what and a when.

3 / 5

Trigger Term Quality

Good natural keywords: "CLI task", "interactive terminal", "tmux session" — phrases a user would plausibly say when needing this skill. A few natural terms are missing (e.g., 'TTY', 'terminal session', 'run in background'), so it falls just short of the comprehensive synonym/extension coverage of anchor 5 while clearly exceeding the thin keyword sets of anchor 3.

4 / 5

Distinctiveness Conflict Risk

"tmux session" and "interactive terminal" carve out a clear niche that is unlikely to trigger for unrelated skills, with only minor overlap risk against generic terminal/shell-execution skills. It is mostly distinct (anchor 4) but not a fully self-contained niche description with explicit capability triggers as in anchor 5.

4 / 5

Total

14

/

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

HKUDS/nanobot

Path

nanobot/skills/tmux/SKILL.md

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.