Content
88%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 strong, highly actionable skill body with concrete tool calls, exact dimensions, and validation-gated batch workflows. Its weaknesses are moderate: systematic repetition of fallback and egress instructions across steps, and a monolithic single-file layout where reference material could be split out.
Suggestions
Define the no-widget fallback pattern once (e.g., in the Tool Reference or a dedicated Surface Adaptation section) and reference it from each step instead of repeating the block verbatim five times; the same applies to the 403-expand fallback, which is currently stated in three places.
Consolidate the landscape-source expand guidance (2000px top/bottom, 1500px left/right) into the Step 3 code comments only, removing the duplicated warning bullets in Step 2.
Move the Platform Specs table and VIDEO WORKFLOW into one-level-deep reference files (e.g., references/platform-specs.md, references/video-workflow.md) to reduce SKILL.md to a lean overview, and merge the duplicated egress-upload instructions shared by image and video Step 0.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Operational tables assume Claude's competence with no concept explanations, but the no-widget fallback block is repeated verbatim in five places, the 403-expand fallback appears three times (entitlement table, Step 3, Error Handling), landscape expand pixel guidance is duplicated (Step 2 warnings and Step 3 comments), and egress-upload instructions are repeated across image and video Step 0. Factoring these once would trim meaningful tokens. | 4 / 5 |
Actionability | Fully concrete guidance: exact tool calls with parameters (`image_generative_expand(sourceURI, { top: 960, bottom: 960 })`, `video_resize({ assetId: sourceAssetId, width: W, height: H })`), exact per-platform dimensions and quality values (Snapchat `quality: 2`), file naming convention, and copy-ready user-facing messages. | 5 / 5 |
Workflow Clarity | Clearly sequenced steps with an explicit validation checkpoint for the batch run — a 3-crop test preview with user approval required before generating the full set — plus focus-strategy confirmation invites, exact-match reuse rules for test crops, and a thorough error-handling table with recovery fallbacks (403 → reframe, upload 5xx → picker). | 5 / 5 |
Progressive Disclosure | Well-sectioned single-file skill with clear headers and navigation (Supported Input Types, IMAGE WORKFLOW, VIDEO WORKFLOW, Error Handling) and no nested references, but no bundle files exist — the 15-row Platform Specs table, full video workflow, and error table are inline candidates for one-level-deep reference files that would slim the ~400-line SKILL.md. | 4 / 5 |
Total | 18 / 20 Passed |