Communitygithub.com

shopify/shopify-admin

Shopify 관리자 확장 앱 및 통합을 위한 **Admin GraphQL** 쿼리와 뮤테이션을 작성하거나 설명합니다. 사용자가 작업 실행 전에 작업 자체를 **이해, 설계, 생성**하려는 경우에 사용하세요.

shopify-admin란 무엇인가요?

이 스킬은 개발자가 Shopify 관리자 API와 상호작용할 수 있도록 설계된 AI 어시스턴트입니다. Shopify 관리자를 확장하는 앱 및 통합을 위한 Admin GraphQL 쿼리와 뮤테이션을 작성, 설명 및 생성하는 데 특화되어 있습니다. 사용자가 특정 작업(예: 제품 생성, 주문 업데이트)을 실행하기 전에 GraphQL 작업 자체를 이해, 설계 또는 생성하려는 경우에 유용합니다. 이 스킬은 작업 정의에 중점을 두며, 실제 실행(Shopify CLI를 통한)이나 앱/확장 구성 검증은 shopify/shopify-cli 스킬로 처리되므로 이 스킬과 shopify/shopify-cli 스킬 간의 경계를 명확히 합니다. 주요 기능에는 적절한 GraphQL 구문 제안, 스키마 세부 정보 설명, 일반적인 관리 작업에 대한 템플릿 제공이 포함됩니다. 이 스킬은 Cursor, Claude Code, Codex 등을 포함한 주요 AI 에이전트 플랫폼과 호환됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-admin

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

shopify-admin은(는) 무엇을 하나요?

Shopify 관리자를 확장하는 앱 및 통합을 위한 Admin GraphQL 쿼리와 뮤테이션을 작성하거나 설명합니다. 사용자가 작업 실행 전에 작업 자체를 이해, 설계, 생성하려는 경우에 사용하세요. 앱 또는 확장 구성 검증을 위해 admin을 먼저 선택하지 마세요 — **use-shopify-cli**를 사용하세요. Shopify CLI를 통해 Admin GraphQL을 지금 실행하거나 CLI 설정/문제 해결(스토어 워크플로)을 위해 admin을 먼저 선택하지 마세요 — **use-shopify-cli**를 사용하세요(스토어 인증/실행, 핸들/SKU/위치 조회, 재고 변경).

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

shopify/shopify-admin-execution

Run a validated Admin GraphQL operation against a specific store using Shopify CLI. Use this when the user wants an executable store workflow, not just the query or mutation text. If the answer should include `shopify store auth` and `shopify store execute`, choose this API. Choose this for 'my store', 'this store', a store domain, product reads on a merchant store, low-inventory lookups, product updates, and warehouse/location inventory changes. Examples: 'Show me the first 10 products on my store', 'Find products with low inventory on my store', 'Set inventory at the Toronto warehouse so SKU ABC-123 is 12'.

shopify/shopify-app-store-review

Run a pre-submission compliance check against your Shopify app's codebase. Reviews App Store requirements and surfaces likely issues before you submit for official review.

shopify/shopify-custom-data

MUST be used first when prompts mention Metafields or Metaobjects. 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 provide a schema and configuration for values to follow.

shopify/shopify-customer

The Customer Account API allows customers to access their own data including orders, payment methods, and addresses.

shopify/shopify-dev

Search Shopify developer documentation across all APIs. Use only when no API-specific skill applies.

shopify/shopify-functions

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 Delivery Option Generator, Order Routing Location Rule, Payment Customization

shopify/shopify-hydrogen

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, Markets, Partytown + Google Tag Manager, Subscriptions, Third-party API Queries and Caching. MANDATORY: Use this API for ANY Hydrogen storefront question - do NOT use Storefront GraphQL when 'Hydrogen' is mentioned.

shopify/shopify-liquid

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, shopify-theme-schemas

shopify/shopify-onboarding-dev

Get started building on Shopify. Use when a developer asks to build an app, build a theme, create a dev store, set up a partner account, scaffold a project, or get started developing for Shopify. NOT for merchants managing stores.

shopify/shopify-onboarding-merchant

Set up and connect a Shopify store from your AI assistant. Use when the user wants to: set up my Shopify store, connect my store, install Shopify plugin, get started with Shopify, manage my store, add products to my store, merchant onboarding, start selling online, Shopify setup help, create my first store, how do I set up an online store, import products, migrate from Square, migrate from WooCommerce, migrate from Etsy, migrate from Amazon, migrate from eBay, migrate from Wix, import from Google Merchant Center, migrate from Clover, migrate from Lightspeed, move products to Shopify, import catalog, replatform to Shopify. This is for store owners — not developers.

shopify/shopify-partner

The Partner API lets you programmatically access data about your Partner Dashboard, including your apps, themes, and affiliate referrals.

shopify/shopify-payments-apps

The Payments Apps API enables payment providers to integrate their payment solutions with Shopify's checkout.

shopify/shopify-polaris-admin-extensions

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/shopify-polaris-app-home

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.

shopify/shopify-polaris-checkout-extensions

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.

shopify/shopify-polaris-customer-account-extensions

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/shopify-pos-ui

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, smart grid

shopify/shopify-storefront-graphql

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>, <shopify-cart>, use storefront-web-components instead.

shopify/shopify-use-shopify-cli

Choose when the user needs **Shopify CLI** to run or fix something now: validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`, `shopify.extension.toml`); run or troubleshoot store workflows (`shopify store auth`, `shopify store execute`); inventory or product changes by handle, SKU, or location name; or CLI setup, auth, upgrade issues. Emphasize **commands and operational steps**, not only authoring GraphQL. Skip for API-only understanding or codegen with no CLI execution. Examples: validate configuration before deploy; run an existing query via CLI; list products; missing `shopify store execute`.

shopify/ucp

Use when the user wants to use the UCP CLI to find, compare, buy, or track products from online merchants, or to set up and troubleshoot the local UCP profile required for merchant-scoped operations. Covers global catalog search ("find me X under $Y"), named-merchant transactions ("buy this from Z.com"), order tracking, `ucp profile init`, `ucp doctor`, carts, checkout, orders, and UCP setup/help. Falls back to merchant-hosted handoff when direct in-protocol checkout isn't available.

관련 스킬