One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill shop-app-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shop-app
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/productivity/shop-app
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill shop-app-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shop.app makes it hard to quickly find products and handle post-purchase tasks like tracking, returns, and re-ordering without jumping between pages and manual steps.

Core Features & Use Cases

  • Product Search & Comparison: Search across stores, filter by price and availability, and find similar items by variant ID or image.
  • Orders, Tracking, Returns: Authenticate once via a device authorization flow, then fetch order details, check delivery status, retrieve tracking info, and manage return eligibility.
  • Reorder Made Easy: Rebuild a checkout URL for eligible past purchases or fall back to a store search when a reorder variant is missing.

Quick Start

Use the shop-app skill to find a product and get a ready-to-open buy link, for example: Find wire-free earbuds under $100 and include in-stock options for the US.

Frequently Asked Questions about shop-app

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

FAQPage Schema
How do I track and manage e-commerce orders on Shop.app?

You can track and manage e-commerce orders on Shop.app by completing a device authorization flow, which then allows you to fetch order details, check delivery tracking, and review return eligibility.

Can I search for products and compare prices across stores?

Yes, you can search for products across stores, filter results by price and availability, and discover similar items by variant ID or image for quick comparison.

How do I reorder a past purchase if the product variant is missing?

To reorder a past purchase, the system rebuilds a checkout URL for eligible items, and automatically falls back to a store search if the specific reorder variant is missing.

Does Shop.app order management require authentication for every action?

Shop.app order management requires a one-time device authorization flow to enable per-user actions, while keeping tokens in-session only without persistent storage.

What is the best way to handle returns and check eligibility for past orders?

The best way to handle returns is using an authenticated device-based operation to retrieve your order details, which then allows you to check the return eligibility status for those purchases.

Are there limitations when finding similar items by variant ID or image?

Finding similar items by variant ID or image is limited to available catalog data, and reordering falls back to a general search if the exact variant is no longer found.