Content
87%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.
An exemplary lean SKILL.md body: copy-paste-ready commands, high-value gotchas, and a clean one-level-deep reference split verified against the actual bundle. The single notable gap is the absence of validation or verification steps around its destructive operations (deleting humans, recalculating permission levels), which caps workflow clarity.
Suggestions
Add verification steps after destructive or permission-changing operations, e.g. run 'agt get humans <name> -o json' after a level change to confirm the recalculated groupAllowFrom entries, or confirm the human no longer appears after 'agt delete human'.
Note in the Operation Reference that 'agt delete human' is irreversible and should be confirmed with the admin before execution, providing an explicit checkpoint for the destructive path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries non-obvious project knowledge — the groupAllowFrom mechanics, ignored-flag semantics, auto-registered Matrix accounts, and the no-container/MinIO/Higress exception — with zero padding or explanation of concepts Claude already knows. This matches the 'lean and efficient; every token earns its place' anchor exactly. | 5 / 5 |
Actionability | The Quick Create block is a complete, copy-paste-ready bash invocation with realistic values, and the Operation Reference gives concrete executable commands ('agt get humans', 'agt delete human <name>'). This matches the 'fully executable, copy-paste ready, covers common cases' anchor. | 5 / 5 |
Workflow Clarity | The body delegates the create workflow to the reference and offers no sequence for the destructive operations it surfaces ('agt delete human', level changes that recalculate all groupAllowFrom). Per the rubric, a skill involving destructive operations without validation/verification steps is capped at 3 regardless of simplicity — checkpoints are absent, not merely implicit, so it cannot score 4. | 3 / 5 |
Progressive Disclosure | The body is a clear overview that splits detail correctly: the full workflow lives one level deep in references/create-human.md (verified to exist and to not nest further), and the Operation Reference table maps each admin intent to the right file or command. This matches the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 18 / 20 Passed |