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.
An exceptionally actionable, well-sequenced operational guide: every command is executable, every failure mode has an explicit handling path, and validation precedes the risky crawl step. The only weaknesses are mild redundancy of security rules across sections and a dense defaults paragraph that could be split into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, purely operational Shopify-specific knowledge (exit codes, signature form validation, precedence rules, expiry behavior) with no explanation of concepts Claude already knows. Not 5 because safety-critical points repeat across sections — the signature-bound-to-one-host rule appears in Hard limits, Step 1, and Security, and robots.txt and git-ignore handling each appear twice — which is trimmable redundancy. | 4 / 5 |
Actionability | Copy-paste ready commands ('"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run shopify_env.py precheck <url>', 'run shopify_crawl.py <url> --out ./crawl'), a complete exit-code decision tree keyed to exact JSON fields ('aborted': 'rate_limited', 'truncated': true, discovery_capped), and every flag enumerated (--resume, --include/--exclude, --sample-per-template, --no-signature, --ignore-robots) cover the common cases. | 5 / 5 |
Workflow Clarity | A clear four-step sequence with validation up front (the precheck validates signature form: web-bot-auth tag, @authority, key id, expiry) and explicit feedback loops for each failure mode — fix the pattern on exit 2, --resume after an aborted crawl, re-run the precheck against the apex/www host. Batch-crawl validation checkpoints are present, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned (Hard limits, Routing, Steps 1-4, Setup, Security) and defers appropriately: setup detail goes to SHOPIFY-SETUP.md and steps 4+ to the parent seo-audit skill, both clearly signaled and one level deep. Not 5 because no bundle reference files exist and the dense Defaults paragraph (concurrency, delay, cap precedence) is inline detail that could live in a reference file. | 4 / 5 |
Total | 18 / 20 Passed |