Content
76%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 tight, highly actionable skill body with executable gh commands and a concrete rating rubric; it respects token budget and covers both operating modes clearly. The main gap is the backfill batch path, which labels up to 200 issues with no post-apply verification, capping workflow clarity.
Suggestions
Add a verification step to Mode B after the batch pass, e.g. re-run the `gh issue list` jq filter to confirm no unrated issues remain, or spot-check a sample of applied labels before finishing.
Include a guardrail for Mode B dry-run (list the issues that would be labeled and their proposed ratings before applying), since it applies labels with no owner in the loop.
Tighten the rhetorical passages in 'Why the timing is the whole point' (e.g. the motivated-reasoning sentences) to cut ~10 lines without losing the contamination rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no generic explanations of concepts Claude already knows — and the 'Why the timing' section captures project-specific rationale Claude could not infer. A few rhetorical flourishes ("the number gets talked into agreeing with the spend", "That is motivated reasoning, and it corrupts the one field the whole system rests on") could be trimmed without losing guidance, so it sits at 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place top anchor. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: `gh issue edit 412 --repo xchromo/osn --add-label "complexity:3"`, the dual-label backfill command, a complete `gh issue list --json ... --jq` filter for finding unrated issues, and the exclusion query. The concrete five-row Fibonacci rubric table plus raise/lower signals makes the judgement step executable too; this matches the top anchor. | 5 / 5 |
Workflow Clarity | Both modes have clear numbered sequences and Mode A includes an owner confirmation checkpoint, but Mode B is a batch operation (one pass over up to 200 issues) whose only guard is the jq selection filter — there is no verification step confirming labels applied correctly or a dry-run/review pass, so the batch-operation cap of 3 applies. It is above the anchor of 2 because the sequence is well defined and the input-selection check is explicit. | 3 / 5 |
Progressive Disclosure | Well-organized sections (rationale, rubric, Mode A, Mode B, labels, consumers) with content appropriately kept inline — the rubric table and label semantics are core and belong here. It does not hit the top anchor: at ~105 lines it exceeds the under-50-line simple-skill exception, references no bundle files (none exist), and points to external repo artifacts (`wiki/observability/session-metrics.md`, `@tools/pr-metrics`) without a clearly signaled pointer structure. | 4 / 5 |
Total | 16 / 20 Passed |