Shopify 开发的面很宽：Liquid 主题、Storefront GraphQL、Admin API、Functions、Checkout 扩展、Hydrogen，以及 Polaris 应用框架。Claude Skill 把其中某一面的约定打包好，让 Agent 不再猜，而是照着 Shopify 官方的模式写。
下面这 15 个技能是最值得先装的。按它们负责的工作分组 —— 店面、后台数据、结算、应用界面和文档 —— 每个都链到 FlowCay 详情页，附接入说明。
Skill 和 MCP 服务解决的是不同问题。Skill 教 Agent 怎么写 Shopify 代码；MCP 服务给它读取店铺实时数据的能力。多数团队最后两个都要用。
| 工具 | 适合 | 定价 | 平台 |
|---|---|---|---|
| 不用猜 schema 就能写对 Admin API 的查询与变更 | 免费 | Shopify | |
| 遵循 Liquid 与 Online Store 2.0 规范的模板改动 | 免费 | Shopify | |
| 用 Shopify Functions 实现折扣、购物车与结算逻辑 | 免费 | Shopify | |
| Hydrogen + React 店面与 Oxygen 部署 | 免费 | Shopify | |
| 商品、购物车与合集的 Storefront API 查询 | 免费 | Shopify | |
| 带正确定义的元字段与元对象 | 免费 | Shopify | |
| Partner API：应用、主题与联盟数据 | 免费 | Shopify | |
| Customer Account API 流程与客户数据 | 免费 | Shopify | |
| 结算环节的支付服务商集成 | 免费 | Shopify | |
| 用 Polaris 组件写 Checkout UI 扩展 | 免费 | Shopify | |
| 用 Polaris 构建嵌入式应用首页 | 免费 | Shopify | |
| 在正确的扩展点插入后台动作与区块 | 免费 | Shopify | |
| 零售场景的 POS UI 扩展 | 免费 | Shopify | |
| 客户账户里的订单与资料页扩展 | 免费 | Shopify | |
| 跨 Shopify 开发者文档的检索 | 免费 | Shopify |
当工作发生在主题里 —— section、block、Liquid 逻辑或 Hydrogen 店面 —— 用这一组。技能会给出文件组织约定和应该遵循的 API 形态。
1 Liquid is an open-source templating language created by Shopify. It is the backbone of Shopify themes and is used to load dynamic content on storefronts. Keywords: liquid, theme, shopify-theme, liquid-component, liquid-block, liquid-section, liquid-snippet, liquid-schemas,…
适合: Liquid 主题、section 与 Online Store 2.0 block
Shopify 2 Hydrogen storefront implementation cookbooks. Some of the available recipes are: B2B Commerce, Bundles, Combined Listings, Custom Cart Method, Dynamic Content with Metaobjects, Express Server, Google Tag Manager Integration, Infinite Scroll, Legacy Customer Account Flow,…
适合: Hydrogen + React 店面与 Oxygen 部署
Shopify 3 Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI. NOT for Web Components - if the prompt mentions HTML tags like <shopify-store>,…
适合: 商品、购物车与合集的 Storefront API 查询
Shopify后台类工作 —— 商品、订单、客户、元字段和合作伙伴数据 —— 这些技能让 Agent 老老实实走 Admin API，而不是自己编接口。
4 The Admin GraphQL API lets you build apps and integrations that extend and enhance the Shopify admin.
适合: Admin GraphQL：商品、订单、库存、元字段
Shopify 5 Use Metafields and Metaobjects to model and store custom data for your app. Metafields extend built-in Shopify data types like products or customers, Metaobjects are custom data types that can be used to store bespoke data structures. Metafield and Metaobject definitions…
适合: 带正确定义的元字段与元对象
Shopify 6 The Partner API lets you programmatically access data about your Partner Dashboard, including your apps, themes, and affiliate referrals.
适合: Partner API：应用、主题与联盟数据
Shopify 7 The Customer Account API allows customers to access their own data including orders, payment methods, and addresses.
适合: Customer Account API 流程与客户数据
Shopify结算（Checkout）是 Shopify 项目里风险最高的部分。这些技能覆盖 Functions、支付应用和 Checkout UI 扩展，并带上 Shopify 的硬性约束。
8 Shopify Functions allow developers to customize the backend logic that powers parts of Shopify. Available APIs: Discount, Cart and Checkout Validation, Cart Transform, Pickup Point Delivery Option Generator, Delivery Customization, Fulfillment Constraints, Local Pickup…
适合: 折扣、购物车与配送自定义逻辑
Shopify 9 The Payments Apps API enables payment providers to integrate their payment solutions with Shopify's checkout.
适合: 结算环节的支付服务商集成
Shopify 10 Build custom functionality that merchants can install at defined points in the checkout flow, including product information, shipping, payment, order summary, and Shop Pay. Checkout UI Extensions also supports scaffolding new checkout extensions using Shopify CLI commands.
适合: 用 Polaris 组件写 Checkout UI 扩展
Shopify如果你做的是嵌入式应用而不是改主题，从这里开始。Polaris 和扩展 target 是最容易耗时间的地方。
11 Build your app's primary user interface embedded in the Shopify admin. If the prompt just mentions `Polaris` and you can't tell based off of the context what API they meant, assume they meant this API.
适合: 用 Polaris 构建嵌入式应用首页
Shopify 12 Add custom actions and blocks from your app at contextually relevant spots throughout the Shopify Admin. Admin UI Extensions also supports scaffolding new adminextensions using Shopify CLI commands.
适合: 在正确的扩展点插入后台动作与区块
Shopify 13 Build retail point-of-sale applications using Shopify's POS UI components. These components provide a consistent and familiar interface for POS applications. POS UI Extensions also supports scaffolding new POS extensions using Shopify CLI commands. Keywords: POS, Retail,…
适合: 零售场景的 POS UI 扩展
Shopify 14 Build custom functionality that merchants can install at defined points on the Order index, Order status, and Profile pages in customer accounts. Customer Account UI Extensions also supports scaffolding new customer account extensions using Shopify CLI commands.
适合: 客户账户里的订单与资料页扩展
Shopify一个纯检索类技能，把 Agent 指向最新的 Shopify 官方文档，而不是过期的博客和论坛回答。
15 Search Shopify developer documentation across all APIs. Use only when no API-specific skill applies.
适合: 跨 Shopify 开发者文档的检索
ShopifySkill 是一份可复用的指令包，Agent 可以针对某个领域加载它。里面通常是约定、文件模式和示例，让 Agent 产出符合 Shopify 规范的代码，而不是泛泛的 React 或 Liquid 猜测。
能。Skill 本质是纯文本指令文件，任何能读仓库或加载技能目录的宿主都能用 —— Claude Code、Cursor、Codex 和自建 Agent 都算。
想让 Agent 正确编写或修改 Shopify 代码，用 Skill。想让 Agent 读写店铺实时数据，用 MCP 服务。完整工作流通常两个都接。
一部分严格遵循 Shopify 官方 API 与文档，另一部分是社区维护的开源包。每个 FlowCay 详情页都会写明来源并给出仓库地址，安装前可以自己核对。
把技能目录克隆或复制到 Agent 的技能目录，然后在提示里引用它，或者让 Agent 自动发现。FlowCay 有一篇《如何安装 Skill》的指南，讲了目录结构。
