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.
An exemplary instruction-only skill body: lean, fully executable (exact git commands, verbatim subagent briefs, prescribed edge-case outcomes), and a clearly sequenced workflow with explicit validation and termination checkpoints. The one real defect is that the workflow's load-bearing reference, ./rules.md, is not present in the bundle, so the promised content split cannot be followed as written.
Suggestions
Ship rules.md inside the skill bundle (e.g., references/rules.md) and update the three ./rules.md links — step 4 requires pasting its 'Edge cases and guards' section in full, which is impossible when the file is absent.
If rules.md intentionally lives outside the bundle (e.g., at the repo root alongside AGENTS.md), say so explicitly at first mention so the relative link does not read as a bundle file that fails to resolve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~28 lines with zero padding: no git/Linear/GitHub concepts are explained ("Fetch the issue with the Linear or GitHub tools" assumes competence), and constraints are stated as tight imperatives ("At most 400 words", "Stop here if the diff is empty"). Every sentence instructs. This matches the 'lean and efficient; every token earns its place' anchor. Not 4: there are no over-explanations to trim. | 5 / 5 |
Actionability | Concrete commands are given verbatim ("git diff <fixed-point>...HEAD", "git log --oneline <fixed-point>..HEAD", "Confirm it with git rev-parse"), discovery patterns are specified ("a Linear key (SB-1234) or Closes #N"), and both subagent briefs are quoted copy-paste ready with word limits. The output format is fully determined ("## Standards" / "## Spec", one summary line per axis). Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this actionable. Not 4: no gaps — even the empty-diff and no-spec edge cases have prescribed outcomes. | 5 / 5 |
Workflow Clarity | Five numbered, strictly ordered steps with explicit checkpoints: "Confirm it with git rev-parse", "Stop here if the diff is empty", a fallback chain for spec discovery (spec file → tracker key → PR body → "no spec"), and a termination condition ("Done when both axes have reported, or the Spec axis has reported 'no spec'"). The workflow is read-only, so the destructive/batch validation cap does not apply. Not 4: validation and exit conditions are explicit at every decision point, not mostly present. | 5 / 5 |
Progressive Disclosure | The body itself is well organized (under 50 lines, clear sections) and its single reference is clearly signaled and one level deep: "Both follow the [review rules](./rules.md)", "the section 'Edge cases and guards' from [the review rules](./rules.md), pasted in full". However, no bundle directories (references/, scripts/, assets/) exist and rules.md is absent from the bundle, so the skill's central reference — whose content step 4 depends on — dead-ends. Not 4: a missing referenced file is more than a 'minor organization gap'; not 2: the reference is clearly signaled, not buried, and nothing is wrongly inlined. | 3 / 5 |
Total | 18 / 20 Passed |