Skip to content

ericrisco/rsc-harness / skills/shopify

shopify

Verified

Use when building or customizing a Shopify store across its three code surfaces — themes (Liquid, Online Store 2.0 sections, blocks and JSON templates), apps (Remix with the versioned GraphQL Admin API and its query-cost model), and checkout (UI extensions, Functions, Web Pixels), plus the CLI flow and checkout-extensibility migration. NOT WooCommerce or PHP stores (that is `wordpress`), NOT the React layer of a headless storefront (that is `nextjs`), NOT non-Shopify payment integrations (that is `stripe`).

FileKindSize
SKILL.mdskill md12.4 KB
evals/README.mdmarkdown1.0 KB
evals/cases.yamlconfig2.8 KB
references/apps-graphql.mdmarkdown3.5 KB
references/checkout-extensibility.mdmarkdown3.8 KB
references/liquid-themes.mdmarkdown3.8 KB
scripts/verify.shexecutablescript5.0 KB

evals/cases.yaml

View on GitHub
skill: shopify

should_trigger:
  - prompt: "Add a customizable section to my Shopify theme that merchants can edit in the theme editor without asking me to deploy."
    why: "OS 2.0 section + {% schema %} with presets — the editable-content theme surface."
  - prompt: "Build a Shopify app with Remix that reads orders from the Admin API and shows them in an embedded admin page."
    why: "App surface: Remix template, admin.graphql(), App Bridge/Polaris."
  - prompt: "Our checkout customizations stopped working after the August upgrade — how do I get them back?"
    why: "Non-obvious: 2025-08-28 was the Plus self-migrate deadline; automatic upgrades begin 2026-01 → rebuild on checkout extensibility."
  - prompt: "Replace the include tags in our Liquid snippets and stop the price from showing raw cents."
    why: "Theme/Liquid rules: {% render %} over {% include %}, pipe through | money."
  - prompt: "migrar el checkout.liquid a checkout extensibility i afegir un bloc d'app a la secció de producte"
    why: "Catalan; checkout migration + @app block — both core surfaces of this skill."
  - prompt: "We're getting MAX_COST_EXCEEDED from the Shopify Admin API on a big product export."
    why: "Non-obvious: GraphQL query-cost/throttle model → bulk operations."

should_not_trigger:
  - prompt: "Build a WooCommerce store with a custom PHP theme and a few hooks in functions.php."
    route_to: wordpress
    why: "WooCommerce/PHP/WP plugin model, not Liquid + shopify.*.toml + GraphQL Admin API."
  - prompt: "Integrate Stripe Checkout and subscription billing into our SaaS app."
    route_to: stripe
    why: "Non-Shopify payment system; Shopify Payments/checkout is in-platform only."
  - prompt: "Build the React/RSC frontend and routing for our headless storefront."
    route_to: nextjs
    why: "The rendering/routing layer is Next.js; Shopify is only the data seam there."
  - prompt: "Set up a no-code drag-and-drop online store, no developers involved."
    route_to: no-code-app
    why: "Non-developer store builder; this skill is the code surfaces (Liquid, CLI, GraphQL)."
  - prompt: "Design our public REST API's versioning, pagination, and status-code conventions."
    route_to: api-design
    why: "Generic API contract design, not Shopify's specific versioned GraphQL + cost model."

capability:
  - scenario: "Scaffold an OS 2.0 section with {% schema %} + @app block support, and a Remix loader that queries products via the Admin GraphQL API."
    must_include:
      - "uses {% render %} (not {% include %})"
      - "{% schema %} with a presets entry and a { type: '@app' } block"
      - "pins a current apiVersion (2026-04 or another supported quarterly version) and uses admin.graphql()"
      - "mentions query-cost / throttleStatus or bulk-operations awareness"
      - "escapes/pipes dynamic output (| escape / | money) and does NOT touch checkout.liquid"
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall