using-tmux-for-interactive-commands

Use when you need to run interactive CLI tools (vim, git rebase -i, Python REPL, etc.) that require real-time input/output - provides tmux-based approach for controlling interactive sessions through detached sessions and send-keys

Quality

88%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

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

This is a solid, actionable skill that provides clear, executable guidance for using tmux to control interactive CLI tools. Its main strengths are the concrete code examples, well-structured workflow, and comprehensive common mistakes section. Weaknesses include some verbosity (the 'Real-World Impact' section, some obvious guidance in 'When to Use'), a hardcoded file path reference without supporting bundle files, and content that could benefit from slightly tighter editing.

Suggestions

Remove the 'Real-World Impact' section entirely — it restates benefits Claude can infer and adds no actionable guidance.

Either include the tmux-wrapper.sh in the bundle or remove the reference to the hardcoded path `/home/jesse/git/interactive-command/tmux-wrapper.sh`, which cannot be verified.

Dimension	Reasoning	Score
Conciseness	Generally efficient but includes some unnecessary sections like 'Real-World Impact' which restates obvious benefits Claude would already understand, and the 'When to Use' / 'Don't use for' lists contain some obvious guidance. The 'Before (Won't Work)' example adds marginal value. However, most content is practical and useful.	2 / 3
Actionability	Provides fully executable, copy-paste ready commands throughout. The quick reference table, core pattern, common patterns (Python REPL, Vim, Git Rebase), and common mistakes sections all contain concrete, runnable bash commands with specific tmux key names and arguments.	3 / 3
Workflow Clarity	The 'Basic Workflow' section provides a clear 6-step sequence. Each common pattern example follows the create → wait → send → capture → cleanup sequence. The 'Common Mistakes' section serves as validation guidance with explicit problem/fix pairs, and the cleanup step is consistently emphasized to prevent orphaned sessions.	3 / 3
Progressive Disclosure	The content is well-structured with clear sections and a quick reference table, but it's somewhat long for a single file. The reference to `/home/jesse/git/interactive-command/tmux-wrapper.sh` is a hardcoded path that may not exist, and no bundle files are provided to support it. The 'Real-World Impact' section could be omitted, and some content could be split into a separate reference file.	2 / 3
	Total	10 / 12 Passed

Description

100%

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 is a strong skill description that clearly communicates what the skill does (tmux-based interactive session control), when to use it (interactive CLI tools requiring real-time I/O), and provides concrete examples (vim, git rebase -i, Python REPL). It occupies a distinct niche and uses natural trigger terms that users would employ when needing this capability.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions and examples: 'run interactive CLI tools (vim, git rebase -i, Python REPL, etc.)' and specifies the approach: 'tmux-based approach for controlling interactive sessions through detached sessions and send-keys'.	3 / 3
Completeness	Clearly answers both what ('tmux-based approach for controlling interactive sessions through detached sessions and send-keys') and when ('when you need to run interactive CLI tools that require real-time input/output') with an explicit 'Use when' clause at the start.	3 / 3
Trigger Term Quality	Includes strong natural trigger terms users would say: 'interactive CLI tools', 'vim', 'git rebase -i', 'Python REPL', 'real-time input/output', 'tmux', 'interactive sessions', 'send-keys'. These cover common variations of how users would describe needing this skill.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive niche — interactive CLI tools via tmux is a very specific use case unlikely to conflict with other skills. The mention of tmux, detached sessions, and send-keys clearly separates it from general CLI or terminal skills.	3 / 3
	Total	12 / 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: obra/superpowers-lab
Commit: 51111f7

Reviewed: about 1 month 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.