Content
81%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 highly actionable, well-sequenced skill body: concrete palettes, commands, templates, decision tables, and a real validation checklist with a regeneration loop. The main costs are repetition (forbidden lists and Mermaid rules restated across sections), four dangling ./templates/*.html references that don't exist in the bundle, and inline bulk (slide-deck mode, anti-patterns) that belongs in the reference files.
Suggestions
Deduplicate: state the forbidden fonts/colors/animations and the ASCII-table proactive rule once (e.g. keep them only in the Anti-Patterns section) and reference that section elsewhere instead of restating them 2-3 times.
Fix or remove the four broken ./templates/*.html references (architecture.html, mermaid-flowchart.html, data-table.html, slide-deck.html) — they point at files not present in the bundle, so 'read the reference template' steps will fail.
Move the Slide Deck Mode details (slide types, presets, compositional rules) into ./references/slide-patterns.md, which the body already instructs reading, to slim the main file toward a navigable overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly non-obvious, genuinely useful guidance (exact palettes, font pairings, the stateDiagram-v2 parser caveat, the .node CSS collision constraint) rather than explanations of things Claude already knows, but it is noticeably repetitive: the forbidden font/color lists appear nearly verbatim in both "3. Style" and "Anti-Patterns", the ASCII-table proactive rule appears three times (intro, "Prose patterns" area, Data Tables), and Mermaid TD-vs-LR and zoom-control guidance are each repeated across multiple sections. This lands on anchor 3 ("Mostly efficient but... could be tightened") — above anchor 2's padded explanations, below anchor 4's minor trimmings. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact hex palettes ("Terracotta + sage (#c2410c, #65a30d)"), named font pairings, a rendering-approach decision table keyed by content type, executable shell commands ("open ~/.agent/diagrams/filename.html", "xdg-open", "which surf", base64 encoding with macOS/Linux variants), a complete HTML file skeleton, and CSS theming snippets. This matches anchor 5 ("Fully executable; copy-paste ready code or commands; specific examples cover the common cases") and clearly exceeds anchor 4's "minor gaps". | 5 / 5 |
Workflow Clarity | The four-step workflow (Think → Structure → Style → Deliver) is clearly sequenced, includes mandatory pre-generation checkpoints ("Read the reference material before generating" with per-content-type file routing), and ends with an explicit pre-delivery validation checklist ("Before delivering, verify: ... Both themes ... No overflow ... File opens cleanly: No console errors") plus a regeneration feedback loop ("If two or more of these are present, the page is slop. Regenerate with a different aesthetic direction"). This matches anchor 5's explicit validation steps, feedback loops, and checklists for complex processes; operations here are not destructive/batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | Structure is good: all four references/*.md files exist, are one level deep, and are clearly signaled with routing rules ("For pages with 4+ sections, also read ./references/responsive-nav.md"; slide mode gated on explicit opt-in with its own reference). However, the body repeatedly points to ./templates/architecture.html, ./templates/mermaid-flowchart.html, ./templates/data-table.html, and ./templates/slide-deck.html — none of which exist in the bundle — and ~400 lines of slide-deck and anti-pattern detail are inlined that could live in the existing reference files. This fits anchor 4 ("Good structure; most content is appropriately placed; references mostly clear; minor organization gaps") rather than anchor 5's clean navigable split, and is well above anchor 3's buried references. | 4 / 5 |
Total | 17 / 20 Passed |