Content
57%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 detailed, actionable body for a complex six-mode/three-tier renderer, with strong concrete code blocks and per-mode variable specs. It is held back by repeated restatements of the same invariant, missing validation checkpoints in the render workflow, and a broken design-tokens.md reference alongside an orphaned craft-fundamentals.md file.
Suggestions
Fix the broken reference: either add references/design-tokens.md (holding the full contrast verification and print tokens) or remove the two links to it and inline only what exists.
Link references/craft-fundamentals.md from the body (or remove it from the bundle) so every bundled file is discoverable from SKILL.md.
Add an explicit validation checkpoint after rendering — e.g., verify output size against the ≤50KB/≤120KB budget and confirm the .md twin carries no tier enrichment — with a fix-and-retry loop if the check fails.
Consolidate the markdown-twin-lean / asymmetry invariant into one authoritative statement and reference it from the other sections instead of restating it four to five times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the markdown-twin-lean / asymmetry invariant is restated four to five times across Purpose, the dedicated asymmetry section, the Audience Tiers table, and Non-goals, which could be tightened without losing the rule. | 3 / 5 |
Actionability | Concrete, copy-paste-ready material abounds — the mermaid-CDN module script with real URLs and themeVariables, the cross-platform bash opener, the :root design-token CSS, and per-mode template variable lists — with only a minor gap in that usage examples are natural-language prompts rather than a single end-to-end render invocation. | 4 / 5 |
Workflow Clarity | The sequence is clear (resolve tier → select mode → fill template → write .html and .md twin → summarize and auto-open) and tier-resolution precedence is explicit, but there are no explicit validation checkpoints such as verifying the size budget (≤50KB/≤120KB) or confirming the twin omits tier enrichment. | 3 / 5 |
Progressive Disclosure | Structure is good — an overview with one-level-deep references to templates and fonts and a dedicated References section — but references/design-tokens.md is referenced in two places yet absent from the bundle, and references/craft-fundamentals.md exists but is never linked, so navigation is not clean. | 3 / 5 |
Total | 13 / 20 Passed |