Content
93%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 lean, highly actionable instruction set with concrete git commands, a clear two-phase workflow, and an exact fallback response. Only minor edge-case handling (missing instructions directory, detecting a non-default upstream branch) is left unspecified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~18-line body is lean and assumes Claude's competence — "determine the merge base with the default branch... using `git merge-base HEAD origin/main`" — with no git concept explanations or padding, so every token earns its place; not 4 because there are no over-explanations to trim, only a trivial stylistic hedge ("equivalent of"). | 5 / 5 |
Actionability | Gives exact commands (`git diff`, `git diff --cached`, `git merge-base HEAD origin/main`, `git diff <merge-base>...HEAD`), a concrete target ("read every instruction file under `.github/instructions`"), and an exact output requirement ("respond exactly with: `No updates needed`") — copy-paste ready with no gaps for this task. | 5 / 5 |
Workflow Clarity | A clear ordered sequence (uncommitted diffs → merge-base diff → read instruction files → propose updates or decline) with an explicit gate ("After understanding all of these changes") and exact conditional responses; it misses 5 because edge-case checkpoints are absent — no handling of a missing `.github/instructions` directory and no way to detect a non-`origin/main` default branch beyond "unless configured otherwise". | 4 / 5 |
Progressive Disclosure | Under 50 lines, single task, no bundle files exist, and the body is well organized (numbered scope list, "Guidance" bullets, closing directive), which per the simple-skill guideline merits a 5 with no external references needed. | 5 / 5 |
Total | 19 / 20 Passed |