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.
An unusually well-executed procedural skill: every command is literal and executable, destructive edges (PR body edits, directory-wide staging) have explicit guards, and all explanation is project-specific rather than filler. The minor weaknesses are repetition between the description and the opening sections, and rationale prose that could be split into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every paragraph carries non-obvious project constraints Claude could not know (the cross-repository `.closingIssuesReferences[0].number` bug, the private-tracker label rule, the guarded `git add`) — no padding on concepts Claude already knows. Not 5 because "When to run this instead of `retro`" and "Where this sits" repeat the description and state the deferred-analysis point twice, and a few rationale passages (e.g. the transcript-lifecycle paragraphs) could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: the three environment probes, `bun run --cwd tools/pr-metrics card -- --resolve-issue` with the markdown variant, the guarded `git add`/commit/push, the PR body append, and the idempotency `grep`. Common cases and failure modes (no `gh`, no network) are covered with concrete instructions. Not 4 because there is no gap — every step is a literal command with its purpose stated inline. | 5 / 5 |
Workflow Clarity | Clear sequence (probe → write card → render onto PR → finish) with explicit validation checkpoints: the pre-flight network/`gh`/transcripts probe, the grep guard against stacking a second `<details>` block, the single-file staging rule, and recovery paths ("record which and carry on", "commit the card locally; it pushes with the next push"). The destructive risks the workflow does carry (PR body edit, commit/push) are each guarded. Not 4 because checkpoints and error-recovery guidance are present at every stage, not just most. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so this is a single-file skill with clean section headers and no nested references — nothing buried, nothing orphaned. Not 5 because at ~160 lines several long rationale blocks (the four rules in Step 1, the hook and transcript-lifecycle notes) are execution-adjacent rather than execution-critical and could live in a reference file, per the under-50-lines exception not applying here. | 4 / 5 |
Total | 18 / 20 Passed |