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.
98
100%
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 excels across all dimensions. It provides specific concrete actions with technical details, comprehensive trigger terms covering both technical and user-friendly language, explicit 'Use when' and 'Invoke for' clauses, and highly distinctive Shopify-specific terminology that minimizes conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Builds and debugs Shopify themes (.liquid files, theme.json, sections)', 'develops custom Shopify apps (shopify.app.toml, OAuth, webhooks)', 'implements Storefront API integrations for headless storefronts'. Includes specific file types and technical components. | 3 / 3 |
Completeness | Clearly answers both what (builds themes, develops apps, implements API integrations) AND when with explicit 'Use when...' and 'Invoke for...' clauses that provide comprehensive trigger guidance for various Shopify-related scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Shopify themes', '.liquid files', 'Hydrogen', 'React storefronts', 'checkout UI extensions', 'Shopify Functions', 'Liquid templating', 'Storefront API', 'App Bridge', 'Polaris', 'Shopify CLI'. Covers both technical and common terminology. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with Shopify-specific terminology throughout. The combination of Shopify-specific terms (Liquid, Hydrogen, Polaris, App Bridge, Shopify CLI) creates a clear niche that would not conflict with general web development or e-commerce skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill file that demonstrates best practices across all dimensions. It provides actionable, executable code examples while maintaining token efficiency, includes clear validation workflows with feedback loops, and uses progressive disclosure effectively through a well-organized reference table. The constraints section adds valuable guardrails without being verbose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding explanations of basic concepts Claude already knows. Every section serves a purpose with no padding or unnecessary context about what Shopify is or how e-commerce works. | 3 / 3 |
Actionability | Provides fully executable code examples across Liquid, GraphQL, TypeScript, and bash commands. All examples are copy-paste ready with proper syntax and realistic use cases like product templates and API queries. | 3 / 3 |
Workflow Clarity | The core workflow has clear sequencing with explicit validation checkpoints: 'Run shopify theme check... 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 provides proper feedback loops. | 3 / 3 |
Progressive Disclosure | Excellent structure with a clear reference table pointing to topic-specific files (liquid-templating.md, storefront-api.md, etc.) with explicit 'Load When' guidance. Content is appropriately split between overview and detailed references. | 3 / 3 |
Total | 12 / 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
5b76101
- 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.