Content
67%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.
The body is a well-structured operating contract with genuinely concrete tool-call syntax, explicit validation/recheck loops, and verified one-level-deep references. Its main weakness is conciseness: long multi-clause sentences and repeated directives across sections force re-reading, and some sequencing lives in prose rather than the numbered workflow.
Suggestions
Consolidate the preview/verification prohibitions (temporary servers, ad hoc screenshots, per-slide captures) into one place — they currently appear in both the opening paragraph and step 7.
Break the longest sentences (e.g., step 3's planning paragraph and the media-boundaries paragraph) into short imperative bullets; each currently stacks 4-6 clauses.
Move some environment-specific policy detail (custom template scope, media/mode boundaries) into the existing reference files and keep SKILL.md to the workflow plus pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense policy prose with no padding of concepts Claude already knows, but it repeats itself: the temporary-server/screenshot prohibitions appear in both the opening paragraph and step 7, and preview/verification rules recur across the intro, workflow, and completion sections. Many single sentences carry 5+ nested clauses that could be tightened or split. | 3 / 5 |
Actionability | Concrete tool calls with exact parameter syntax ("call `media/artifact_media_review` phase=plan", "`media/artifact_preview_review` once with `kind=\"slides\"`") and named paths (`design/<session-id>/`, `design-tokens.css`, `brief.json`, `core-v1-index.md`) make most guidance executable, though a sizable share remains abstract policy language ("preserve the template's distinctive visual system"). | 4 / 5 |
Workflow Clarity | A 7-step numbered workflow with explicit validation checkpoints (batched preview check, collect defects, one consolidated repair, one targeted recheck, shared-style batch recheck) and honest failure handling ("Missing client access means visual verification is incomplete, not passed") satisfies the batch-operation validation requirement. It stays below 5 because some ordering is implicit — the pre-authoring media call and reference reading live in prose sections rather than the numbered sequence. | 4 / 5 |
Progressive Disclosure | Three one-level-deep references (shared-guidelines.md, slides-ppt.md, layout.md), all present in the bundle, are clearly signaled in a dedicated "Required references" section with reading order and handling rules. Minor gaps: dense monolithic policy sections that could live in a reference file, and mixed mention of session-side files (`core-v1-slides/` catalogs) that are not part of the bundle. | 4 / 5 |
Total | 15 / 20 Passed |