Content
85%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 well-structured, tight instructional skill: concrete numeric rules and layout grammar in the body, a clear preflight-to-self-check workflow with a validation checklist, and details correctly deferred to one-level-deep reference files. The only soft spots are a little aesthetic prose in the intro and the absence of a worked example in the body.
Suggestions
Add a minimal annotated 1200x1200 HTML skeleton (or a link to a concrete example in references/catalog.md) so the layout grammar and px floors can be applied copy-paste rather than translated from prose.
Tighten the opening paragraphs: the sentences about the card feeling 'complete as a single shareable visual' restate the center-of-gravity and margin rules covered later in Canvas Grammar.
Consider naming one or two additional natural trigger synonyms (e.g. 'square slide') in the description to widen trigger-term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and parameter-dense ('at least 24px (Tailwind text-2xl or text-[24px])', 'outer padding: commonly 64-112px per axis') with little padding, but the opening prose about a card feeling 'complete as a single shareable visual, not like a cropped presentation page' could be tightened slightly. | 4 / 5 |
Actionability | Guidance is highly concrete for an instruction-only skill — specific px floors, Tailwind class mappings, the '@ppt-chart-height=N' marker convention, a pattern lookup table, and a numbered budget calculation — but no worked card skeleton or example is shown inline, leaving minor gaps versus fully executable coverage. | 4 / 5 |
Workflow Clarity | The flow is clearly sequenced (Preflight decisions, Square Budget calculation, Canvas Grammar, Repair And Self-check) with explicit validation ('Before delivery, run references/checklist.md') and symptom-to-fix feedback loops ('If a table or timeline feels cramped, convert it into a 2x2, ranked list, stacked pair, or compact evidence band'), matching the top anchor. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview with two well-signaled, purpose-described references (references/catalog.md and references/checklist.md); both files exist, are one level deep, and contain no nested references, so navigation is easy and content is appropriately split. | 5 / 5 |
Total | 18 / 20 Passed |