using-tmux-for-interactive-commands

59 stars 3 forks
74
C

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

Also in: git

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install obra/superpowers-lab/using-tmux-for-interactive-commands
skilz install obra/superpowers-lab/using-tmux-for-interactive-commands --agent opencode
skilz install obra/superpowers-lab/using-tmux-for-interactive-commands --agent codex
skilz install obra/superpowers-lab/using-tmux-for-interactive-commands --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/obra/superpowers-lab
2. Copy the agent skill directory:
cp -r superpowers-lab/skills/using-tmux-for-interactive-commands ~/.claude/skills/

Need detailed installation help? Check our platform-specific guides:

Related Agentic Skills

Agentic Skill Details

Stars
59
Forks
3
Type
Technical
Meta-Domain
development
Primary Domain
python
Market Score
74

Agent Skill Grade

C
Score: 74/100 Click to see breakdown

Score Breakdown

Spec Compliance
12/15
PDA Architecture
19/30
Ease of Use
21/25
Writing Style
7/10
Utility
16/20
Modifiers: -1

Areas to Improve

  • No layered reference structure
  • Missing TOC for long file
  • Hardcoded external path

Recommendations

  • Address 1 high-severity issues first
  • Add trigger phrases to description for discoverability
  • Add table of contents for files over 100 lines

Graded: 2026-01-05

Developer Feedback

I took a look at your using-tmux-for-interactive-commands skill and wanted to share some thoughts.

Links:

The TL;DR

You're at 74/100, solid C-grade territory. This skill is based on Anthropic's best practices for agentic skills. Your strongest area is Ease of Use (21/25)—the metadata and trigger terms are spot-on. The weakest link is Progressive Disclosure Architecture (19/30)—everything's crammed into one 179-line file when it should be layered.

What's Working Well

  • Excellent trigger phrases in the description (vim, git rebase -i, Python REPL). That specificity is exactly what makes skills discoverable.
  • Practical examples with real I/O—the vim and Python REPL examples show exactly what the commands do. That's chef's kiss for clarity.
  • Solid utility core. You're solving a real gap: Claude can't naturally control interactive tools. That's genuinely valuable for agent workflows.
  • Consistent terminology throughout (session, send-keys, capture-pane). Makes it way easier to follow.

The Big One: Single File Should Be Layered

Right now you've got 179 lines in one SKILL.md. That kills your PDA score (19/30) because users have to scroll through everything to find what they need.

The fix: Create a references/ directory and split the skill:

using-tmux-for-interactive-commands/
├── SKILL.md (80 lines max - overview + quick reference + Core Pattern)
├── references/
│   ├── common-patterns.md (detailed patterns)
│   ├── common-mistakes.md (troubleshooting)
│   └── tmux-wrapper.sh (bundled script)

Keep SKILL.md focused on the essentials, use frontmatter links to pull in references w...

Report Security Issue

Found a security vulnerability in this agent skill?