Swap commerce skill

GenPark skill: Automate agentic commerce, VTO, cross-border pricing, and returns using Swap Commerce.

Install

npx -y skills add alphaparkinc/swap-commerce-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Modular agentic commerce skill for Swap Commerce OS. Automates returns, exchanges, DDP cross-border calculations, visual try-ons, and conversational checkouts.

SKILL.md

5.8 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it

Swap Commerce Agentic Storefront Skill

Overview

Swap Commerce is an e-commerce Operating System (Swap-OS) that consolidates returns, exchanges, international shipping, tax/duty compliance, and logistics into a single, unified pipeline. This skill enables GenPark AI agents to integrate Swap-OS capabilities directly into digital storefronts, transforming standard, static catalogs into highly interactive, conversational shopping and post-purchase experiences.

sequenceDiagram
    autonumber
    actor Customer
    participant Agent as GenPark Agent
    participant Swap as Swap-OS API
    participant WMS as WMS / 3PL

    Customer->>Agent: "I want to exchange my shirt for a larger size"
    Agent->>Swap: POST /v1/returns/exchanges/recommend (order_id, items)
    Swap-->>Agent: Return Exchange Options & Inventory Reservation
    Agent->>Customer: "I reserved the Large shirt. Do you want to swap now?"
    Customer->>Agent: "Yes, proceed with the swap!"
    Agent->>Swap: POST /v1/returns/sessions (create session & labels)
    Swap-->>Agent: Returns Portal Link, QR Code & DDP Shipping Label
    Swap->>WMS: Trigger inbound return notification (ASN)
    Agent->>Customer: "Swap complete! Here is your return shipping label & QR code."

Core Capabilities

1. Branded Returns & Revenue Retention

Instant Returns Portal: Set up fully branded self-service returns portals matching the merchant’s storefront design.
Revenue Retention (Shop Now): Provide interactive cross-sell and instant exchange suggestions when a return is initiated. Retain up to 12%+ of revenue before refunds are issued.
Flexible Refund Options: Automate issuing refunds to original payment methods, store gift cards, or shopping wallet balances.

2. International Commerce & Cross-Border DDP

Landed Cost Engine: Compute real-time duties, local taxes (VAT/GST), and total landed cost dynamically during checkout.
DDP (Delivered Duty Paid) Shipping: Eliminate surprise customs fees for international buyers by collecting duties upfront and preparing compliant custom paperwork.
Regional Consolidation: Consolidate international returns at regional hubs before bulk shipping back to the primary WMS to save logistics costs.
Product Compliance: Automatically map HS (Harmonized System) codes and verify Country of Origin (COO) for cross-border compliance (e.g., EU GPSR requirements).

3. Conversational Discovery & Try-On

Virtual Try-On (VTO): Give shoppers visual confidence by matching product specs to personal models or avatars.
Sizing & Fit Recommendation: Utilize purchase history and return records across the network to suggest the optimal size, lowering return rates.

4. Direct In-Flow Conversational Checkout

Chat/Voice Sales: Enable frictionless transaction processing directly within the agent chat interface without traditional web checkout redirects.
Payment Orchestration: Support tokenized, safe payments, one-click checkouts, and express digital wallet checkouts (Apple Pay, Google Pay).

API Reference & Payloads

1. Create Return/Exchange Session

POST https://api.swap-commerce.com/v1/returns/sessions

Request Headers:

Authorization: Bearer <your_swap_api_key>
Content-Type: application/json

Request Payload:

{
  "order_id": "ord_8941278930",
  "customer": {
    "email": "[email protected]",
    "country_code": "US"
  },
  "items": [
    {
      "sku": "TSHIRT-BLU-M",
      "quantity": 1,
      "reason": "SIZE_TOO_SMALL",
      "action": "EXCHANGE",
      "exchange_sku": "TSHIRT-BLU-L"
    }
  ],
  "shipping": {
    "carrier": "USPS",
    "method": "GROUND_RETURN"
  }
}

Response Payload:

{
  "return_session_id": "ret_sess_77812930",
  "status": "APPROVED",
  "exchange_order_id": "ord_ex_990184712",
  "label_url": "https://shipping.swap-commerce.com/labels/lbl_9981a3d9f.pdf",
  "qr_code_url": "https://shipping.swap-commerce.com/qrcodes/qr_9981a3d9f.png",
  "estimated_delivery": "2026-05-22T18:00:00Z"
}

2. Calculate Landed Cost (Cross-Border Duties)

POST https://api.swap-commerce.com/v1/cross-border/landed-cost