Skip to content

Add Shopify agent skills for Claude Code, Cursor, and Claude Desktop#2

Merged
nelsonwittwer merged 6 commits intomainfrom
nw/add-shopify-agent-skills
Apr 6, 2026
Merged

Add Shopify agent skills for Claude Code, Cursor, and Claude Desktop#2
nelsonwittwer merged 6 commits intomainfrom
nw/add-shopify-agent-skills

Conversation

@nelsonwittwer
Copy link
Copy Markdown
Collaborator

Adds 15 agent skills under skills/ — the conventional directory for npx skills add Shopify/shopify-ai-toolkit. Each skill bundles a SKILL.md with agent instructions and mandatory search/validate steps, pre-compiled scripts (search_docs.js, validate.js), and compressed schema assets where applicable.

Skills included:

  • shopify-admin (Admin GraphQL API)
  • shopify-storefront-graphql (Storefront API)
  • shopify-customer (Customer Account API)
  • shopify-partner (Partner API)
  • shopify-payments-apps (Payments Apps API)
  • shopify-functions (Shopify Functions)
  • shopify-hydrogen (Hydrogen / Remix)
  • shopify-liquid (Liquid / Theme development)
  • shopify-polaris-admin-extensions (Admin UI Extensions)
  • shopify-polaris-checkout-extensions (Checkout UI Extensions)
  • shopify-polaris-customer-account-extensions (Customer Account UI Extensions)
  • shopify-polaris-app-home (App Home)
  • shopify-pos-ui (POS UI Extensions)
  • shopify-custom-data (Metafields / Metaobjects)
  • shopify-dev (General Shopify dev)

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Thanks for your interest but we don't accept pull requests. Any pull requests will be automatically closed.

If you have feedback or suggestions, please share them in the Shopify Developer Community.

If you are a Shopify employee, please reach out to Dev Tools: Dev Experience team at help-dev-platform.

@github-actions github-actions bot closed this Apr 2, 2026
@durga256 durga256 reopened this Apr 2, 2026
Copy link
Copy Markdown
Collaborator

@durga256 durga256 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove mcp server from .mcp.json so skills and mcp dont clash when intent is same. tophat looks good so far

nelsonwittwer and others added 6 commits April 6, 2026 15:59
Adds 15 agent skills under skills/ — the conventional directory for
`npx skills add Shopify/shopify-ai-toolkit`. Each skill bundles a
SKILL.md with agent instructions and mandatory search/validate steps,
pre-compiled scripts (search_docs.js, validate.js), and compressed
schema assets where applicable.

Skills included:
- shopify-admin (Admin GraphQL API)
- shopify-storefront-graphql (Storefront API)
- shopify-customer (Customer Account API)
- shopify-partner (Partner API)
- shopify-payments-apps (Payments Apps API)
- shopify-functions (Shopify Functions)
- shopify-hydrogen (Hydrogen / Remix)
- shopify-liquid (Liquid / Theme development)
- shopify-polaris-admin-extensions (Admin UI Extensions)
- shopify-polaris-checkout-extensions (Checkout UI Extensions)
- shopify-polaris-customer-account-extensions (Customer Account UI Extensions)
- shopify-polaris-app-home (App Home)
- shopify-pos-ui (POS UI Extensions)
- shopify-custom-data (Metafields / Metaobjects)
- shopify-dev (General Shopify dev)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Update GQL schemas to 2026-04 (admin, storefront, customer, partner,
  payments-apps, functions)
- Add --client-version flag to search_docs.js and validate.js in all skills
- Forward model, clientName, clientVersion, source, skillVersion to
  instrumentation payload
- Fix malformed </system-instructions> tag in shopify-functions SKILL.md
- Add .gitignore to exclude node_modules

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…y-admin prerequisite

- Add --store flag to all shopify store auth/execute commands
- Add --query/'--query-file' requirements inline
- Add execution-mode persistence rules (read-only, intermediate lookups, pagination)
- Add CLI-upgrade troubleshooting constraint (no fallback to shopify api query)
- Add non-store CLI alternatives to constraints
- Embed ADMIN_GRAPHQL_AUTHORING_STEPS inline (delegating to shopify-admin skill)
- Add ALWAYS validate reminder referencing shopify-admin validate.js
- Closes gap with origin/main learn_shopify_api assembled response

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Per review feedback: skills and MCP server serve overlapping intent,
so shipping both causes routing confusion. Skills-only distribution.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@nelsonwittwer nelsonwittwer force-pushed the nw/add-shopify-agent-skills branch from d866ba5 to f97c38a Compare April 6, 2026 20:04
@nelsonwittwer nelsonwittwer merged commit f625bf7 into main Apr 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants