Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable catalog of Shopify operations via Rube MCP with clear tool names and workflow groupings. However, it lacks executable examples (no actual tool invocations with sample parameters), includes some redundant content (quick reference table duplicates workflow sections), and misses validation checkpoints for destructive/batch operations. The content would benefit from being more concise while adding concrete, copy-paste-ready examples.
Suggestions
Add concrete, executable examples showing actual tool invocations with realistic parameters (e.g., a complete SHOPIFY_BULK_CREATE_PRODUCTS call with sample product data)
Add validation/verification steps after batch or mutating operations (e.g., after bulk product creation, verify with SHOPIFY_GET_PRODUCTS_COUNT or spot-check a created product)
Remove the quick reference table or the detailed workflow sections—having both is redundant; keep the table and make workflows more example-driven
Remove generic knowledge sections like API versioning and rate limits, or condense them to single-line warnings within relevant workflows
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary content. The 'Known Pitfalls' section about API versioning and rate limits is generic knowledge Claude likely already knows. The quick reference table largely duplicates information already presented in the workflow sections. Some parameter listings are padding rather than adding value. | 2 / 3 |
Actionability | The skill provides tool names and parameter lists, which is somewhat concrete, but lacks executable examples. There are no actual code snippets showing how to call these tools with real parameters, no example payloads for bulk product creation, and the GraphQL section is essentially pseudocode. The instruction to 'always call RUBE_SEARCH_TOOLS first' is good but the skill doesn't show what that call looks like. | 2 / 3 |
Workflow Clarity | Steps are listed with clear sequences and the setup flow includes a validation checkpoint (confirm ACTIVE status). However, the core workflows mark most steps as [Optional] without clear decision logic for when to use each, and there are no validation/verification steps after performing operations like bulk product creation or inventory changes—operations that could benefit from confirmation steps. | 2 / 3 |
Progressive Disclosure | The content is reasonably structured with clear section headers and a quick reference table, but it's a long monolithic file with no bundle files to offload detailed content. The workflow details, parameter lists, and the full reference table could be split into separate files. The external link to Composio docs is helpful but the skill itself could benefit from better content distribution. | 2 / 3 |
Total | 8 / 12 Passed |