Content
72%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, token-efficient command reference with strong copy-paste examples, but it reads as a command catalog rather than a guided workflow — verification steps after sending input are missing, and the bundled helper scripts are never mentioned. Wiring the body's patterns to the existing scripts and adding a verify-after-send loop are the highest-leverage fixes.
Suggestions
Reference the bundled helpers where they fit, e.g. under a 'Scripts' section: "List sessions across sockets: scripts/find-sessions.sh -A" and "Block until a pane shows a pattern: scripts/wait-for-text.sh -t worker-3 -p 'permission'".
Add a verify-after-send feedback loop to the Claude Code patterns: after send-keys, re-capture the pane (or run wait-for-text.sh) to confirm the input was received before proceeding.
Trim the environment-specific Example Sessions table and note that kill-session is destructive and should be preceded by a capture-pane check on the target session.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, comment-annotated command catalog that assumes tmux knowledge and never explains background concepts, matching the 'efficient; minor instances that could be trimmed' anchor. Not a 5 because the environment-specific "Example Sessions" table (worker-2 through worker-8) and some overlap between the Session Management section and the When-NOT-to-Use list are padding that could be cut. | 4 / 5 |
Actionability | Nearly every line is a copy-paste-ready command with inline comments ("tmux capture-pane -t shared -p -S -", "tmux send-keys -t shared -l -- \"...\""), and the common cases — listing, capturing, sending text/special keys, navigation, session lifecycle, and Claude Code prompt-approval patterns — are all covered with concrete examples, matching the fully-executable anchor. Not a 4 because there are no pseudocode or missing-detail gaps. | 5 / 5 |
Workflow Clarity | A usable sequence exists across the Claude Code patterns (capture output, grep for prompts, then send 'y'/Enter), but validation checkpoints are implicit — there is no step verifying that sent input actually landed or that a task finished, and the destructive kill-session command appears with no confirmation guidance, matching the 'sequence present but checkpoints missing or implicit' anchor. Not a 4 because verification (e.g., re-capturing the pane after sending, or using a wait-for-text loop) is entirely absent rather than a minor gap. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned with clear headers, but the bundle's actual scripts (scripts/find-sessions.sh, scripts/wait-for-text.sh) are never referenced anywhere in the SKILL.md, so content that belongs in — or is already in — separate files is neither surfaced nor navigable. This sits between anchor 2 (references buried/unused bundle structure) and anchor 4 (references mostly clear); it is a 3 rather than a 4 because the existing reference paths go completely unmentioned, and better than a 2 because the inline content itself is well organized and appropriately sized. | 3 / 5 |
Total | 15 / 20 Passed |