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 tight, well-structured instruction-only skill: a coherent pre-authoring decision sequence, strong rules, and a clean one-level reference to a real bundle file. The only meaningful gap is the absence of explicit validation/feedback checkpoints and any example of the `source_ref` or `summary` artifact formats.
Suggestions
Add a validation step to the decision sequence, e.g. 'Before authoring, verify every metric, quotation, and chart value has a `source_ref` in the manifest; add missing ones or drop the claim.'
Include a one-line example of a `source_ref` and a `summary.design_context` record so the recorded artifacts are unambiguous to produce.
Briefly state what `summary` is (where it lives, its role for the downstream authoring skill) since it is currently referenced without definition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive with zero padding — every step and rule earns its place (e.g. 'Translate design signals into explicit fills, typography, spacing, and bboxes; do not rely on an automatic layout engine'), assuming Claude's competence throughout. | 5 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: named frameworks (`mckinsey`, `scqa`, `pyramid`, `mece`...), a real file path (`references/design-profiles.md`), and specific fields to record. Not a 5 because the `source_ref` and `summary` formats are referenced but never exemplified, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear five-step 'Decision sequence' properly ordered before slide authoring, with step 5 acting as a pre-authoring checkpoint ('Record the framework, assumptions, source manifest... before authoring slides'). Not a 5 because no explicit validation or feedback loop is stated (e.g. verifying every metric has a `source_ref`). | 4 / 5 |
Progressive Disclosure | Well-organized sections under 50 lines, with one clearly-signaled, one-level-deep reference (`references/design-profiles.md`) that exists in the bundle and is linked both inline in step 4 and in a dedicated closing line. Scored against the actual bundle structure. | 5 / 5 |
Total | 18 / 20 Passed |