shop

Search the Shop catalog, build checkouts, and track orders via the shop CLI.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill shop-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shop
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/productivity/shop
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill shop-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @shopify/shop-cli, and includes references (resource) components.

What problem does it solve? Shopping through a chat agent requires juggling product search, sign-in, checkout, and order tracking across many merchants; this Skill gives the agent a single CLI and API workflow to do all of it safely on the Shop platform. ## Core Features & Use Cases - Catalog Search: Run free-text, similar-item (--like-id), and image-based (--image) searches against the Shopify global catalog with filters for price, shipping destination, condition, color, size, and gender. - Checkout & Delegated Budget: Create and complete checkouts on merchant domains via the UCP agent flow, with support for Shop Pay delegated spending budgets and mandatory purchase confirmation. - Orders & Returns: Search recent orders, track shipments, check return windows, and reorder past items after sign-in. - Use Case: A user asks for trail running shoes under $150 shipped to the UK; the agent offers sign-in, searches with localized GBP pricing, presents one product per message, and completes checkout only after explicit confirmation. ## Quick Start Ask the agent to search Shop for a product you want, for example: find me a black crewneck sweater in size M that ships to the US.

Frequently Asked Questions about shop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for products on Shop from an AI agent?▼

Use the shop CLI's `shop search` command with a free-text query, or pass `--like-id` for similar items and `--image` for visual search. Add filters like `--ships-to`, `--min/--max-price`, `--color`, and `--size` to narrow results.

How does checkout work with the shop CLI?▼

Create a checkout with `shop checkout create` using a variant ID and shop domain, then complete it with `shop checkout complete --confirm` after the user explicitly confirms item, price, and shipping. Without a saved payment instrument, present the Finish in Shop link instead.

Can I track orders and process returns with this skill?▼

Yes, after sign-in use `shop orders search` with types recent, tracking, order_info, returns, or reorder. For returns, compare the order date against the merchant's return window before advising the user.

What if the shop CLI cannot be installed?▼

The reference files mirror every CLI call through direct APIs: catalog-mcp.md covers Shopify Global Catalog MCP search, and direct-api.md covers device authorization, checkout token exchange, and order search endpoints.

What are the limitations of the Shop agent skill?▼

It is for individual personal use only; commercial aggregation or resale is prohibited. It cannot sell restricted items like alcohol or weapons, cannot guarantee product quality, and never falls back to browser checkout on agent-flow errors.