Content
78%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 delegation stub that scores perfectly on conciseness and disclosure. Its weakness is actionability: it provides the invocation syntax but delegates all executable knowledge elsewhere, leaving no in-skill guidance on what the delegated command does or how to handle its results.
Suggestions
Add one line explaining what the delegated "run" command produces or what to do with its output, so the skill remains actionable even if the "moai" skill is unavailable.
State a fallback behavior for the $ARGUMENTS placeholder (e.g., what to pass or ask for when no arguments are supplied).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a single line — "Use Skill(\"moai\") with arguments: run $ARGUMENTS" — with zero padding and no explanation of concepts Claude already knows. It matches anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place"). | 5 / 5 |
Actionability | The instruction is concrete in form (exact skill name and exact argument format "run $ARGUMENTS"), but all substance is delegated to an external "moai" skill: nothing explains what the "run" argument does, there is no usage example, and "$ARGUMENTS" is an unresolved placeholder. This matches anchor 3 ("Some concrete guidance but incomplete... missing key details") rather than anchor 4's mostly-complete executable guidance. | 3 / 5 |
Workflow Clarity | As a simple single-purpose skill the action is unambiguous — invoke skill "moai" with arguments "run <args>" — so the simple-skill exception applies. However, minor gaps remain: no guidance on handling the delegated skill's result, or what to do when $ARGUMENTS is empty, which places it at anchor 4 ("minor validation gaps") rather than a fully unambiguous 5. | 4 / 5 |
Progressive Disclosure | The body is one line, well under 50 lines, with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references. The entire content is a clearly signaled one-level-deep pointer, which per the simple-skills scoring note merits a 5. | 5 / 5 |
Total | 17 / 20 Passed |