Quick Ref / Command

Engineer Kit

/ak:shopify

Shopify Development

Guides Shopify app, extension, theme, API, Polaris, Liquid, checkout, webhook, and billing work with Shopify CLI-centered workflows.

01

Pick surface

02

Prepare CLI

03

Initialize project

04

Add extension point

Rule 01

Build the right Shopify surface before writing code

Rule 02

Prefer GraphQL Admin API over REST for new work

Rule 03

Request only the scopes and fields the feature actually needs

Rule 04

Use development stores and Partner Dashboard evidence before deployment

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Pick surface Decide whether the user needs an app, extension, theme, or combined app plus theme extension.
  2. 2 Prepare CLI Install or verify Shopify CLI before creating apps, extensions, themes, or deployments.
02

Work

Agent / skill execution

  1. 3 Initialize project Use shopify app init or shopify theme init, then configure scopes, theme choice, and local dev context.
  2. 4 Add extension point Generate checkout, admin, POS, customer-account, function, or theme app extension work as needed.
03

Verify

Gate, review, validation

  1. 5 Implement platform patterns Prefer GraphQL Admin API, Polaris UI, Liquid sections, pagination, rate-limit handling, and minimal access scopes.
  2. 6 Secure integrations Keep credentials in environment variables, validate webhook signatures, use OAuth/session tokens, and verify GDPR needs.
04

Close

Report, handoff, artifact

  1. 7 Test stores Use development stores, multiple plans, mobile responsiveness, accessibility, and extension visibility checks.
  2. 8 Deploy safely Run app deploy or theme push/publish only after local preview and version compatibility checks.

Syntax, arguments, subcommands

How to invoke the skill: syntax, positional arguments, shared options, then each subcommand with its own syntax and outcome.

Syntax

/ak:shopify [extension-type] [feature]

Arguments

[extension-type]

Shopify surface

Target surface or extension type, such as app, checkout_ui_extension, admin_action, admin_block, pos_ui_extension, function, theme, or a more specific Shopify target. This chooses the workflow; it does not authorize store sync, deploy, push, or publish.

/ak:shopify checkout_ui_extension "Add an optional gift message to the existing app"
[feature] Required

Feature brief

Merchant or shopper outcome plus constraints: existing app or theme files, pinned CLI and API versions, store boundary, scopes, webhook, billing, privacy, data-retention needs, tests, and explicit authority for any remote mutation. Keep secrets out of the prompt.

/ak:shopify theme "Customize the product page in the current Liquid theme without pushing or publishing"

Don't skip the required step

Each item contrasts a tempting shortcut with the required approach.

Tempting shortcut

REST is fine for a quick feature.

Do this instead

New Shopify data work should prefer GraphQL Admin API and request only necessary fields.

Tempting shortcut

A broad token avoids permission surprises.

Do this instead

The skill requires minimal access scopes, environment-stored credentials, OAuth/session tokens, and webhook signature checks.

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Checkout UI extension Recommended
/ak:shopify checkout_ui_extension gift message field
Use when:
Customizing checkout flow with a Shopify checkout extension.
Expected:
Guides Shopify CLI extension generation, React checkout UI implementation, app dev testing, extension target checks, and app deploy.
Merchant app with billing
/ak:shopify app product sync with billing
Use when:
Building a merchant-facing app that accesses store data and charges for functionality.
Expected:
Covers app init, access scopes in shopify.app.toml, GraphQL Admin API queries, OAuth, billing, webhooks, and credential handling.
Liquid theme customization
/ak:shopify theme product page customization
Use when:
Custom storefront design or product page changes belong in a Shopify theme.
Expected:
Uses theme init/dev/pull/push workflows, Liquid product patterns, local preview, image optimization, accessibility, and safe publish steps.
Function extension
/ak:shopify function delivery rule
Use when:
Implementing discount, payment, delivery, or validation rules as a Shopify Function.
Expected:
Selects the function extension path, runs Shopify CLI generation, keeps the app dev/deploy loop, and applies testing and troubleshooting checks.

Handled Scope

  • Shopify CLI
  • Admin GraphQL
  • checkout extensions
  • Liquid themes
  • Polaris UI
  • webhooks and billing

Next