Content
96%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 exceptionally tight, fully actionable operating procedure: exact commands, explicit sequencing, validation before every write, and error-recovery loops, with no filler. The only structural gap is that everything lives inline in one file; a reference file for the GraphQL field schema would lighten the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout: it never explains concepts Claude already knows and spends every line on system-specific rules ("Never call api.linear.app directly", exact env vars, marker comments). Nothing reads as padding, so it matches the 'every token earns its place' anchor rather than the 'minor instances of over-explanation' anchor at 4. | 5 / 5 |
Actionability | Guidance is fully executable: a copy-paste curl wrapper for the GraphQL endpoint, an exact GraphQL field list with pagination instructions, concrete git and gh commands ("git ls-remote --exit-code --heads origin tessl/<id>", "gh pr create --base <base> --label tessl ... --body-file <file outside the clone>"), and verbatim comment templates. The remaining placeholders are deliberate variables, not gaps, which keeps it above the 'minor gaps' anchor at 4. | 5 / 5 |
Workflow Clarity | The process is explicitly sequenced ("Read the record and take the first situation that applies") with a done-checklist, validation checkpoints (re-read the issue before every write, check situation 1 before every write, re-run tests after merging the base), and error-recovery loops ("If it fails or prints no URL, run gh pr list --head <branch> --state open before trying again"; failed setup.sh escalates to situation 4). Destructive-adjacent operations all carry validation (force-push only with --force-with-lease=<branch>:<head you read>), so the cap-3 rule for unvalidated destructive workflows does not apply. | 5 / 5 |
Progressive Disclosure | Sections are clear and easy to navigate (inputs, Linear, finished state, situations, invariants, doing the work, judgment), but it is a ~150-line single file with no bundle files and no content split out, so it fits 'good structure; most content appropriately placed; minor organization gaps' rather than the 5 anchor, which expects well-signaled one-level-deep references. The under-50-line simple-skill exception does not apply at this length. | 4 / 5 |
Total | 19 / 20 Passed |