Automate Shopify tasks via Rube MCP (Composio): products, orders, customers, inventory, collections. Always search tools first for current schemas.
64
53%
Does it follow best practices?
Impact
74%
2.05xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/shopify-automation/SKILL.mdQuality
Discovery
57%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a clear domain (Shopify via Rube MCP/Composio) and lists relevant entity types, giving it good distinctiveness. However, it lacks specific concrete actions beyond 'automate tasks' and is missing an explicit 'Use when...' clause that would help Claude know when to select this skill. The implementation note about searching tools first is useful but doesn't substitute for proper trigger guidance.
Suggestions
Add a 'Use when...' clause with explicit triggers, e.g., 'Use when the user asks about Shopify store management, e-commerce operations, or mentions products, orders, customers, or inventory in a Shopify context.'
Replace the vague 'Automate Shopify tasks' with specific actions like 'Create and update products, process orders, manage customers, adjust inventory levels, and organize collections in Shopify.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Shopify) and lists entity types (products, orders, customers, inventory, collections), but doesn't describe specific concrete actions like 'create products', 'update inventory levels', or 'process refunds'. The word 'Automate' is somewhat vague. | 2 / 3 |
Completeness | The 'what' is partially addressed (automate Shopify tasks across several entity types), but there is no explicit 'when' clause. The instruction to 'always search tools first' is an implementation detail rather than a trigger condition. Missing a 'Use when...' clause caps this at 2. | 2 / 3 |
Trigger Term Quality | Includes 'Shopify', 'products', 'orders', 'customers', 'inventory', 'collections' which are relevant keywords users might say. However, it misses common variations like 'e-commerce', 'store', 'shop', 'fulfillment', 'shipping', and lacks a 'Use when...' clause with natural trigger phrases. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'Shopify' and 'Rube MCP (Composio)' creates a very distinct niche. It's unlikely to conflict with other skills unless there are multiple Shopify-related skills, and the specific tooling reference further disambiguates it. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
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 solid catalog of Shopify tools and workflows but falls short on actionability—it describes tools and parameters without showing concrete invocation examples with real values. The content is moderately well-organized but overly long for a single file, with duplicated information between workflow sections and the quick reference table. Adding concrete examples and splitting detailed reference material into separate files would significantly improve quality.
Suggestions
Add concrete, copy-paste-ready tool invocation examples with realistic parameter values (e.g., show an actual RUBE_SEARCH_TOOLS call and a SHOPIFY_GET_ORDERS_WITH_FILTERS call with specific filters)
Move the quick reference table and detailed per-workflow pitfalls into a separate REFERENCE.md file to reduce the main skill's length and improve progressive disclosure
Add validation/verification steps within core workflows (e.g., 'Check response for errors before proceeding' or 'Verify product was created by calling SHOPIFY_GET_PRODUCT')
Remove or consolidate the 'When to use' lines which are self-evident from the section headings, and trim redundant pitfalls that Claude can infer
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary content. The 'When to use' lines are somewhat redundant, and the pitfalls sections contain information Claude could infer. The quick reference table duplicates information already covered in the workflow sections. However, it avoids explaining basic concepts like what Shopify is. | 2 / 3 |
Actionability | The skill lists specific tool names and parameters, which is helpful, but lacks executable examples showing actual tool invocations with concrete parameter values. The GraphQL section is particularly vague ('Call SHOPIFY_GRAPH_QL_QUERY with custom query'). No example payloads or responses are shown for any workflow. | 2 / 3 |
Workflow Clarity | Steps are listed with clear sequences and the setup flow includes a validation checkpoint (confirm ACTIVE status). However, most workflow steps are marked [Optional] making the actual decision logic unclear, and there are no validation/verification steps within the core workflows themselves (e.g., confirming a bulk product creation succeeded, checking for errors in responses). | 2 / 3 |
Progressive Disclosure | The content is reasonably structured with clear sections and a quick reference table, but it's quite long (~150 lines) with no bundle files to offload detail into. The workflow details, pitfalls, and the full reference table could be split into separate files. The single external link to Composio docs is appropriate but insufficient for the volume of inline content. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
c911a92
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.