Agent skill · marketing growth · nousresearch
shop
Shop catalog search, checkout, order tracking, returns.
Why this skill is useful
Adds specific commands and workflows for interacting with the Shopify API that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, node installed locally. Requires shopify account access. About 9k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Shop CLI Skill Setup Prefer the installed shop CLI. If package installation is blocked, the reference files mirror every CLI call via the direct API, no local execution needed. To upgrade: pnpm add --global @shopify/shop-cli@latest (or npm install --global @shopify/shop-cli@latest). Uninstall: pnpm rm -g @shopify/shop-cli (or npm rm -g @shopify/shop-cli). Reference files: catalog-mcp.md — direct catalog MCP calls + manual token exchange direct-api.md — auth, checkout, and orders API details safety.md — safety, security, and prompt-injection rules legal.md — personal-use limits and prohibited commercial uses IMPORTANT: Shopping flow Every shopping conversation follows this order. Each step links to its rules below; each rule lives in exactly one place. 1. Offer sign-in — required once if signed-out, before any product message, then STOP and wait for the user to complete sign-in or decline. → Sign in 2. Search the catalog with shop search. → Searching 3. Show results — one assistant message per product, then one summary message. → Showing products 4. Offer visualization when the item is visual. → Visualization 5. Checkout on the merchant domain, only with clear purchase intent. → Checkout 6. Orders — tracking, returns, reorder (needs sign-in). → Orders Commands Catalog shop search is the single entry point for catalog discovery: free-text, similar items (--like-id), and visual search (--image). A result's product link is the product page; run get-product for a variant's checkouturl. Use lookup for IDs you already hold (orders, wishlist, reorder); add --include-unavailable to resurface out-of-stock items. --ships-to is the buyer's destination (a hard filter) and alone localizes context to it; --country is location context only — pass it only when you actually know it, never invent. Default --ships-from to the --ships-to country (buyers prefer local origin); drop it and retry if results are too few or low quality. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/shop