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 dense, executable workflow: copy-paste gh commands, explicit admission gates, per-signal scoring rubrics, and hard-fail non-negotiables, with no filler. The only structural note is that a ~119-line single-file body could offload its output template and test-path mapping to reference files, though the self-contained layout works well as is.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries repo- or workflow-specific instructions (exact gh JSON fields, cross-link map construction, test-path ownership rules) with zero explanation of concepts Claude already knows. Not 4: there are no padded or over-explained sections to trim; the table in 'Packet admission' and the example output template each earn their tokens. | 5 / 5 |
Actionability | Commands are copy-paste ready — 'gh issue list --repo $REPO --state open --limit 200 --json number,title,labels,...', the locale-audit grep 'gh pr diff <N> | grep -E "['\"](Connect|Follow|...)['\"]"', contributor-audit gh search commands, and exact test-file mappings. Not 4: the guidance covers the common cases concretely; even edge handling (reactionGroups vs reactions field name) is explicit. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (Gather → Packet admission → Score issues → Score PRs → Rank and report) with an explicit validation gate — 'This step is complete when every scanned issue is either evaluable, missing-evidence with a field list, or a named canonical duplicate' — plus hard-fail checks ('Never recommend "merge as-is" for a PR that has not passed the locale/test/scope checks'). Not 4: checkpoints are explicit and enforceable, not merely present with minor gaps. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the skill is self-contained with well-organized sections, which is appropriate placement for a process skill. Not 5: at ~119 lines, material such as the output template and the test-coverage path mapping could plausibly live in a reference file; not 3: nothing is clearly misfiled and the body is easy to navigate. | 4 / 5 |
Total | 19 / 20 Passed |