Content
93%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.
Excellent instructional content: lean, fully executable commands organized in a clear three-step onboarding flow with explicit verification and failure behavior. The only gap is a missing verification step for the plugin installation itself.
Suggestions
Add a verification step for the AI toolkit plugin installation (e.g. confirm the plugin is listed/available) before proceeding from Step 2 to Step 3, mirroring the existing `shopify version` check for the CLI.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tables and bare commands with no concept explanations; "Silently identify the client from system context… Never guess" assumes Claude's competence and every token earns its place, matching the lean anchor-5 example. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout (`npm install -g @shopify/cli@latest`, `brew tap shopify/shopify && brew install shopify-cli`, per-client plugin install commands), with the `other` client handled explicitly — specific commands cover the common cases. | 5 / 5 |
Workflow Clarity | A clear three-step sequence with an explicit checkpoint ("Verify with `shopify version` before continuing") and defined failure paths ("If install fails, report the exact error and stop"), but there is no retry/feedback loop and plugin-install success is never verified — minor validation gaps keep it at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | A well-sectioned, self-contained overview whose only references are the clearly-signaled, one-level-deep API-specific skills (`shopify-admin`, `shopify-liquid`, `shopify-functions`) with "Do not duplicate their routing logic"; nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 19 / 20 Passed |