Skip to content

TeoSlayer/pilot-skills / skills/pilot-agent-marketplace-setup

pilot-agent-marketplace-setup

Verified

Deploy a decentralized agent marketplace with 4 agents. Use this skill when: 1. User wants to set up an agent capability marketplace 2. User is configuring a directory, matchmaker, escrow, or gateway agent 3. User asks about capability discovery, auctions, or escrow settlement Do NOT use this skill when: - User wants to discover a single agent (use pilot-discover instead) - User wants to run a single auction (use pilot-auction instead)

FileKindSize
README.mdmarkdown4.5 KB
SKILL.mdskill md5.0 KB
# Agent Marketplace Setup

A decentralized marketplace where agents advertise their capabilities, a matchmaker pairs requesters with providers, and transactions are settled through escrow. Reputation scores ensure quality. No central platform takes a cut.

**Difficulty:** Advanced | **Agents:** 4

## Roles

### directory (Capability Directory)
Maintains a registry of agent capabilities. Agents announce what they can do, and the directory makes them discoverable. Tracks reputation scores based on completed transactions.

**Skills:** pilot-momy, pilot-announce-capabilities, pilot-discover, pilot-reputation

### matchmaker (Request Matchmaker)
Receives task requests, queries the directory for capable agents, runs auctions when multiple providers compete, and routes the winning match to escrow.

**Skills:** pilot-matchmaker, pilot-auction, pilot-priority-queue, pilot-audit-log

### escrow (Transaction Escrow)
Holds task payment in escrow until the provider delivers and the requester confirms. Issues receipts and updates reputation scores on completion.

**Skills:** pilot-escrow, pilot-receipt, pilot-audit-log, pilot-webhook-bridge

### gateway (Marketplace Gateway)
Public-facing API gateway. Accepts external requests, load-balances across matchmakers, and serves marketplace health metrics.

**Skills:** pilot-api-gateway, pilot-health, pilot-load-balancer, pilot-metrics

## Data Flow

```
gateway     --> matchmaker : Forwards incoming task requests (port 1002)
matchmaker  --> directory  : Queries for capable providers (port 1002)
matchmaker  --> escrow     : Initiates escrow for matched transactions (port 1002)
escrow      --> directory  : Updates reputation after settlement (port 1002)
```

## Setup

Replace `<your-prefix>` with a unique name for your deployment (e.g. `acme`).

### 1. Install skills on each server

```bash
# On directory node
clawhub install pilot-momy pilot-announce-capabilities pilot-discover pilot-reputation
pilotctl set-hostname <your-prefix>-directory

# On matchmaker node
clawhub install pilot-matchmaker pilot-auction pilot-priority-queue pilot-audit-log
pilotctl set-hostname <your-prefix>-matchmaker

# On escrow node
clawhub install pilot-escrow pilot-receipt pilot-audit-log pilot-webhook-bridge
pilotctl set-hostname <your-prefix>-escrow

# On gateway node
clawhub install pilot-api-gateway pilot-health pilot-load-balancer pilot-metrics
pilotctl set-hostname <your-prefix>-gateway
```

### 2. Establish trust

Agents are private by default. Each pair that communicates must exchange handshakes. When both sides send a handshake, trust is auto-approved -- no manual step needed.

```bash
# gateway <-> matchmaker
# On gateway:
pilotctl handshake <your-prefix>-matchmaker "marketplace"
# On matchmaker:
pilotctl handshake <your-prefix>-gateway "marketplace"

# matchmaker <-> directory
# On matchmaker:
pilotctl handshake <your-prefix>-directory "marketplace"
# On directory:
pilotctl handshake <your-prefix>-matchmaker "marketplace"

# matchmaker <-> escrow
# On matchmaker:
pilotctl handshake <your-prefix>-escrow "marketplace"
# On escrow:
pilotctl handshake <your-prefix>-matchmaker "marketplace"

# escrow <-> directory
# On escrow:
pilotctl handshake <your-prefix>-directory "marketplace"
# On directory:
pilotctl handshake <your-prefix>-escrow "marketplace"

# gateway <-> directory
# On gateway:
pilotctl handshake <your-prefix>-directory "marketplace"
# On directory:
pilotctl handshake <your-prefix>-gateway "marketplace"
```

### 3. Verify

```bash
pilotctl trust
```

## Try It

After setup is complete, run these commands to see data flowing between your agents:

```bash
# On <your-prefix>-gateway — submit a capability request:
pilotctl publish <your-prefix>-matchmaker capability-request '{"requester":"client-a","need":"image-classification","budget":50}'

# On <your-prefix>-matchmaker — query directory and find match:
pilotctl publish <your-prefix>-directory discover-capability '{"capability":"image-classification","min_reputation":4.0}'

# On <your-prefix>-directory — return matching providers:
pilotctl publish <your-prefix>-matchmaker capability-match '{"providers":[{"agent":"img-classifier-1","reputation":4.8,"price":30}]}'

# On <your-prefix>-matchmaker — initiate escrow:
pilotctl publish <your-prefix>-escrow escrow-create '{"requester":"client-a","provider":"img-classifier-1","amount":30,"task":"image-classification"}'

# On <your-prefix>-escrow — settle and update reputation:
pilotctl publish <your-prefix>-directory reputation-update '{"agent":"img-classifier-1","rating":5,"transaction":"TXN-2891"}'
```
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall