Content
72%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 content is exceptionally actionable and information-dense, packed with specific thresholds, schemas, and worked examples rather than generic explanation. Its weaknesses are the missing validation/feedback loops for batch feed operations (capping workflow clarity at 3) and the absence of progressive disclosure — all reference tables live inline in one long file, plus a promotional footer that wastes tokens.
Suggestions
Add validation checkpoints and feedback loops to the batch workflows: after applying supplemental feed overrides, verify values took effect (re-export or spot-check products in Merchant Center) and specify a retry path if items remain disapproved after 72 hours.
Move the reference tables (GTIN/MPN requirements matrix, attribute requirements, Shopping vs PMax comparison, image best practices, pricing signals) into a references/ file (e.g., references/feed-requirements.md) and link to it from SKILL.md, keeping the body a lean overview with workflows and examples.
Remove the promotional "About this skill" footer and the intro paragraph that repeats the frontmatter description to reclaim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational specifics ("custom_label_0: hero → Top 20% products by revenue", "Minimum 100x100 px (recommend 800x800+)") that earn their tokens, but the promotional "About this skill" footer and the intro paragraph repeating the frontmatter description are trimmable padding. Not a 5 because of that padding; not a 3 because nearly all reference content is domain data Claude does not already know. | 4 / 5 |
Actionability | Highly concrete instruction-only guidance: a title formula with worked per-category examples ("Nike Air Max 270 Men's Running Shoes - Black/White - Size 10"), exact custom_label_0-4 schemas, menu-path setup steps ("Merchant Center → Feeds → Supplemental feeds → Add") with a sample sheet, and disapproval triage with priorities and timelines. Per the scoring notes, absence of code is not penalized when guidance is this actionable; not a 4 because the examples are copy-paste ready across the common cases. | 5 / 5 |
Workflow Clarity | Workflows have clear numbered sequences (audit: export → check issues → score → prioritize → implement; disapproval: export → categorize → fix → re-review → monitor), but batch operations such as bulk supplemental feed updates and bulk disapproval fixes lack validation checkpoints and feedback loops — no step verifies overrides took effect or defines a retry path if items remain disapproved after 72 hours. Per the batch-operation cap, workflow clarity cannot exceed 3; not a 2 because sequences and prioritization logic are well defined. | 3 / 5 |
Progressive Disclosure | Sections are well organized (Capabilities, Workflows, Reference Data, Examples), but roughly 150 lines of lookup tables (GTIN/MPN matrix, attribute requirements, Shopping vs PMax comparison, image specs, pricing signals) are inlined in a single ~300-line file with no bundle files or references to split them out — matching the anchor "content that should be separate is inline". Not a 4 because there are no references at all; not a 2 because headers make navigation easy. | 3 / 5 |
Total | 15 / 20 Passed |