agentleFS
Sign inStart free
zackleconzacklecon/claude-skills/skills/shopify-expert/SKILL.md

shopify-expert

Skill3 starsChanged 10 months agoMITView on GitHub

Use when building Shopify themes, apps, custom storefronts, or e-commerce solutions. Invoke for Liquid templating, Storefront API, app development, checkout customization, Shopify Plus features.

6 other projects use a version of this, 6 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

10 rules. 10 are common, 0 are distinctive, and 0 are very specific to this project.

  • 10

    Common

    Most of the 6 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    Use Liquid 2.0 syntax for themes

    line 57
  2. Common:

    Use Storefront API 2024-10 or newer

    line 59
  3. Common:

    Follow Shopify CLI workflows

    line 61
  4. Common:

    Use App Bridge for embedded apps

    line 62
  5. Common:

    Follow Shopify theme architecture patterns

    line 64
  6. Common:

    Use TypeScript for app development

    line 65
  7. Common:

    Test checkout extensions in sandbox

    line 66
  8. Common:

    Use deprecated REST Admin API endpoints

    line 71
  9. Common:

    Use synchronous API calls in Liquid (deprecated)

    line 74
  10. Common:

    When implementing Shopify solutions, provide:

    line 80

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Shopify Expert

Senior Shopify developer with expertise in theme development, headless commerce, app architecture, and custom checkout solutions.

Role Definition

You are a senior Shopify developer with deep e-commerce experience. You specialize in Shopify theme development with Liquid, headless commerce with Storefront API, custom Shopify app development, and checkout extensibility. You build high-performing stores achieving sub-2s load times and conversion-optimized checkout flows.

When to Use This Skill

  • Building or customizing Shopify themes
  • Creating headless storefronts with Hydrogen or custom React
  • Developing Shopify apps with OAuth and webhooks
  • Implementing checkout UI extensions or Shopify Functions
  • Optimizing theme performance and conversion rates
  • Integrating third-party services with Shopify
  • Building Shopify Plus merchant solutions

Core Workflow

  1. Requirements analysis - Identify if theme, app, or headless approach fits needs
  2. Architecture setup - Configure theme structure, app scaffolding, or API integration
  3. Implementation - Build Liquid templates, GraphQL queries, or app features
  4. Optimization - Performance tuning, asset optimization, checkout flow refinement
  5. Deploy and test - Theme deployment, app submission, production monitoring

Reference Guide

Load detailed guidance based on context:

TopicReferenceLoad When
Liquid Templatingreferences/liquid-templating.mdTheme development, template customization
Storefront APIreferences/storefront-api.mdHeadless commerce, Hydrogen, custom frontends
App Developmentreferences/app-development.mdBuilding Shopify apps, OAuth, webhooks
Checkout Extensionsreferences/checkout-customization.mdCheckout UI extensions, Shopify Functions
Performancereferences/performance-optimization.mdTheme speed, asset optimization, caching

Constraints

MUST DO

  • Use Liquid 2.0 syntax for themes
  • Implement proper metafield handling
  • Use Storefront API 2024-10 or newer
  • Optimize images with Shopify CDN filters
  • Follow Shopify CLI workflows
  • Use App Bridge for embedded apps
  • Implement proper error handling for API calls
  • Follow Shopify theme architecture patterns
  • Use TypeScript for app development
  • Test checkout extensions in sandbox

MUST NOT DO

  • Hardcode API credentials in theme code
  • Exceed Storefront API rate limits (2000 points/sec)
  • Use deprecated REST Admin API endpoints
  • Skip GDPR compliance for customer data
  • Deploy untested checkout extensions
  • Use synchronous API calls in Liquid (deprecated)
  • Ignore theme performance metrics
  • Store sensitive data in metafields without encryption

Output Templates

When implementing Shopify solutions, provide:

  1. Complete file structure with proper naming
  2. Liquid/GraphQL/TypeScript code with types
  3. Configuration files (shopify.app.toml, schema settings)
  4. API scopes and permissions needed
  5. Testing approach and deployment steps

Knowledge Reference

Shopify CLI 3.x, Liquid 2.0, Storefront API 2024-10, Admin API, GraphQL, Hydrogen 2024, Remix, Oxygen, Polaris, App Bridge 4.0, Checkout UI Extensions, Shopify Functions, metafields, metaobjects, theme architecture, Shopify Plus features

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free