Skip to content

zincio/universal-checkout-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Universal Checkout Skill

An Agent Skill for placing and managing e-commerce orders through the Zinc API. Enables AI agents to buy products from online retailers, check order statuses, and list recent orders on behalf of users.

Project Structure

├── SKILL.md              # Skill definition (endpoints, auth, workflows)
└── references/
    └── errors.md         # Full error code and status reference

Prerequisites

  • API Key auth: A Zinc API key (sign up at app.zinc.com). Set the ZINC_API_KEY environment variable.
  • MPP auth (Machine Payments Protocol): A funded Tempo wallet key. Set the TEMPO_PRIVATE_KEY environment variable. No Zinc account needed — pay per-order with on-chain crypto.

Installation

This is an Agent Skill — a folder containing a SKILL.md file with metadata and instructions that any compatible agent can discover and use. Agent Skills are supported by Claude Code, Cursor, Gemini CLI, VS Code, GitHub Copilot, and many other agent products.

Clone this repo into your project's skills/ directory:

git clone https://github.com/zinc/universal-checkout-skill.git ./skills/universal-checkout-skill

Compatible agents automatically discover skills in the workspace skills/ folder. Skills use progressive disclosure — at startup only the name and description are loaded, and the full instructions are read into context only when a matching task is detected.

OpenClaw

OpenClaw loads skills from three locations (highest priority first):

  1. Workspace<workspace>/skills/
  2. User~/.openclaw/skills/
  3. Bundled — shipped with the installation

Install via ClawHub:

clawhub install universal-checkout

Or clone manually into either the workspace or user skill directory:

git clone https://github.com/zinc/universal-checkout-skill.git ~/.openclaw/skills/universal-checkout-skill

Additional skill directories can be configured via skills.load.extraDirs.

You can also set the API key through ~/.openclaw/openclaw.json instead of an environment variable:

{
  "skills": {
    "entries": {
      "zinc-orders": {
        "enabled": true,
        "env": { "ZINC_API_KEY": "your-api-key" }
      }
    }
  }
}

OpenClaw hot-reloads skills when SKILL.md changes, so no restart is needed after updates.

Documentation

  • SKILL.md — Full endpoint details, field descriptions, examples, and safety guidelines
  • references/errors.md — HTTP status codes, API error codes, and order processing error types

Support

About

Agent/Claude/OpenClaw skill for Zinc. Buy anything with a URL!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors