Content
76%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 one-line delegation to the moai skill's sync command, which is ideal for token efficiency. Its weaknesses are the total absence of validation guidance for the batch doc-sync and PR-creation workflow it triggers, and the lack of any context about what "sync" does or accepts.
Suggestions
Add a brief line stating what `sync` does plus one example invocation with concrete arguments, e.g. `Skill("moai") with arguments: sync docs/ --dry-run`.
Include a verification step, e.g. "After sync, confirm the pull request was created and summarize the changed files for the user before finishing."
Add a minimal heading or one-line overview so the file has basic structure and signals what the delegation covers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The entire body is one line — "Use Skill(\"moai\") with arguments: sync $ARGUMENTS" — with zero padding, zero explanation of concepts Claude already knows, and nothing that could be trimmed; every token earns its place. | 5 / 5 |
Actionability | The delegation directive is concrete and executable as written (exact skill name "moai", subcommand "sync", argument pass-through "$ARGUMENTS"), so it meets "concrete code or commands with minor gaps" (4). It falls short of 5 because no examples cover common cases — there is no sample invocation or indication of what arguments "sync" accepts or produces. | 4 / 5 |
Workflow Clarity | The single action is unambiguous in form, but per the skill's own description it performs batch operations — "Synchronize documentation, codemaps, and create pull request" — and the body contains no validation or verification step anywhere. The rubric caps batch/destructive skills without validation at 3, and this cap explicitly takes precedence over the simple-skill exception. | 3 / 5 |
Progressive Disclosure | The one-line body delegates to a single, clearly signaled target one level deep (Skill("moai")), and there is no bundle content to split — no references/, scripts/, or assets/ directories exist, so nothing is improperly inlined. It sits just below 5 because the file has no organizational structure at all: no heading, no overview line, and no indication of what "sync" covers. | 4 / 5 |
Total | 16 / 20 Passed |