Content
100%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 an exemplary terse operational skill: copy-paste commands in every step, explicit validation gates and termination conditions throughout, no padding, and its one bundle script is real, correctly referenced, and behaves as described. No dimension shows a meaningful weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 19-line body contains no concept explanations and every sentence carries repo-specific knowledge Claude cannot infer ("A PR into `next` gets its body from `node .agents/pstack/land.mjs`. An agent that writes the body itself runs on a branch older than `next`'s agent rules.") or direct instruction, matching anchor 5's lean-and-efficient standard. | 5 / 5 |
Actionability | Every step ships a copy-paste-ready command (`git fetch <remote> next && git rev-list --count HEAD..<remote>/next -- AGENTS.md .agents .claude .codex`, the gh pr list/view/edit invocations, `node .agents/rules/contributor-setup/scripts/doctor.mjs`), and the doctor script was verified to print `fix:` lines and `ok:` as the body claims; the only delegation ("as the `plan-page` skill's PR section says, with `--into <file>`") is an explicitly signaled conditional branch, matching anchor 5. | 5 / 5 |
Workflow Clarity | The four steps are clearly sequenced with explicit gates and feedback loops even though the operation is batch (multiple PRs): "When it prints more than 0 ... and stop here", "apply what it prints until it prints `ok:`", and "This step is done when step 3's command prints nothing", so the batch-operation cap does not apply and anchor 5 fits. | 5 / 5 |
Progressive Disclosure | For an under-50-line skill the single-bundle-file structure is ideal: scripts/doctor.mjs exists in the bundle and is referenced exactly where needed via its repo path, and external pointers (`.agents/pstack/rules/land.md`, the `plan-page` skill) are one level deep and clearly signaled, matching the simple-skill anchor-5 case. | 5 / 5 |
Total | 20 / 20 Passed |