Content
65%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 detailed, highly concrete Notion design spec with good internal organization, and the do/don't table is genuinely useful. Its main weaknesses are the absence of any validation checkpoint in the three-step protocol and the fact that the canonical example.html the whole workflow depends on is missing from the bundle, leaving the source-of-truth step unexecutable and the required page-link script unspecified.
Suggestions
Ship the referenced example.html (or move its spec fully inline) — the entire Step 1/Step 2 'mirror it 1:1' protocol is unexecutable without it, and include the page-link → notion.so injection <script> contents in the body since they are a required output block.
Add an explicit validation step to the protocol (e.g., 'Step 4: before finishing, verify your output has exactly the 11 sections in order, only the two required callouts, and no blocks not present in example.html').
Deduplicate the avatar, callout-bg, and tag-pill specs between the section descriptions and the do/don't table to trim tokens without losing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense, non-obvious design spec — exact hex tokens, px sizes, section order, real-shaped copy — with almost nothing Claude would already know. It loses a point to duplication: avatar styling ("18px circles with letter + Notion-style soft pastel bg") and callout bg (#F1F1EF) are each specified in both the section specs and the do/don't table, and the token list overlaps the per-section color specs. Not 3 because the padding is minor relative to the volume of load-bearing detail. | 4 / 5 |
Actionability | Mostly executable: exact color hexes, type stack, px dimensions, ordered section list with literal copy strings, database columns ("Name | Status | Updated by | Updated"), and a paired do/don't table. Two gaps hold it below 5: the declared canonical source "shipped example.html" is not present in the skill folder, and the required trailing "<script> block at the end (page-link → notion.so injection)" is mandated by reference only, with its contents never provided. | 4 / 5 |
Workflow Clarity | A clear three-step protocol exists (read example.html → mirror its structure 1:1 → refresh mock values without inventing blocks), with an identity guard for person names. But there is no validation checkpoint — no step instructing the model to compare its output against the example section-by-section or verify the do/don't constraints before finishing. The sequence is present while checkpoints are missing, matching anchor 3; not 4 because the sole verification mechanism is an unenforced imperative ("reproduce it, not reinterpret it"). | 3 / 5 |
Progressive Disclosure | The body itself is well organized into clearly headed sections (protocol, policy, tokens, section order, formatting rules, do/don't table). However, the entire skill hinges on one bundle file — example.html — which does not exist in the folder (no references/, scripts/, or assets/ directories, and no example.html anywhere in the skill directory), so the single reference is broken and the preview entry index.html from frontmatter is likewise absent. Well-structured content with a broken primary reference lands between anchors 2 and 4; not 4 because the load-bearing reference cannot be resolved. | 3 / 5 |
Total | 14 / 20 Passed |