Content
92%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 model of lean, executable instruction: concrete commands with explicit placeholder handling, an ordered workflow with tool verification and error recovery, and explicit do-not-exceed boundaries. Its only blemish is the time-sensitive "(tested with 0.5.4)" version pin, which is the sole reason conciseness does not score 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and purely instructional ("Use `weave preview BRANCH`, replacing BRANCH with the shell-quoted requested ref") with every sentence directing action, but the time-sensitive pin "(tested with 0.5.4)" is the one trims-worthy instance per the version-number guideline, holding it at "minor instances of over-explanation" (anchor 4) rather than anchor 5. | 4 / 5 |
Actionability | Commands are concrete and executable as written — `weave --version`, `weave preview BRANCH`, and `weave preview BRANCH --file path/to/file` — with explicit placeholder-substitution guidance and both the whole-branch and single-file cases covered; not 4 because there is no material gap in the common cases. | 5 / 5 |
Workflow Clarity | The sequence is clear and ordered (confirm the tool via `weave --version`, identify the ref, check working-tree status, preview, then "Report the conflicts or independent entity changes the preview actually shows") with an explicit error-recovery path ("If absent, explain the prerequisite"); the skill is explicitly read-only, so the destructive-operation validation cap does not apply. | 5 / 5 |
Progressive Disclosure | At ~25 lines with no external references needed and no bundle files present, the single well-organized flow satisfies the simple-skill exception: nothing is inlined that belongs in a separate file, and there are no nested or buried references. | 5 / 5 |
Total | 19 / 20 Passed |