Content
82%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 operational skill body: copy-paste-ready commands, clear command-discovery guidance, and well-scoped workflows with explicit constraints. Weak points are minor redundancy in the prohibition lists, a missing fix-and-retry loop for failed config validation, and no offloading of the long store-execution contract to a reference file.
Suggestions
Add an explicit error-recovery step after `shopify app config validate --json` (read the JSON errors, fix the named TOML fields, re-run) to close the validation feedback loop.
Deduplicate the upgrade guidance and the repeated prohibition lists (e.g., merge the description-echo paragraph's 'not validate_graphql_codeblocks' with the Constraints section) to tighten conciseness.
Move the detailed store-execution bullet contract to a references/ file (e.g., STORE-EXECUTION.md) and keep a short summary plus the primary command pair in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance with concrete commands and almost no concept explanation Claude already knows, but there are minor trimmable redundancies — "Upgrade to the latest version: `shopify upgrade`" followed immediately by "If a command is missing or unrecognized, the user may need to upgrade... by running `shopify upgrade`", and several prohibitions repeated across the description-echo paragraph and the Constraints/Store execution constraints lists. That matches 'Efficient; minor instances of over-explanation that could be trimmed' rather than the 5 anchor's every-token-earns-its-place. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: `npm install -g @shopify/cli@latest`, `shopify app config validate --json` (with `--path`/`--config` handling), `shopify store auth --store <store-domain> --scopes <scopes>`, `shopify store execute --store <store-domain> --query '...'`, and a complete env-prefixed attribution example — matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The "Order of operations" section gives a numbered sequence for config validation, and the store execution flow is explicitly sequenced (auth before execute, validate the query, inspect `Required scopes:` output). However, there is no explicit fix-and-retry feedback loop — e.g., what to do when `shopify app config validate --json` reports errors — which keeps it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the 5 anchor's explicit error-recovery loops. | 4 / 5 |
Progressive Disclosure | The body is well-organized with clear section headers (Setup, CLI Usage, analytics attribution, App configuration validation, Store execution contract) and points to the external Shopify CLI docs rather than inlining them. At ~126 lines with no bundle files, some content (e.g., the long store-execution bullet contract) is inlined where a separate reference file could carry it, matching the 4 anchor's 'most content appropriately placed; minor organization gaps' rather than a clean one-level-deep split. | 4 / 5 |
Total | 17 / 20 Passed |