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 highly actionable, token-efficient body with copy-paste commands, a bounded iteration workflow, and verified one-level-deep references. The only weaknesses are minor: tangled Managed CLI prose that could be tightened or split out, and one dangling example path in the Discovery section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational specifics and assumes CLI competence (e.g. "Endpoints are user-scoped, so do not pass -R owner/repo"), but the Managed CLI flag-behavior prose ("the binary rejects `--yes` after other subcommands, except for `setup` and `uninstall`, which take their own. glab's own `update` command also takes `--yes`") is tangled and could be a table or bullets. Not 5 because minor trimming and relocation to a reference file is possible; not 3 because there is no padding or explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Fully executable, copy-paste ready commands throughout: `glab orbit query 'CALL db.schema()'`, `glab orbit --install --yes`, `glab config set orbit_cli_auto_run true`, and pitfalls given as exact rejected vs. accepted syntax ("MATCH (p:Project) RETURN p LIMIT 5 rejects", "count(DISTINCT pl)"). Matches the top anchor of copy-paste ready commands covering common cases. | 5 / 5 |
Workflow Clarity | Sections sequence a real workflow (prerequisites on failure -> first-run setup, schema discovery "once per session", query construction with pitfalls, "at most 5 query attempts, validation errors included", reporting with coverage caveats) with error-recovery pointers to exit-code troubleshooting. Not 5 because checkpoints live partly in referenced files and there is no explicit ordered procedure; not 3 because validation and feedback loops are present and explicit. Queries are read-only, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references (references/troubleshooting.md, references/gql.md, references/reporting.md, references/maintaining.md) that all exist in the bundle with verifiable anchors, plus a topic-to-location table. Not 5 because the illustrative path `references/local/cli.md` cited in Discovery does not exist in this bundle, and the Managed CLI flag minutiae is arguably reference-file material — minor organization gaps matching the anchor 4 wording. | 4 / 5 |
Total | 17 / 20 Passed |