shop

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill shop-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shop
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/productivity/shop
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill shop-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Shopping through an AI assistant requires catalog search, secure checkout, order tracking, and returns handling across many merchants, which is tedious to do manually and risky to do without strict payment and security rules. ## Core Features & Use Cases - Catalog Search: Free-text, similar-item, and image-based product search across the Shopify global catalog with filters for price, shipping destination, color, size, and condition. - Agent Checkout: Create, update, and complete checkouts on merchant domains with delegated spending budgets, idempotency keys, and mandatory purchase confirmation. - Orders & Returns: Search recent orders, track shipments, check return windows, and reorder past purchases after sign-in. - Use Case: A user asks for trail running shoes under $150 shipped to the UK; the assistant offers sign-in, searches the catalog with localized GBP prices, presents one message per product, and completes checkout only after explicit confirmation. ## Quick Start Ask the assistant to search Shop for a product you want, for example: find me black crewneck sweaters under $80 that ship 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 with the shop CLI?▼

Use shop search with a free-text query plus filters like --ships-to, --min/--max-price, --color, --size, and --condition. You can also find similar items with --like-id or run a visual search with --image pointing to a local photo.

How does checkout work in a conversational shopping agent?▼

Checkout uses shop checkout create with a variant ID and shop domain, then shop checkout complete with --confirm after the user explicitly approves item, price, shipping, and total. Stores without Shop Pay return a continue_url link to finish in Shop.

Can I track orders and process returns without signing in?▼

No, order features require sign-in via shop auth device-code and shop auth poll. Once authenticated, shop orders search supports recent, tracking, order_info, returns, and reorder query types.

What is a delegated spending budget in Shop?▼

A delegated budget lets the assistant complete checkouts without per-purchase approval, configured in Shop Settings under Connections. The remaining balance is checked with shop auth budget, and amounts are reported in minor currency units.

What products are prohibited from purchase through this skill?▼

Prohibited items include alcohol, tobacco, cannabis, medications, weapons, explosives, hazardous materials, adult content, counterfeit goods, and hate or violence content. These are silently filtered from results, and direct requests are declined with alternatives suggested.

What if the shop CLI cannot be installed?▼

The reference files document direct API equivalents: catalog-mcp.md covers Shopify Global Catalog MCP search calls, and direct-api.md covers device authorization, token exchange, checkout, and orders endpoints over HTTPS.