Use Shopify Dev in Claude Code to Route a Cross-Surface Documentation Question
Find Shopify developer documentation when a question spans APIs or lacks a clear starting point. Test whether the agent routes theme and checkout work to their distinct guides.
中文Setup for Claude Code
Use the pinned legacy Shopify Toolkit 1.9.1 skill in a practice project. The documentation helper needs Node.js and network access for actual Shopify documentation search. The exercise supplies an explicit routing rubric and uses fictional requirements. Shopify's refreshed toolkit uses the combined shopify skill for developer API surfaces. The pinned skill's documentation and validation helpers can report usage and validation context to Shopify, and their notice documents OPT_OUT_INSTRUMENTATION=true. Use only sample inputs.
- Open Shopify's pinned source below and copy the complete skills/shopify-dev directory into .claude/skills/shopify-dev in a disposable project, keeping the included scripts and references.
- Open the project in the selected client and load /shopify-dev. Follow the pinned skill's tool preflight for the requested task.
Example task
Ask /shopify-dev to find the right starting documents for two parts of a fictional store feature: a promo message on a storefront product page and an information block during checkout. Ask it to return authoritative Shopify links and identify each surface before creating any files.Expected result
The response routes the storefront work to Liquid theme or storefront guidance and the checkout block to Checkout UI Extensions. It explains which specialized guidance it would open for each and includes Shopify documentation URLs.
Upstream documentation
Original SKILL.md on GitHub · MIT license · Source reviewed
Frequently asked question
When should I start with the general Shopify Dev skill?
Use it for broad, ambiguous or cross-surface documentation discovery. When you can identify a single Shopify API or surface, begin with that surface's guidance.