With today's release of AI Toolkit, all existing shopify- skills are consolidated into a single shopify skill. If you use AI Toolkit skills with agents or npx skills, you might need to update your environment.
What changed
Shopify skills content in AI Toolkit was previously distributed across many skills, such as shopify-dev-onboarding, shopify-admin, and shopify-functions. The agent plugins and the AI Toolkit skills repository now expose a consolidated shopify skill that covers these use cases and supports development and merchant workflows.
Who's affected
You're affected if you install or run AI Toolkit skills through:
- Agent environments that support plugins
npx skills- Similar tools that install individual
shopify-skills
Users of the ucp skill and Dev MCP are unaffected.
Why this matters
The previous skill architecture sometimes led to agent confusion and caused truncation of skill descriptions when they took up too much of the context window. Consolidating content into a single shopify skill reduces this ambiguity and the number of skill descriptions in agent context.
What to do
Many agent environments that support plugins update skills automatically. If yours doesn't, or if you want to update immediately, use the agent's plugin management tools to update the plugin.
If you use npx skills, run the following commands:
# remove deprecated skills, add -g for global install
npx skills remove -y shopify-admin shopify-app-pricing shopify-app-store-review shopify-custom-data shopify-customer shopify-dev shopify-functions shopify-hydrogen shopify-liquid shopify-onboarding-dev shopify-onboarding-merchant shopify-partner shopify-payments-apps shopify-polaris-admin-extensions shopify-polaris-app-home shopify-polaris-checkout-extensions shopify-polaris-customer-account-extensions shopify-pos-ui shopify-shopifyql shopify-storefront-graphql shopify-use-shopify-cli
# reinstall the new skill
npx skills add Shopify/shopify-ai-toolkit --skill shopifyThese commands remove the deprecated shopify- skills from your environment and install the unified shopify skill from the AI Toolkit repository. Use -g if you installed skills globally, and run these commands in each environment where you previously installed the old skills.