Content
100%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: dense, repo-specific, and fully executable, with a numbered workflow that includes explicit validation, a re-run feedback loop, and the exception path for when a note should be kept. Content is appropriately placed for a single-file skill with clearly signaled one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense with operational facts only — no explanations of concepts Claude already knows, and even context sentences carry triage value ("They never change the evidence verdict, but a note marked *Worth fixing* is a defect a careful designer would send back"). The brief "no longer / older PRs" clauses are current-state facts rather than date-conditional branching, so they don't warrant the time-sensitivity penalty. | 5 / 5 |
Actionability | Fully executable throughout: a copy-paste-ready gh-api check() function, the exact reproduce command ("pnpm evals:e2e <slug> --local && pnpm --dir evals design:review -- --test-run latest --json"), and environment prerequisites ("judged notes need OPENAI_API_KEY or ANTHROPIC_API_KEY"). Placeholders like <pr> are standard parameterization, not pseudocode. | 5 / 5 |
Workflow Clarity | The five-step "Reproduce, fix, verify" sequence has explicit validation with a feedback loop ("Re-run the same command. The note must be gone and no new *Worth fixing* note may appear") plus a human-judgment checkpoint ("Look at the screenshot yourself"), and step 5 states the CI-verified end state. Not a destructive/batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | A single-purpose skill with no bundle files, organized into four clear sections (read the notes, reproduce/fix/verify, the exception path, rules). References to evals/design-review/rubric.md and DESIGN.md are one level deep and clearly signaled, and nothing inlined warrants its own file. | 5 / 5 |
Total | 20 / 20 Passed |