Content
96%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 an exemplary tool-usage reference: dense with non-obvious specifics, fully executable commands, explicit MCP-vs-CLI routing, and concrete output-rendering rules. Its only structural limitation is that it is a single inline reference with no progressive disclosure into bundle files, which is acceptable at this size but leaves minor room to split the CLI syntax into a reference file.
Suggestions
Move the '## CLI' block (full flag/syntax reference, ~30 lines) into a references/cli.md file and keep a 3-4 line quick-start in SKILL.md to improve progressive_disclosure while trimming inline tokens.
The 'Four questions, four verbs' table and the MCP table both enumerate the same verb set; consider merging the MCP-tool column into the single questions table to remove one redundant listing and boost conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every section carries tool-specific facts Claude cannot know (MCP parameter combinations, CLI flags, exit codes, the GNU Parallel name conflict, legacy verb aliases). Not 4: there is no over-explanation of concepts Claude already knows to trim; the parallel MCP/CLI listings cover distinct invocation surfaces rather than padding. | 5 / 5 |
Actionability | All guidance is copy-paste ready: complete CLI commands with flags and expected output shapes ("definition: type name file:line", "exit 0 pass, 1 fail, 2 could not decide"), MCP calls with concrete parameter values ("query: 'X', mode: 'context'"), and a worked ASCII-tree example. Not 4: the examples cover the common cases completely. | 5 / 5 |
Workflow Clarity | Task-to-command mappings are unambiguous via two tables, with an explicit precedence rule ('If the agent has the sem MCP server... call those instead of running sem in a shell'), fallback behavior, and an install-conflict check. The skill is a lookup/reference skill with no destructive or batch operations, so no validation checkpoints are required. Not 4: the decision flow (MCP first, CLI fallback, version check) is fully explicit. | 5 / 5 |
Progressive Disclosure | Sections are well-organized (questions table, MCP routing, CLI reference, output-formatting rules, install check) and nothing is a wall of text, but there are no bundle files or references at all — the full CLI syntax reference is inlined in a ~130-line SKILL.md. Not 5: the body exceeds the under-50-line simple-skill exception and the CLI reference block could live in a references file; not 3: structure is clear and content is appropriately dense, with nothing misfiled. | 4 / 5 |
Total | 19 / 20 Passed |