Content
43%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 auto-generated CLI reference with genuine syntax and flags, but it contains duplicated sections, placeholder-only examples, junk generator artifacts, and no workflow or validation guidance for destructive commands. It reads as raw generator output rather than a curated skill.
Suggestions
Add validation and confirmation guidance for destructive operations (`memory clear`, `skills delete`, `plugin remove`), e.g. list affected items first, then require `--yes`, and verify the result afterward.
Move the bulk command/flag reference to a `references/cli.md` file and keep only a quick-start and common-use examples in SKILL.md.
Fix generator artifacts: remove the `PLUGIN_NAME`, `plugin plugin`, `skills skills`, and `skills skillssh` sections and the duplicate `skills list` / `skills install` sections, and make examples show realistic values instead of repeating the heading.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | No concept over-explanation, but roughly 40% of tokens are redundant: every "Example:" block repeats its heading verbatim, and `skills list` and `skills install` sections appear twice each. Could be tightened substantially. | 3 / 5 |
Actionability | Commands and flags are concrete and syntactically real, but examples are bare placeholders (`omniroute skills install <packageId>`) with no realistic values, and generator-junk entries (`PLUGIN_NAME`, `plugin plugin`, `skills skills`, `skills skillssh`) are not executable. | 3 / 5 |
Workflow Clarity | The body is a flat command catalog with no sequencing or usage guidance, and destructive operations (`memory clear`, `skills delete`, `plugin remove`) appear with a `--yes` flag but no validation or warning. More organized than incoherent, so not 1, but there is no sequence or checkpoint at all. | 2 / 5 |
Progressive Disclosure | No bundle files exist, and ~380 lines of API reference are inlined in SKILL.md where they belong in a separate reference file. Section headers provide real structure, so not 2, but the bulk content is not split out, so not 4. | 3 / 5 |
Total | 11 / 20 Passed |