Content
72%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 maximally lean, unambiguous delegator that cleanly hands off to the moai skill with no wasted tokens or nested references. Its weaknesses are that it forwards without any detail on the subcommands it advertises (status/apply/rollback/disable) and provides no validation checkpoint for the state-changing operations in its scope.
Suggestions
Add a one-line table or list of the harness subcommands (e.g. status, apply, rollback, disable) with the arguments each accepts so the forwarding instruction is actionable without opening the moai skill.
Include one or two concrete invocation examples showing typical $ARGUMENTS values.
Mention the approval/verification gate (e.g. confirm with the user before apply or rollback) so state-changing operations have an explicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a single line — 'Use Skill("moai") with arguments: harness $ARGUMENTS' — with zero padding, no explanation of concepts Claude already knows, and every token earning its place. This matches the 'lean and efficient' anchor exactly. | 5 / 5 |
Actionability | The instruction is concrete — an exact skill name ('moai') and exact argument prefix ('harness') — but it is incomplete: there are no usage examples, no list of valid subcommands or arguments, and the full substance is delegated to a skill whose behavior is not described anywhere in this bundle. This fits 'some concrete guidance but incomplete; missing key details' better than 'mostly executable with minor gaps'. | 3 / 5 |
Workflow Clarity | As a simple single-action skill the forwarding step is unambiguous, which alone could score 5 under the simple-skill exception. However, the skill's stated scope includes state-changing operations — 'apply', 'rollback', and 'disable' of the harness learning subsystem — and the body contains no validation or verification step for them, which caps workflow clarity at 3 per the destructive-operations guideline. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist), so nothing needs splitting. The single delegation to Skill("moai") is a clearly signaled, one-level-deep pointer with nothing buried or nested — matching the well-organized simple-skill case that merits a 5. | 5 / 5 |
Total | 16 / 20 Passed |