Content
71%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 content is a tight, concrete design spec with a well-sequenced reproduction protocol and strong do/don't constraints. Its main weaknesses are the duplicated color values, the missing final validation step, and — most materially — that the canonical example.html the entire protocol depends on is not shipped in the bundle, leaving the source-of-truth instruction unverifiable.
Suggestions
Ship example.html in the skill bundle (or, if it cannot be shipped, inline the canonical DOM structure into SKILL.md) so step 1 of the source-of-truth protocol — 'Open and read the shipped example.html' — can actually be executed.
Remove the duplicated color values: the attention-block (#fff8c5/#d4a72c) and CI-fail (#cf222e/#ffebe9) hexes appear both in the Canvas tokens section and again in the Implementation constraints table — cite the token names in the table instead.
Add a short final self-check step to the protocol (e.g. 'Before finishing, diff your output against example.html: same nav items, same rail items, same group order and row counts, no additions') to close the workflow's validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and purposeful — exact hex tokens, pixel dimensions, structural specs, and a paired do/don't table, with no explanations of concepts Claude already knows. Minor over-explanation exists: the attention-block and CI-fail color values are stated in full in the token list and then repeated verbatim in the do/don't table, and the design-system policy repeats the 'ignore it' instruction three ways. Fits 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | Highly concrete instruction-only guidance — exact canvas tokens ("page bg: #f6f8fa", "nav bar: #24292f"), a type stack, section-by-section layout specs with counts and ordering, and prescriptive do/don't pairs ("Use nexu-io/open-design", "commit subjects under 72 chars"). It falls short of fully executable because the protocol's step 1 ("Open and read the shipped example.html") depends on a file that is not present in the bundle, so the canonical reference cannot actually be read; the inline spec partially compensates. | 4 / 5 |
Workflow Clarity | A clear three-step sequence (read example.html → mirror structure 1:1 → refresh mock values without inventing UI) with explicit guardrails ("If something is not already present in example.html, it does not belong in your output") and an identity guard. This is a generation task, not a destructive/batch operation, so the validation cap does not apply; the gap keeping it below 5 is the absence of any final self-check against the example before finishing. | 4 / 5 |
Progressive Disclosure | Section structure is good (protocol → policy → tokens → sections → rules → constraints), but the body's single and most important bundle reference — "Open and read the shipped example.html in this folder" — points to a file that does not exist in the bundle (no example.html, no references/, scripts/, or assets/). Per the guideline to score against the actual bundle structure, the one-level-deep reference is clearly signaled but dangling, so navigation breaks exactly where the skill routes all fidelity decisions. | 3 / 5 |
Total | 15 / 20 Passed |