Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-guarded tmux reference with executable idempotent patterns and clear validation checkpoints. Its main weaknesses are repeated boilerplate across code blocks and a monolithic single-file structure that does not leverage progressive disclosure.
Suggestions
Define the SESSION derivation once and reference it, or factor it into a small sourced snippet, instead of repeating the full `basename $(git rev-parse ...)` line in every code block.
Consider moving the 'Common Patterns' and 'When to Use tmux' reference material into a separate file (e.g. references/patterns.md) linked from the body to apply progressive disclosure and slim the main SKILL.md.
Consolidate the overlapping 'Session Reuse Rules' and 'Isolation Rules' sections into a single hard-requirements block to remove redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean code with minimal concept explanation, but the `SESSION=$(basename $(git rev-parse ...))` line is repeated verbatim in nearly every code block and the 'Session Reuse Rules'/'Isolation Rules' sections overlap, so it could be tightened; not the level-3 'every token earns its place' bar. | 2 / 3 |
Actionability | Abundant concrete, executable, copy-paste-ready bash with real tmux commands and idempotent guards, matching the level-3 anchor for fully executable guidance. | 3 / 3 |
Workflow Clarity | Operations are sequenced with explicit validation checkpoints (has-session / list-windows checks before creation, verify-session-name before kill, ready-poll loop), satisfying the level-3 anchor for clear sequences with validation. | 3 / 3 |
Progressive Disclosure | It is a single ~210-line monolithic file with well-organized sections but no file splitting or referenced materials; at this size some content (e.g., the common-patterns library) could be offloaded to a reference, so it sits at level 2 rather than the level-3 split-and-navigate anchor. | 2 / 3 |
Total | 10 / 12 Passed |