Content
88%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 dense, highly actionable procedural skill: concrete commands with error-recovery paths, explicit validation gates before every destructive or outward-facing action (push, PR-body edit), and one clearly-signaled reference file. The only trimmable fat is partial duplication between the body's Step 2 readings and `references/card-signals.md`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every rule is a non-obvious, repo-specific failure mode ("Never present a zero-spend card as a cheap session", "a `grep -c '<details>'` then reports a block that is not there") with no explanation of concepts Claude already knows. It falls short of lean, though: the Step 2 "Three readings that are wrong every time" taxonomy largely restates what `references/card-signals.md` already carries, and a few dense parenthetical passages could be tightened. | 4 / 5 |
Actionability | Fully executable throughout: the three pre-flight probes, `bun run --cwd tools/pr-metrics card -- --resolve-issue --base "$BASE"`, the commit/push/PR-body-edit sequence, and specific recovery flags (`--pr <n>`, `--issue <n>`, `--format markdown`) are copy-paste ready and cover the common cases plus their failure modes. | 5 / 5 |
Workflow Clarity | Steps 1–7 are clearly sequenced with explicit validation checkpoints and feedback loops: the environment probe block, the merged/closed PR-state check that halts the push and body edit, the duplicate-`<details>` check before appending, and card-exit-1 handling with three distinct recovery paths (rerun with `--pr`, rerun with `--resolve-issue`, or stop and quote in RETRO.md). | 5 / 5 |
Progressive Disclosure | The single bundle reference is real, one level deep, and well-signaled — "`references/card-signals.md` maps each of those to the question it answers… Read it before Step 3" — and operational detail in the body is appropriately separated from field-by-field reference material. It is not a 5 because the ~380-line body inlines some material (the `complexity.method` readings) that the reference file already covers, a minor organization gap. | 4 / 5 |
Total | 18 / 20 Passed |