Shopify’s AI Toolkit just got a major simplification. All the fragmented shopify‑* skills—like shopify‑admin, shopify‑functions, and shopify‑hydrogen—have been merged into a single, streamlined shopify skill. For developers who rely on AI‑driven agents or the npx skills command, this change can feel like a sudden shift, but it’s designed to reduce confusion, cut down on context‑window bloat, and make future updates smoother. In this post we’ll break down exactly what changed, who needs to take action, and step‑by‑step instructions to get your environment back on track.
What Changed
Prior to this release, the AI Toolkit distributed shopify‑specific knowledge across dozens of separate skills (for example, shopify-admin, shopify-functions, shopify-hydrogen, etc.). Each skill contributed its own description, examples, and configuration data. The new architecture replaces that sprawling landscape with one consolidated skill called shopify. This single skill now contains the same content—onboarding guidance, admin commands, function scaffolding, Liquid snippets, and more—while eliminating duplicated metadata that previously ate up valuable context in AI agents.
Who Is Affected
The consolidation primarily impacts developers who:
• Use AI‑Toolkit skills via an agent environment that supports plugins (e.g., Copilot‑style assistants).• Run npx skills to install, remove, or update individual shopify‑* skills.
If you rely on the Unified Commerce Platform (UCP) skill or the Dev MCP, you’re safe—those tools were never part of the fragmented shopify‑* set and remain unchanged.
Why This Matters
The old skill architecture created two practical problems:
By consolidating everything into one shopify skill, Shopify reduces the number of skill descriptions that an agent needs to keep in memory, eliminates ambiguity, and ensures that the most up‑to‑date content is always served from a single source.
How to Update Your Environment
Most modern agent environments that support plugins will pull the latest shopify skill automatically. However, if you manage skills manually—or you want to update right away—follow these steps.
### 1. Remove the Deprecated Skills
Run the npx skills remove command. The list below covers every shopify‑* skill that was deprecated in this release. Add the -g flag if you installed the skills globally.
bash
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
### 2. Install the New Unified Skill
Now add the consolidated skill from the AI Toolkit repository. Again, use -g for a global install, or run the command in each project directory where you need the skill.
bash
npx skills add Shopify/shopify-ai-toolkit --skill shopify
### 3. Verify the Installation
Run npx skills list (or the equivalent command in your agent UI) to confirm that only the shopify skill appears and that the old shopify- prefixes are gone. If you see any residual entries, repeat the removal step or check your shell’s PATH for lingering binaries.
Best Practices & Next Steps
Shopify/shopify-ai-toolkit@v1.2.3) to avoid unexpected changes in production pipelines.npx skills, add a step that runs the removal‑then‑add sequence on each build. This guarantees every build uses the latest consolidated skill without manual intervention.shopify skill metadata.Conclusion & Call to Action
Consolidating AI Toolkit skills into a single shopify skill may feel like a small housekeeping change, but it clears up confusion for AI agents, saves precious context space, and sets the stage for faster future enhancements. If you’re a developer who builds custom agents, scripts, or CLI extensions, take a few minutes today to purge the old shopify‑* skills and install the new unified skill. Doing so ensures you get the most accurate suggestions and keeps your development workflow lean.
Got questions or ran into hiccups during the migration? Drop a comment below or join the #shopify-developers Slack channel—our community is ready to help you make the transition seamless.
