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.
A highly actionable, well-sequenced workflow with strong validation checkpoints and concrete tool usage. The main weakness is conciseness: several constraints are repeated across steps and recapitulated in a closing section.
Suggestions
Consolidate the repeated "never pass aspectRatio/size with referenceImage" and "always pass designAssetUrl as referenceImage" rules into the Call Rules section and reference it once from each step instead of restating.
Trim or remove the "Important Constraints" section where it only recapitulates rules already stated inline, keeping only constraints not already covered.
Consider extracting the brand-vibe and product-suggestion reference tables into a references file to reduce SKILL.md length and improve progressive_disclosure toward a one-level-deep structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly actionable with no concept padding, but the "never combine referenceImage with aspectRatio/size" rule is restated in 5+ places and "Important Constraints" recapitulates earlier rules, which is more than minor trimming — fitting anchor 3 over 4. | 3 / 5 |
Actionability | Provides copy-paste-ready code blocks for every tool, a detailed prompt-structure template, a mockup manifest, and an error table with specific HTTP status codes and retry rules, fully covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 0–7 are clearly sequenced with explicit validation checkpoints (pilot approval gate, Step 3 review) and feedback loops for batch recovery (rate-limit backoff, partial-201 re-send, no silent skips); the batch cap does not apply because validation is present. | 5 / 5 |
Progressive Disclosure | Well-organized sections, tables, and a single internal anchor with no nested references, but the skill is a >50-line monolith with no separate reference files, so it fits anchor 4 rather than the reference-split anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |