Content
46%Scale 1-5Reviews 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 tools available through Rube MCP, but suffers from being a reference listing rather than actionable guidance. It lacks concrete examples with realistic parameters, has no validation steps for destructive operations like bulk product creation, and contains redundant content (workflows duplicated in the quick reference table). The skill would benefit significantly from executable examples and splitting into overview + reference files.
Suggestions
Add concrete, executable examples showing actual tool calls with realistic parameter values (e.g., a complete RUBE_SEARCH_TOOLS call followed by a SHOPIFY_BULK_CREATE_PRODUCTS call with sample product data)
Add explicit validation/verification steps after destructive operations like bulk product creation (e.g., 'After bulk create, call SHOPIFY_GET_PRODUCTS to verify products were created correctly')
Remove the quick reference table or the detailed workflow sections to eliminate redundancy—keep one authoritative source for tool-to-parameter mappings
Split the detailed workflow sections and pitfalls into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with the setup flow and most common patterns
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes unnecessary padding like the 'When to use' descriptions that restate the obvious, the 'When to Use' section at the bottom that adds nothing, and some pitfalls that explain basic concepts Claude would know (e.g., 'Customer data includes order count and total spent'). The quick reference table largely duplicates the workflow sections above it. | 3 / 5 |
Actionability | The skill lists tool names and key parameters, which is somewhat concrete, but lacks executable examples showing actual tool calls with realistic parameter values. The instruction to 'always call RUBE_SEARCH_TOOLS first to get current tool schemas' undermines the value of the detailed tool listings, and the GraphQL section is pseudocode rather than a real example. No actual input/output examples are provided. | 3 / 5 |
Workflow Clarity | The setup workflow has a clear 4-step sequence with 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—destructive/batch operations without validation caps this at 3. | 3 / 5 |
Progressive Disclosure | The content is a monolithic file with no references to supporting files despite being long enough (~150 lines) to benefit from splitting. The quick reference table, detailed workflow sections, and pitfalls could be organized into separate files. There are no bundle files to reference, and the skill doesn't attempt any progressive structure beyond section headers. | 2 / 5 |
Total | 11 / 20 Passed |