Content
92%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 exemplary instruction-only skill body: lean, prioritized, and safe by construction, with explicit validation gates, feedback loops, and anti-pattern guards (untrusted comment data, no workflow edits, no self-merge). The only room for improvement is turning a few described operations into concrete commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~45 lines of dense, non-obvious policy with zero padding: it never explains what a PR or CI is, and every line ('Never force-push', 'do not invent work just because a pass came up empty') adds guidance Claude would not infer. It assumes Claude's competence throughout, matching the 5 anchor; 4 would require identifiable over-explanation, and none stands out. | 5 / 5 |
Actionability | Provides concrete example commands ('gh pr view', 'gh pr checks --watch'), an explicit fix/dismiss/ask decision rubric, a concrete escalation list (security, privacy, auth, billing, data, migration, concurrency), and precise verification rules ('run the narrowest check that proves the fix'). Some operations (fetching/merging base, resolving threads) are described rather than given as commands, leaving minor gaps that keep it at 4 rather than fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | A clear operating loop with strict priority order (conflicts → comments → CI), fresh-state refresh each pass, an explicit validation gate before pushing ('Never push a fix that fails its own checks'), and feedback loops (checks restart on push; previously-green check now failing → prioritize your own change; watch checks to completion). The final gate — 'Report success only after a fresh status read shows the PR mergeable and green' — completes the sequence, matching the 5 anchor; no checkpoints are missing. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for external references; all content fits inline. Sections (Operating loop, blockers 1–3, Git rules, Reporting) are well-organized and easy to navigate, which per the rubric's simple-skill guideline earns a 5 on structure alone. | 5 / 5 |
Total | 19 / 20 Passed |