Content
86%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 lean, well-organized instruction-only skill body: every rule is actionable, the workflow is sequenced with pre- and post-placement checkpoints, and detailed constraints are correctly deferred to a real, clearly signaled reference file. The only gaps are unstated specifics (manifest format, classification-tag origin) and a missing re-check loop after the final placement check.
Suggestions
Give a concrete example of the source-manifest entry (fields and where the manifest lives) and of the `content` vs `layout_design` classification, since both are referenced without definition or example.
Add an explicit validation feedback loop after step 4, e.g., 'If an asset covers readable text, reposition or omit it and re-check before proceeding.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line instructs ("Use visual assets to support a slide's message, never to flatten or replace editable content"; "never wrap a raster image in SVG and call it editable") with zero padding and no explanation of concepts Claude already knows — every token earns its place. | 5 / 5 |
Actionability | Guidance is concrete and specific ("a final inch bbox, deliberate z-index, and `content` or `layout_design` classification"; "Confirm the local asset path, source, usage rights, and concise alt text"), but minor gaps remain: 'the source manifest' and the classification tags get no example or stated location. As an instruction-only skill this is mostly executable guidance with minor gaps, matching anchor 4. | 4 / 5 |
Workflow Clarity | Four clearly sequenced steps with a pre-placement rights checkpoint (step 2) and a post-placement check (step 4: "check that no asset covers readable text"), plus a failure path in Rules ("omit the asset and report the gap"). Not anchor 5 because there is no explicit fix-and-re-check loop after step 4's check fails; not a destructive/batch operation so no cap applies. | 4 / 5 |
Progressive Disclosure | The body is a lean overview and the only reference, `references/asset-guidance.md`, exists on disk, is one level deep, clearly signaled with its scope ("licensing, placement, and SVG constraints"), and appropriately splits out detailed constraints — matching the well-signaled one-level-deep-references anchor. | 5 / 5 |
Total | 18 / 20 Passed |