Content
82%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.
A lean, highly actionable instruction skill: every workflow is keyed to a concrete trigger and backed by copy-paste-ready tool and CLI invocations with example arguments. The only notable weakness is the single dense 'Reviewing candidates' paragraph, which buries several commands and would benefit from a list or sub-structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — "`get_why` has four modes — pick by what you pass", no explanations of concepts Claude already knows. Not 5: the 'Reviewing candidates' section is one dense paragraph packing seven commands and could be trimmed or split. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: `get_why(query="why is auth using JWT?")` with all four call modes shown concretely, and complete CLI invocations like `repowise decision add --agent <your slug> --title "..." --decision "..." --rationale "<why, and what you rejected>" --affects <path>` and `repowise decision confirm <id> --agent <your slug> --evidence <commit|file>` covering the common cases. | 5 / 5 |
Workflow Clarity | Scenario-keyed sections give clear sequences, e.g. "1. Call `get_why(query="the specific area you're changing")`... 2. If decisions are found, present them to the user before proceeding... 3. If no decisions are found, proceed but note..." — a real checkpoint, plus refusal handling ("If the repository turned agent acceptance off, the confirm is refused; leave it for a person"). Not 5: the candidates-review flow is prose rather than a sequenced list and its checkpoints (checking `blockers`, resolving, confirming) are implicit. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; the ~61-line body is organized into clear, well-labeled sections keyed to usage triggers, which is good structure. Not 5: it sits just above the simple-skill (~50-line) range and the monolithic 'Reviewing candidates' paragraph is a candidate for being broken out or restructured. | 4 / 5 |
Total | 17 / 20 Passed |