Content
85%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 well-crafted, compact instruction skill: dense voice rules in a scannable table, a concrete formula, and realistic examples that model the exact tone being taught. The only improvements are trimming the trigger list that duplicates the description and adding one non-PR example to cover the declared Slack/Discord use cases.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no re-taught concepts and every rule earns its place ('Start with the actionable point', 'No em dashes'), but the 'When to Use' bullet list re-states trigger contexts already given in the description, a minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Concrete, copy-paste-ready guidance throughout: a comment formula template, three full example comments, and an executable 'gh pr view' command. Minor gap: Slack/Discord/async updates are declared use cases but have no example, unlike the PR-focused cases. | 4 / 5 |
Workflow Clarity | This is a simple single-task skill and the single action is unambiguous: apply the voice rules, follow the three-part comment formula, and mirror the examples. No destructive or batch operations exist that would require validation checkpoints. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; all content (voice rules, formula, examples, one command) belongs in SKILL.md, and the clean section headers ('When to Use', 'Voice Rules', 'Comment Formula', 'Examples', 'Commands') make navigation trivial. | 5 / 5 |
Total | 18 / 20 Passed |