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.
72
88%
Does it follow best practices?
Impact
—
No eval scenarios have been run
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 clearly defines its scope around Shopify development with highly specific capabilities, comprehensive trigger terms, and explicit guidance on when to invoke it. It uses proper third-person voice throughout and covers both the 'what' and 'when' thoroughly. The description is distinctive enough to avoid conflicts with other web development or e-commerce skills.
| 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), and 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 in Shopify development. The specific 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
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable Shopify skill with excellent code examples and a well-structured validation workflow. Its main weaknesses are the missing bundle reference files that the progressive disclosure table points to, and some token inefficiency from generic sections (Output Templates, Knowledge Reference) that don't add value for Claude. The code examples are a genuine strength, providing real-world patterns across the full Shopify development stack.
Suggestions
Create the five referenced files (references/liquid-templating.md, etc.) to fulfill the progressive disclosure table, and consider moving the longer code examples into those reference files to slim down the main skill.
Remove the 'Knowledge Reference' keyword list and the 'Output Templates' section — these are generic instructions Claude doesn't need and consume tokens without adding actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some unnecessary elements: the 'Knowledge Reference' section is a keyword dump Claude already knows, the 'Output Templates' section is generic guidance Claude doesn't need, and some constraints like 'Use TypeScript for app development' are opinionated rather than essential. The code examples are well-chosen but collectively make the file quite long. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready code examples across Liquid templates, GraphQL queries, CLI commands, and TypeScript app code. Each example is complete and contextual with file path comments and realistic patterns. | 3 / 3 |
Workflow Clarity | The core workflow has a clear 5-step sequence with explicit validation checkpoints: 'Run shopify theme check for Liquid linting; if errors are found, fix them and re-run before proceeding' and 'If validation fails at any step, resolve all reported issues before moving to deployment.' This includes proper feedback loops for error recovery. | 3 / 3 |
Progressive Disclosure | The reference table with 'Load When' guidance is well-structured and clearly signaled, but no bundle files are provided, meaning all five referenced files (references/liquid-templating.md, etc.) are missing. The inline code examples are extensive and could arguably be moved to reference files, making the main skill leaner. | 2 / 3 |
Total | 10 / 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
e8be415
- 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.