Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with concrete HTML, specs, and a sequenced workflow, but it is verbose with general design/Instagram knowledge Claude already has, lacks validation checkpoints in the workflow, and leans on a monolithic structure with a dead external reference.
Suggestions
Cut or relocate general-knowledge padding (Instagram "advantages", composition rules, color psychology, typography tips, and the five generic Visual Styles) to tighten conciseness toward the lean level-3 anchor.
Add an explicit validation/recovery step to the HTML workflow (e.g., verify the file was written and confirm mcp__tdx-studio__open_file succeeded, with a retry on failure) to raise workflow clarity.
Create the referenced ../references/html-preview-templates.md (or remove the dead reference) and move the CTA catalog, image specs, and design guidance into reference files so the SKILL.md serves as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Large stretches restate general knowledge Claude already has — Instagram "advantages" ("Visual-first platform", "Mobile-native - 100% mobile usage"), composition rules, color psychology ("Urgency: Red… Luxury: Black, gold"), typography tips, and five generic "Visual Styles" — so it is mostly useful but padded and could be tightened well beyond the lean level-3 anchor. | 2 / 3 |
Actionability | Provides a copy-paste-ready HTML template with documented placeholders, a concrete 6-step workflow naming specific tools (mcp__tdx-studio__open_file, Glob, Write), an exact output table format with examples, and precise specs (1080x1080, instagram-preview-{timestamp}.html). | 3 / 3 |
Workflow Clarity | The HTML generation workflow is clearly sequenced (steps 1-6) with a confirmation gate ("ONLY generate HTML mockups AFTER user confirms"), but it lacks explicit validation/verification steps and error-recovery feedback loops, matching the level-2 anchor of sequence-present-but-checkpoints-implicit. | 2 / 3 |
Progressive Disclosure | It references ../references/html-preview-templates.md, but no references/ directory or bundle file exists — a dead reference — and large reference-like blocks (CTA catalog, visual styles, image specs, design guidance) are inlined in a single ~425-line SKILL.md that should be split out, matching the level-2 anchor of content that should be separate being inline. | 2 / 3 |
Total | 9 / 12 Passed |