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.
The body is an exemplary instruction-only skill: lean and information-dense, with copy-paste gh commands for every common action, a clearly sequenced procedure with validation checkpoints and error-recovery guidance, and well-signaled repo references. The only minor tension is that all policy lives in one moderately long file with no offloading to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, repo-specific policy throughout (e.g., 'Behavior that only appears by mutating construction-time state or relying on internals is a property of the code, not a defect') with no explanation of concepts Claude already knows and no padding. Not 4: no over-explanatory passages were found that could be trimmed. | 5 / 5 |
Actionability | Every operational step has copy-paste-ready gh commands with explicit --json field lists (e.g., 'gh issue edit N --repo PrefectHQ/fastmcp --add-assignee <login>' and 'gh issue comment ... --body-file /tmp/triage-reply.md'), covering orient, contributor checks, assign, and decline. Not 4: the common cases are all fully executable; only 'record the accepted approach' is softly specified. | 5 / 5 |
Workflow Clarity | A clearly sequenced 7-step procedure with validation checkpoints ('check that the tests fail without the fix'), an explicit error-recovery loop ('If that run fails, the gate misbehaved: investigate the run rather than re-assigning'), a final 'Check before finishing' checklist, and authorization gates on the outward-facing decline action. Not 4: checkpoints and feedback loops are present, so no cap applies. | 5 / 5 |
Progressive Disclosure | Well-organized sections with clearly signaled one-level-deep references (require-issue-link.yml, the contribution policy, the sibling review-pr skill) and no bundle files to split. Not 5: the ~72-line body exceeds the under-50-line simple-skill exception, so it is a well-structured single-file procedure with minor organization tension rather than content appropriately split across files. | 4 / 5 |
Total | 19 / 20 Passed |