Content
100%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 skill body is an exemplar of lean, operational instruction: exact MCP tool invocations with parameters, runnable lint/audit commands, explicit validation gates with feedback loops, and tight delegation of detail to well-signaled one-level-deep references. No dimension shows material weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense imperative bullets with zero padding and no explanation of concepts Claude already knows — e.g., 'Never overwrite originals. Fix through `generate_variants` (`creativeRange: REFINE`, `variantCount: 1`)' and 'Generation takes minutes. On timeout do not retry; poll `get_screen` every 30 s, max 10.' Every token is operational, matching the lean level-5 anchor. | 5 / 5 |
Actionability | Guidance is fully executable: exact tool names and parameters (`generate_variants` with `creativeRange: REFINE`, `variantCount: 1`), runnable commands (`npx @google/design.md lint DESIGN.md`, `node scripts/audit_html.js <dir>`), a concrete endpoint and header, and precise thresholds (longest edge <=1600 px, poll every 30 s, max 10, max 2 edit passes). This is copy-paste-ready instruction for the common cases rather than the pseudocode of level 3 or the minor gaps of level 4. | 5 / 5 |
Workflow Clarity | Sections sequence the process (Preflight -> Read -> Write Safely -> DESIGN.md -> Prompting) with explicit validation checkpoints and feedback loops: lint 'must report 0 errors and 0 warnings before upload', 're-audit after each pass', screenshots confirm visual judgement, and rejected images trigger ID/metadata recovery before any retry. Destructive operations (delete_project, apply_design_system to originals) are gated on explicit approval, matching the level-5 anchor including error-recovery loops. | 5 / 5 |
Progressive Disclosure | The 42-line body is a lean overview with clearly signaled, one-level-deep references — [Stitch MCP](references/stitch-mcp.md) (with verified anchors #bounded-image-review and #omp-image-recovery), [DESIGN.md](references/design-md.md), and [Prompting](references/prompting.md) — and supporting scripts in scripts/. The bundle structure matches the referenced paths, and navigation is easy, matching the level-5 anchor. | 5 / 5 |
Total | 20 / 20 Passed |