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.
This is a strong, high-signal skill body: it leads with precise, environment-specific gotchas and error signatures, provides executable inspection code, and sequences deck-building through a validated two-phase workflow with feedback loops. Its weaknesses are moderate verbosity in the advisory prose sections and a couple of topics that belong in reference files rather than the main body.
Suggestions
Tighten the speaker-notes prose (the 'what good notes look like' and 'what to avoid' subsections) into compact bullet rules — the whispering-colleague framing and full-script caveat can each be one line.
Consider moving the detailed speaker-notes and sections guidance into a reference file (e.g. slide-notes.md), keeping SKILL.md to the decision rules (when to write notes, formatting limits) with a link.
Verify the cross-skill link ../figma-use/SKILL.md resolves in deployment environments — it is the only reference outside this bundle's references/ directory and reads as a broken link if that sibling skill is absent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious knowledge (the (−240, −240) appendChild offset bug, opaque SLIDE_GRID/SLIDE_ROW nodes, createPage throwing in Slides) and explains nothing Claude already knows, but the speaker-notes and design-thinking sections carry prose-heavy passages ("feel like a trusted colleague leaning over and whispering", multi-paragraph design philosophy) that could be tightened — 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor trims of level 4. | 3 / 5 |
Actionability | Copy-paste-ready inspection scripts (the grid listing and the findAllWithCriteria + font-loading text extraction), exact error-message strings ('no such property createPage'), precise batch sizing (3–5 slides per call), and anchored links to the helper preamble and deterministic validation script — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The two-phase plan→build workflow is clearly sequenced with explicit validation checkpoints for every batch (deterministic overlap/clip/bounds script, screenshot at first and final batches) and an explicit error-recovery loop ('If it fails, screenshot the affected slides and fix before continuing'); inspect-before-create and never-delete-unless-asked guardrails cover the destructive cases, so no cap applies. | 5 / 5 |
Progressive Disclosure | All six referenced files (slide-gotchas, slide-lifecycle, slide-grid, slide-content, slide-properties, slide-design) exist, are exactly one level deep, and are cataloged with per-file descriptions in the 'Reference Docs' section; the deduction is that sizable bodies of guidance (speaker notes, sections) sit inline in SKILL.md where the pattern elsewhere pushes detail into references. | 4 / 5 |
Total | 17 / 20 Passed |