Content
56%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.
The body is a well-organized, actionable command cheat sheet, but it overwhelmingly restates basic Bash knowledge Claude already has, offers little non-obvious value (no gotchas like macOS sed -i differences or kill -9 caveats), and is a monolithic single file with a meaningless circular 'When to Use' section.
Suggestions
Cut the tables of commands Claude already knows and keep only the non-obvious material: platform differences (e.g., sed -i requires an argument on macOS), kill -9 caveats, quoting pitfalls, and trap/set behavior.
Replace the circular 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview') with concrete guidance on when each pattern applies.
Split the reference into a lean SKILL.md overview plus a references/ file (e.g., command tables) to reduce inline bulk and support progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Although formatted as terse tables, nearly the entire body documents commands and concepts Claude already knows (ls, head, tail, ps aux, grep, sed, awk, env, curl, set -euo pipefail), so most of the ~200 lines add no new knowledge — noticeably below the mostly-efficient anchor, though not 'heavily padded' prose. | 2 / 5 |
Actionability | Commands are concrete and mostly copy-paste ready ('find . -name "*.js" -type f', 'kill -9 $(lsof -t -i :3000)', a complete script template), with only minor placeholders (URL, <PID>) leaving small gaps. | 4 / 5 |
Workflow Clarity | As a single-purpose command reference with well-organized numbered sections, organization is unambiguous, but there is no validation guidance around destructive commands (kill -9, sed -i, rm) and the trailing 'When to Use' section is circular filler ('applicable to execute the workflow or actions described in the overview') that provides no sequencing value. | 4 / 5 |
Progressive Disclosure | No bundle files exist and no external references are signaled; all ~200 lines are inlined monolithically in SKILL.md, beyond the under-50-line simple-skill exception. Section structure is present, but content that could be split out (e.g., the PowerShell comparison) is inlined. | 3 / 5 |
Total | 13 / 20 Passed |