Content
52%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 delivers genuinely actionable, format-precise guidance with a well-gated two-phase workflow, but it is bloated with generic design knowledge and internal repetition, and its single progressive-disclosure pointer is a dangling reference to a nonexistent file. Trimming known-knowledge sections and fixing or inlining the templates reference would materially improve it.
Suggestions
Fix the dangling reference: either ship references/html-preview-templates.md in the bundle or inline the essential template and remove the '../references/' pointer.
Cut or move generic design knowledge (color-emotion mappings, typography tips, visual style catalogs, 'Instagram Advantage' bullets) into a reference file or delete it — Claude already knows this material.
Deduplicate the image-gen integration ('Image Integration Note' vs 'Integration with Instagram Image Generation') and the thrice-stated write-and-open-preview requirement into a single authoritative section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Multiple sections restate generic design knowledge Claude already has ('Visual-first platform', 'Urgency: Red, orange, bright yellow', 'Contrast: Text must stand out from background', catalogs of visual styles and composition rules), and the write-file-and-open-preview requirement is stated three times while the image-gen integration is explained twice. Not 1 because substantial skill-specific material (125/40/30 limits, CTA catalog, output format) genuinely earns its tokens; not 3 because the padding is repeated across whole sections rather than isolated. | 2 / 5 |
Actionability | Guidance is largely executable: a fully worked example table, exact character limits with examples, a complete HTML template, explicit tool calls (Glob, Write, mcp__tdx-studio__open_file), and a precise file-naming convention (instagram-preview-YYYYMMDD-HHMMSS.html). Not 5 because the PNG-to-base64 conversion step ('Read PNG as binary and convert to base64 string') gives no concrete command, and the referenced template file does not exist. | 4 / 5 |
Workflow Clarity | The two-phase workflow is clearly sequenced with an explicit user-confirmation gate ('ONLY generate HTML mockups AFTER user confirms') and enumerated do/don't conditions. Not 5 because character-limit validation is hand-waved as 'validated internally but not shown' with no defined check or error-recovery loop; not 3 because the confirmation checkpoint and numbered HTML steps are explicit and the operation is neither destructive nor batch. | 4 / 5 |
Progressive Disclosure | The skill's only external reference, '../references/html-preview-templates.md' (cited twice), does not exist — the bundle contains no references directory — so the promised detail layer is inaccessible. Additionally, ~400 lines of CTA catalogs, color/typography guidance, and visual-style guides that clearly belong in reference files are inlined in SKILL.md. Not 3 because the primary disclosure mechanism is broken rather than merely under-signaled, and the body is near-monolithic despite good section headers. | 2 / 5 |
Total | 12 / 20 Passed |