Content
61%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 body is well-structured and concise with concrete tool names and parameters, but it lacks executable code and — critically for a skill with bulk-create and create operations — omits validation/verification checkpoints on those workflows, capping both actionability and workflow_clarity at 3.
Suggestions
Add validation/verification steps to batch and create workflows (e.g., after SHOPIFY_BULK_CREATE_PRODUCTS, verify the created count/products and surface a retry-on-error loop) to lift workflow_clarity above the batch cap of 3.
Replace the pseudocode GraphQL block with an actual example call including a concrete query string and the expected response shape so guidance is executable rather than descriptive.
Remove the tautological 'When to Use: This skill is applicable to execute the workflow or actions described in the overview' line and drop redundant [Optional]/[Required] tags to tighten conciseness toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — tool sequences, key params, pitfalls, and a quick-reference table — and assumes Claude's competence without explaining Shopify concepts; minor trimmable filler like the tautological 'When to Use' line and redundant [Optional]/[Required] tags keep it at 4 rather than 5. | 4 / 5 |
Actionability | Concrete tool slugs and parameter names are given throughout, but there is no executable code or copy-paste-ready invocation; the GraphQL example is pseudocode-style ('Call SHOPIFY_GRAPH_QL_QUERY with custom query'), matching the 'some concrete guidance but incomplete; pseudocode instead of executable code' anchor. | 3 / 5 |
Workflow Clarity | Setup has a clear numbered sequence with a verification checkpoint ('Confirm connection status shows ACTIVE'), but the batch workflows (SHOPIFY_BULK_CREATE_PRODUCTS, SHOPIFY_BULK_QUERY_OPERATION) and create operations lack validation/verification steps, so the destructive/batch cap of 3 applies. | 3 / 5 |
Progressive Disclosure | Single self-contained SKILL.md with well-organized sections (Prerequisites, Setup, per-domain Core Workflows, Common Patterns, Known Pitfalls, Quick Reference) and no external references needed; the ~165-line length exceeds the simple-skill exception, so it sits at 'good structure; minor organization gaps' rather than 5. | 4 / 5 |
Total | 14 / 20 Passed |