Content
82%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 disciplined, well-structured policy skill: concrete patterns, remedies, and a literal decision procedure make it highly actionable, with external detail correctly delegated to sibling skills. The only slack is mild rhetorical restatement and a recap section that duplicate earlier material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's intelligence — no explanations of what a PR, secret, or screenshot is — and stays imperative with high signal density. It is not 5 because "The short version" section and some rhetorical restatement ("There is no internal channel; everything is the channel") could be trimmed; it is not 3 because there is no genuinely unnecessary explanation, only minor duplication. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully actionable: concrete patterns to catch ("// TODO(me):", "~/scratch/...", "tmp.ts", "notes.md"), concrete remedies (".env.local (gitignored)", "draft: true", "split or rebase"), a literal per-file decision procedure ("Helps → keep / Recoverable question → fix / Unrecoverable question → drop"), and enumerated common removals. Specific examples cover the common cases, matching the top anchor; the 4 anchor's 'minor gaps' does not apply. | 5 / 5 |
Workflow Clarity | The sequence is clear and ordered (security review runs first, the cleaning pass is "Final pass before opening the PR"), and the cleaning pass embeds an explicit per-file checkpoint ("If a stranger reads this file with no context, does it help them..."). It is not 5 because the overall flow is conveyed through section order rather than an explicit end-to-end sequence, leaving minor validation gaps; it is not 3 because the checkpoints (stranger question, security-first ordering, PR/commit message requirements) are explicit, and the destructive "drop" guidance is paired with its validation loop. | 4 / 5 |
Progressive Disclosure | The file is well-organized into domain sections, and external material is delegated to one-level-deep, clearly signaled references ("[`links`](../links/SKILL.md)", "[`security`](../security/SKILL.md)", "[docs/AGENTS.md](../../../docs/AGENTS.md)") with a closing "See also" index. It is not 5 because there is no actual content split — everything lives in the single SKILL.md body — whereas the top anchor describes an overview with appropriately split content across files. | 4 / 5 |
Total | 17 / 20 Passed |