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 command catalog that is lean on concept explanations but suffers from garbage/duplicate entries, non-executable placeholder examples, and no validation guidance for destructive operations. It also keeps the full reference inline rather than splitting it into bundled files.
Suggestions
Remove generator artifacts and duplicates: 'PLUGIN_NAME', 'plugin plugin', 'skills skills', 'skills skillssh', and the repeated 'skills list' / 'skills install' entries.
Add at least one fully runnable, real-value example per destructive command and a validation/confirmation step (e.g. run 'memory list' before 'memory delete', confirm the targeted id).
Move the bulk command reference into a bundled reference file (e.g. references/commands.md) and keep SKILL.md as a concise overview with a clearly signaled link, so progressive disclosure improves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The reference avoids concept-explanation fluff, but it carries clear bloat from generator artifacts and duplicates ('PLUGIN_NAME', 'plugin plugin', 'skills skills', 'skills skillssh', repeated 'skills list' and 'skills install') that should be trimmed; not 2 because no concepts are over-explained. | 3 / 5 |
Actionability | Real commands and flags are listed, but every example is a non-executable template using placeholders like '<query>', '<id>', and '[query]', so examples are not copy-paste runnable; not 4 because the placeholders are pervasive rather than minor gaps. | 3 / 5 |
Workflow Clarity | The body is a flat command catalog with no sequencing, and destructive/batch commands ('memory clear', 'memory delete', 'skills delete', 'skills disable', 'plugin remove') have no validation or feedback steps; the destructive-operations cap allows at most 3, and the absent sequence/validation pulls it to 2. | 2 / 5 |
Progressive Disclosure | Section headers per subcommand give some structure, but the entire ~380-line command reference is inlined in SKILL.md with no external reference files (none of references/scripts/assets exist); the simple-skill exception does not apply at this length, so content that should be split out stays inline. | 3 / 5 |
Total | 11 / 20 Passed |