# GitHub Repository: zincio/skills
**URL:** https://github.com/zincio/skills
**Author:** zincio
**Description:** AI agent skill for the Zinc API. Search, buy, track, and return across Amazon, Walmart, Target, and 50+ US retailers. Buy anything with a URL.
**Homepage:** https://www.zinc.com/docs/v2/agent-skills/overview
**Language:** Python
## Stats
- Stars: 7
- Forks: 0
- Open Issues: 1
- Commits: 35
- Created: 2026-02-11T19:44:35Z
- Updated: 2026-09-01T15:57:06Z
- Pushed: 2026-09-01T15:20:56Z
## README
# Zinc Skills: Universal Checkout for AI Agents
[Agent Skills](https://agentskills.io) for **buying products and managing orders** through the [Zinc API](https://zinc.com) — programmatic checkout across Amazon, Walmart, Target, Best Buy, eBay, and 50+ other retailers with a single API.
This repo ships the **`universal-checkout`** skill (every retailer, full order lifecycle) plus **per-retailer skills** for the retailers people search for by name. Install the universal one for general use; install a retailer-specific one when you only buy from a single store.
## Skills
<!-- SKILLS-TABLE:START (generated by tools/generate_skills.py — do not edit by hand) -->
| Skill | Buys from | Install |
|-------|-----------|---------|
| [`universal-checkout`](skills/universal-checkout/SKILL.md) | **Universal** — all supported retailers | `npx skills add zincio/skills --skill universal-checkout` |
| [`1800flowers-checkout`](skills/1800flowers-checkout/SKILL.md) | 1-800-Flowers | `npx skills add zincio/skills --skill 1800flowers-checkout` |
| [`acehardware-checkout`](skills/acehardware-checkout/SKILL.md) | Ace Hardware | `npx skills add zincio/skills --skill acehardware-checkout` |
| [`amazon-checkout`](skills/amazon-checkout/SKILL.md) | Amazon | `npx skills add zincio/skills --skill amazon-checkout` |
| [`bestbuy-checkout`](skills/bestbuy-checkout/SKILL.md) | Best Buy | `npx skills add zincio/skills --skill bestbuy-checkout` |
| [`ebay-checkout`](skills/ebay-checkout/SKILL.md) | eBay | `npx skills add zincio/skills --skill ebay-checkout` |
| [`homedepot-checkout`](skills/homedepot-checkout/SKILL.md) | The Home Depot | `npx skills add zincio/skills --skill homedepot-checkout` |
| [`lowes-checkout`](skills/lowes-checkout/SKILL.md) | Lowe's | `npx skills add zincio/skills --skill lowes-checkout` |
| [`pokemoncenter-checkout`](skills/pokemoncenter-checkout/SKILL.md) | Pokémon Center | `npx skills add zincio/skills --skill pokemoncenter-checkout` |
| [`target-checkout`](skills/target-checkout/SKILL.md) | Target | `npx skills add zincio/skills --skill target-checkout` |
| [`walmart-checkout`](skills/walmart-checkout/SKILL.md) | Walmart | `npx skills add zincio/skills --skill walmart-checkout` |
| [`wayfair-checkout`](skills/wayfair-checkout/SKILL.md) | Wayfair | `npx skills add zincio/skills --skill wayfair-checkout` |
<!-- SKILLS-TABLE:END -->
> **Which should I install?** The per-retailer skills are the same full lifecycle (order → track → manage) retargeted for one store — handy when an agent only ever buys from, say, Amazon, and for discovery. If you buy across multiple retailers, install **`universal-checkout`** instead of stacking several near-identical retailer skills (overlapping descriptions can make skill triggering ambiguous).
>
> Live supported-retailer list: `GET https://api.zinc.com/retailers`.
## Task skills
Hand-maintained skills for a specific *task* rather than a retailer. They place orders through the Zinc API and pay per order with a Stripe Link card via the [`create-payment-credential`](https://skills.sh/stripe/link-cli) skill — no Zinc API key needed.
| Skill | Task | Install |
|-------|------|---------|
| [`send-donuts`](skills/send-donuts/SKILL.md) | Send Krispy Kreme donuts to anyone by mail, paid with your Stripe Link card | `npx skills add zincio/skills --skill send-donuts` |
| [`send-doughnuts`](skills/send-doughnuts/SKILL.md) | Alias of `send-donuts` (identical instructions, alternate spelling) | `npx skills add zincio/skills --skill send-doughnuts` |
## What these skills do
Full US shopping lifecycle — discover → buy → track → return:
- **Discover** — `GET /search` (cross-retailer, returns orderable URLs); `GET /products/search` + `GET /products/{id}/offers` for best-price comparison (Amazon & Walmart). On the MPP rail (no account), the same data is available via the metered `/agent/*` endpoints at $0.01/call; `GET /retailers` is free.
- **Place orders** — `POST /orders` (API key) or `POST /agent/orders` (Machine Payments Protocol — pay per request via Stripe cards/wallets or Tempo stablecoins, no account needed), with condition filters, `handling_days_max`, variants, and `is_gift`
- **Track & manage** — `GET /orders`, `GET /orders/{id}` (tracking + price breakdown), `POST /orders/{id}/cancel`
- **Returns** — `POST /returns`, `GET /returns`
- **Error handling** — full code reference in each skill's `references/errors.md`
## Prerequisites
- **API Key auth:** A Zinc API key (sign up at [app.zinc.com](https://app.zinc.com)). Set `ZINC_API_KEY`.
- **MPP auth:** No Zinc account needed — pay per request via Tempo stablecoins (set `TEMPO_PRIVATE_KEY`) or Stripe (cards/wallets via Stripe Link). Try it without code at [agent.zinc.com](https://agent.zinc.com).
## Installation
These are [Agent Skills](https://agentskills.io) — folders containing a `SKILL.md` with metadata and instructions that any compatible agent (Claude Code, Cursor, Gemini CLI, VS Code, GitHub Copilot, and [many others](https://agentskills.io/home)) can discover and use.
```bash
# Universal skill (recommended for most users)
npx skills add zincio/skills --skill universal-checkout
# A single retailer
npx skills add zincio/skills --skill amazon-checkout
# List everything in this repo
npx skills add zincio/skills --list
```
Or clone and point your agent at the `skills/` directory:
```bash
git clone https://github.com/zincio/skills.git
```
Skills use progressive disclosure — at startup only `name` and `description` load; full instructions are read into context only when a matching task is detected.
### OpenClaw
[OpenClaw](https://docs.openclaw.ai) loads skills from the workspace (`<workspace>/skills/`), user (`~/.openclaw/skills/`), and bundled locations. OpenClaw hot-reloads skills when `SKILL.md` changes — no restart needed.
## Repo layout & maintenance
```
├── references/errors.md # shared error reference (single source)
├── skills/
│ ├── universal-checkout/ # the universal skill — all retailers (hand-maintained)
│ │ ├── SKILL.md
│ │ └── references/errors.md
│ └── <retailer>-checkout/ # per-retailer skill (generated, self-contained)
│ ├── SKILL.md
│ └── references/errors.md
└── tools/
├── generate_skills.py # generates every skills/<retailer>-checkout/ folder
└── retailers.json # committed snapshot of GET /retailers (the catalog)
```
**The per-retailer skills — and the skills table above — are generated, not hand-edited.** The retailer catalog (which retailers exist, display name, base URL, free-shipping terms) comes from the live `GET https://api.zinc.com/retailers` endpoint — the single source of truth — captured in `tools/retailers.json`. The only things not in the endpoint are an example product URL (derived from the domain) and which retailers have `/products/search` (one constant in the generator); retailer-specific order constraints aren't encoded — the order API reports them at request time.
```bash
python3 tools/generate_skills.py # regenerate from the committed snapshot
python3 tools/generate_skills.py --refresh # re-fetch /retailers, update the snapshot, regenerate
```
**Adding a retailer is zero code:** once it's `supported` in `/retailers`, run `--refresh` and it produces a complete skill (and a new table row). This also refreshes every skill's `references/errors.md` from the single source at `references/errors.md`. The `universal-checkout` SKILL.md is hand-maintained.
## Documentation
- [`universal-checkout` SKILL.md](skills/universal-checkout/SKILL.md) — endpoints, auth, examples, safety
- [references/errors.md](references/errors.md) — HTTP status codes, API error codes, order processing error types
- [Zinc API docs](https://www.zinc.com/docs) — full API reference
## Support
- Email: [[email protected]](mailto:[email protected])
- Book a call with our CEO: [cal.com/zinc-ian/15min](https://cal.com/zinc-ian/15min)
- Discord: [discord.gg/cuXgfczYfj](https://discord.gg/cuXgfczYfj)
