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.
A sophisticated, well-engineered skill body: a gated multi-phase workflow with explicit validation, concrete and executable tooling guidance, and clean one-level-deep reference split. Its only weakness is length — a few expository framing passages could be trimmed without losing the methodology.
Suggestions
Tighten the rhetorical framing lines (e.g. the lab-notebook analogy, 'a disagreement about the prototype is a disagreement about the system') into terse procedural statements to lift conciseness toward the lean anchor.
Consider moving the Hard Rules scan-before-you-ship checklist into a reference file, keeping only the gate cross-references inline, to reduce body length while preserving the shipping gate.
A couple of the per-row LSP/fallback table rows repeat guidance already implied by the gates; collapse the most redundant rows to trim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence — it never explains basics — but at ~230 lines it carries a few rhetorical framing passages ('Treat it the way you would a lab notebook') that, while load-bearing, could be tightened, so it sits just below the lean anchor. | 4 / 5 |
Actionability | Highly executable: concrete tool invocations (ToolSearch select:LSP, mcp__claude-in-chrome__navigate), curl/grep commands, a copy-paste spike-report template, a harvest-table format, and a 9-item verification checklist cover the common cases. | 5 / 5 |
Workflow Clarity | Phases are explicitly sequenced (0 ANCHOR → 5 CLOSE), each with a named gate (G0–G5) acting as validation checkpoints, plus feedback loops (re-validate, re-grep, delete dead CSS) and a checklist; the destructive secret/PII grep has validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is an overview that pushes detail to seven well-signaled one-level-deep references (all real files in ./references/), each with a one-line description in the References section, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |