Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
81
Quality
77%
Does it follow best practices?
Impact
86%
2.00xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/tmux/SKILL.mdQuality
Discovery
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.
This description effectively communicates specific technical capabilities for tmux automation with good distinctiveness. However, it lacks explicit trigger guidance ('Use when...') and could benefit from more natural user-facing keywords beyond the technical terminology.
Suggestions
Add a 'Use when...' clause with trigger scenarios like 'Use when automating interactive CLI programs, controlling terminal sessions, or when the user needs to interact with programs that require keyboard input'
Include additional natural trigger terms users might say: 'terminal automation', 'interactive programs', 'send keys', 'automate CLI', 'terminal control'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'remote-control tmux sessions', 'sending keystrokes', and 'scraping pane output'. These are specific, actionable capabilities. | 3 / 3 |
Completeness | Clearly describes what it does (remote-control tmux, send keystrokes, scrape output) but lacks an explicit 'Use when...' clause to guide Claude on when to select this skill. | 2 / 3 |
Trigger Term Quality | Includes good technical terms like 'tmux', 'keystrokes', 'pane output', but missing common user phrases like 'terminal automation', 'interactive programs', 'CLI tools', or 'send keys'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche - tmux session control is specific and unlikely to conflict with other skills. The combination of 'tmux', 'keystrokes', and 'pane output' creates a clear, unique domain. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-crafted skill that provides concrete, executable tmux commands with excellent organization. The 'When to Use' and 'When NOT to Use' sections effectively scope the skill. Minor improvement could be made by adding verification steps after sending keys to confirm the expected state change occurred.
Suggestions
Add a verification pattern after send-keys commands (e.g., capture-pane to confirm the input was received and processed)
Include a brief troubleshooting section for common issues like 'session not found' or 'pane is in copy mode'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is lean and efficient with no unnecessary explanations. Every section provides direct, actionable commands without explaining what tmux is or how terminals work. | 3 / 3 |
Actionability | Fully executable bash commands throughout with copy-paste ready examples. Includes specific patterns for common use cases like checking session status and approving prompts. | 3 / 3 |
Workflow Clarity | Commands are well-organized by category, but the 'Sending Input Safely' section hints at potential issues without providing explicit validation or error recovery steps. No feedback loops for verifying commands succeeded. | 2 / 3 |
Progressive Disclosure | Well-structured with clear sections progressing from basic commands to specific patterns. Content is appropriately sized for a single file with logical organization and a helpful table for session examples. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
8763418
Table of Contents
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.