skillzmarket

# Skillz Market

Search and call monetized AI skills with automatic cryptocurrency payments via x402.

## Quick Start

List all available skills:
```bash
npx tsx {baseDir}/skillz-cli.ts list
```

Search for skills:
```bash
npx tsx {baseDir}/skillz-cli.ts search "echo"
```

Get skill details:
```bash
npx tsx {baseDir}/skillz-cli.ts info "echo-service"
```

Call a skill (requires SKILLZ_PRIVATE_KEY):
```bash
npx tsx {baseDir}/skillz-cli.ts call "echo-service" '{"message":"hello"}'
```

## Commands

- `list [--verified]` - List all available skills (optionally filter by verified only)
- `search <query>` - Search for skills by keyword
- `info <slug>` - Get skill details by slug
- `call <slug> <json>` - Call a skill with automatic x402 payment
- `direct <url> <json>` - Call any x402-enabled endpoint directly

## Configuration

Your wallet private key is required for x402 payments. Set it in OpenClaw config (`~/.openclaw/openclaw.json`):

```json
{
  "skills": {
    "entries": {
      "skillzmarket": {
        "apiKey": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}
```

> **Note**: OpenClaw uses `apiKey` as the standard config field for skill credentials. This maps to the `SKILLZ_PRIVATE_KEY` environment variable that the skill uses internally.

Alternatively, set the environment variable directly:
```bash
export SKILLZ_PRIVATE_KEY=0x...
```

## Environment Variables

- `SKILLZ_PRIVATE_KEY` - Wallet private key for x402 payments
- `SKILLZ_API_URL` - API endpoint (default: https://api.skillz.market)

# @skillzmarket/openclaw-skill

OpenClaw skill for calling monetized AI skills from the Skillz Market with automatic cryptocurrency payments.

## Installation

### Via ClawHub (recommended)
```bash
clawhub install skillzmarket
```

### Via npx add-skill
```bash
npx add-skill github:skillzmarket/skill
```

### Via openskills
```bash
npx openskills install skillzmarket/skill
```

### Manual installation
```bash
git clone https://github.com/skillzmarket/skill
cp -r skill ~/.openclaw/skills/skillzmarket
cd ~/.openclaw/skills/skillzmarket && npm install
```

## Configuration

Your wallet private key is required for making x402 payments. Choose one of these methods:

### Option 1: OpenClaw Config (Recommended)

Add to `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "skillzmarket": {
        "apiKey": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}
```

> **Why `apiKey`?** OpenClaw uses `apiKey` as the standard config field for skill credentials. It automatically maps to the skill's primary environment variable (`SKILLZ_PRIVATE_KEY`).

### Option 2: Environment Variable

```bash
export SKILLZ_PRIVATE_KEY=0xYOUR_PRIVATE_KEY
```

### Security Notes

- Never commit your private key to version control
- Use a dedicated wallet with limited funds for skill payments
- The private key is used to sign x402 payment transactions on Base (USDC)

## Usage

### Search for skills
```
/skillzmarket search translate
```

### Get skill details
```
/skillzmarket info echo
```

### Call a skill (with automatic payment)
```
/skillzmarket call echo {"message": "hello"}
```

### Call an endpoint directly
```
/skillzmarket direct https://skills.example.com/echo {"message": "hello"}
```

## How it works

1. Skills are registered on the Skillz Market API
2. When you call a skill, the CLI looks up the skill's endpoint and price
3. The x402 payment protocol automatically handles USDC payments on Base
4. You receive the skill's response

## Environment Variables

- `SKILLZ_PRIVAT...