LeoYeAI/agent-master-skills / skills/agentic-commerce-forthecult
agentic-commerce-forthecult
VerifiedAgentic Commerce skills enables agents to autonomously browse and search for quality lifestyle, wellness, and tech products and gifts, view details, create orders with multi-chain payments (Solana, Ethereum, Base, Polygon, Arbitrum, Bitcoin, Dogecoin, Monero), apply CULT token-holder discounts, and track orders from payment to delivery. Use when a user wants to buy products for humans and AI, browse a store, find gifts, place an order, or track a shipment.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.2 KB |
| _meta.json | config | 331 B |
| references/API.md | markdown | 15.5 KB |
| references/CHECKOUT-FIELDS.md | markdown | 5.2 KB |
| references/ERRORS.md | markdown | 6.8 KB |
references/CHECKOUT-FIELDS.md
View on GitHub# Checkout Request Body — POST `/checkout`
Complete field specification for creating an order. This is the core Agentic Commerce endpoint — where an agent converts product discovery into a real purchase.
---
## Top-level fields
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `items` | array | **Yes** | Line items to purchase |
| `email` | string | **Yes** | Customer email for order confirmation |
| `payment` | object | **Yes** | Cryptocurrency, credit, or debit card for payment |
| `shipping` | object | **Yes** | Delivery address |
| `walletAddress` | string | No | Customer wallet for CULT token-holder discount |
---
## `items[]`
An array of one or more products to order.
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `productId` | string | **Yes** | Product `id` from `GET /products/search` or `GET /products/{slug}`. **Never use placeholder or example IDs.** |
| `variantId` | string | No | Variant `id` from product detail `variants[]`. Required when the product has size/color variants. |
| `quantity` | integer | **Yes** | Number of units. Minimum: 1. |
**Multi-item example:**
```json
"items": [
{ "productId": "prod_black_hoodie_001", "variantId": "var_hoodie_m_black", "quantity": 1 },
{ "productId": "prod_top_blast_coffee", "quantity": 2 }
]
```
---
## `payment`
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chain` | string | **Yes** | Blockchain network ID |
| `token` | string | **Yes** | Token symbol on that chain |
**Supported values** (verify with `GET /chains` before checkout):
| Chain | Tokens |
|-------|--------|
| `solana` | `SOL`, `USDC`, `USDT`, `CULT` |
| `ethereum` | `ETH`, `USDC`, `USDT` |
| `base` | `ETH`, `USDC` |
| `polygon` | `MATIC`, `USDC` |
| `arbitrum` | `ETH`, `USDC` |
| `bitcoin` | `BTC` |
| `dogecoin` | `DOGE` |
| `monero` | `XMR` |
**Recommendation:** Use `USDC` or `USDT` for stable pricing. Volatile payment methods (SOL, ETH, BTC) are priced at the moment of order creation.
---
## `shipping`
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | **Yes** | Recipient full name |
| `address1` | string | **Yes** | Street address |
| `address2` | string | No | Apartment, suite, unit, etc. |
| `city` | string | **Yes** | City |
| `stateCode` | string | **Yes** | State or region code (e.g. `CA`, `NY`, `ON`) |
| `zip` | string | **Yes** | Postal / ZIP code |
| `countryCode` | string | **Yes** | 2-letter ISO 3166-1 alpha-2 code (e.g. `US`, `CA`, `GB`) |
**Important field names:** Use `address1` (not `line1`), `stateCode` (not `state`), `zip` (not `postalCode`), `countryCode` (not `country`). Using incorrect field names will result in a validation error.
---
## `walletAddress` (optional)
A blockchain wallet address (any supported chain). If provided, the API checks on-chain CULT token balance and automatically applies the highest eligible discount tier.
The response `discount` object shows the applied tier, percentage, and amount saved.
---
## Complete single-item example
```json
{
"items": [
{ "productId": "prod_top_blast_coffee", "quantity": 1 }
],
"email": "customer@example.com",
"payment": { "chain": "solana", "token": "USDC" },
"shipping": {
"name": "Satoshi Nakamoto",
"address1": "123 Main St",
"city": "San Francisco",
"stateCode": "CA",
"zip": "94102",
"countryCode": "US"
}
}
```
## Complete multi-item example with wallet discount
```json
{
"items": [
{ "productId": "prod_black_hoodie_001", "variantId": "var_hoodie_l_black", "quantity": 1 },
{ "productId": "prod_top_blast_coffee", "quantity": 3 }
],
"email": "holder@example.com",
"payment": { "chain": "ethereum", "token": "USDC" },
"shipping": {
"name": "Ada Lovelace",
"address1": "456 Oak Avenue",
"address2": "Suite 200",
"city": "Los Angeles",
"stateCode": "CA",
"zip": "90001",
"countryCode": "US"
},
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
```
---
## Checkout response
```json
{
"orderId": "order_abc123xyz",
"payment": {
"chain": "solana",
"token": "USDC",
"address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"amount": "29.99",
"reference": "FortheCult_order_abc123xyz",
"qrCode": "data:image/png;base64,iVBOR..."
},
"discount": null,
"expiresAt": "2026-02-10T15:00:00Z",
"statusUrl": "/api/orders/order_abc123xyz/status",
"_actions": {
"next": "Send 29.99 USDC to the payment address within 15 minutes",
"cancel": "/api/orders/order_abc123xyz/cancel",
"status": "/api/orders/order_abc123xyz/status"
}
}
```
**After creating an order:**
1. Tell the user to send exactly `payment.amount` of `payment.token` to `payment.address` on `payment.chain`.
2. Display the QR code (`payment.qrCode`) if the client supports images.
3. Warn that the payment window expires at `expiresAt` (~15 minutes).
4. Begin polling `GET /orders/{orderId}/status` — every 5 seconds while `awaiting_payment`.
5. If the order expires, inform the user and offer to create a new order.
**Never use placeholder product IDs.** Always obtain `productId` from a prior `GET /products/search` or `GET /products/{slug}` response.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |