shopify-expert
Builds and debugs Shopify themes (.liquid files, theme.json, sections), develops custom Shopify apps (shopify.app.toml, OAuth, webhooks), and implements Storefront API integrations for headless storefronts. Use when building or customizing Shopify themes, creating Hydrogen or custom React storefronts, developing Shopify apps, implementing checkout UI extensions or Shopify Functions, optimizing performance, or integrating third-party services. Invoke for Liquid templating, Storefront API, app development, checkout customization, Shopify Plus features, App Bridge, Polaris, or Shopify CLI workflows.
95
92%
Does it follow best practices?
Impact
97%
1.14xAverage score across 6 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that thoroughly covers the Shopify development domain with specific actions, comprehensive trigger terms, and explicit guidance on when to invoke it. It uses proper third-person voice throughout and provides enough detail to distinguish it from general web development or other e-commerce platform skills. The description is information-dense without being padded with fluff.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: builds/debugs Shopify themes (.liquid files, theme.json, sections), develops custom Shopify apps (shopify.app.toml, OAuth, webhooks), implements Storefront API integrations for headless storefronts. Very detailed with file types and technologies named. | 3 / 3 |
Completeness | Clearly answers both 'what' (builds/debugs themes, develops apps, implements Storefront API integrations) and 'when' with explicit trigger guidance via two 'Use when' / 'Invoke for' clauses covering a comprehensive range of scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: Shopify themes, .liquid files, Hydrogen, React storefronts, Shopify apps, checkout UI extensions, Shopify Functions, Liquid templating, Storefront API, Shopify Plus, App Bridge, Polaris, Shopify CLI. These are all terms a developer would naturally use when seeking Shopify help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche around Shopify-specific development. The mention of Shopify-specific technologies (Liquid, Hydrogen, Polaris, App Bridge, shopify.app.toml) makes it very unlikely to conflict with general web development or e-commerce skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured Shopify skill with strong actionability through executable code examples spanning themes, APIs, and apps. The progressive disclosure via the reference table is exemplary, and the workflow includes proper validation checkpoints. Minor inefficiencies exist in the 'Knowledge Reference' keyword dump and some sections that could be tightened, but overall this is a high-quality skill.
Suggestions
Remove the 'Knowledge Reference' keyword list at the bottom — it provides no actionable guidance and wastes tokens on information Claude already knows.
Consider moving some of the longer code examples (like the full GraphQL query) into the reference files, keeping only the most essential example inline to improve conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some unnecessary elements — the 'Knowledge Reference' section at the bottom is just a keyword list that adds no actionable value, and the 'Output Templates' section is somewhat generic. The code examples are well-chosen but collectively make the file quite long when references exist for detailed guidance. | 2 / 3 |
Actionability | Provides fully executable code examples across multiple domains (Liquid templates, GraphQL queries, TypeScript app code, CLI commands). Examples are copy-paste ready with realistic patterns like metafield access, collection filtering, and authenticated API calls. | 3 / 3 |
Workflow Clarity | The core workflow has clear sequencing with explicit validation checkpoints — step 4 specifies running `shopify theme check` and fixing errors before proceeding, and states 'resolve all reported issues before moving to deployment.' This is a proper feedback loop for the deployment pipeline. | 3 / 3 |
Progressive Disclosure | Excellent use of a reference table with clear 'Load When' conditions pointing to one-level-deep reference files. The main skill provides a concise overview with actionable examples while deferring detailed topic-specific guidance to separate files. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- jeffallan/claude-skills
- Commit
3d95bb1
- Reviewed
Table of Contents
Is this your skill?
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.