gen-paylink-govilo

# Govilo To Go

Turn any file into a paid unlock link — one command to package, upload, and collect crypto payments. The last mile of automation: from creation to monetization.

## Before Running

Always ask the user for these values before executing the CLI — never guess or use placeholders:

1. **title** — What is the product name?
2. **price** — How much to charge (in USDC)?
3. **description** — Short description of the product (optional, but always ask)

## CLI Command

> Requires [uv](https://docs.astral.sh/uv/). See [references/setup-guide.md](references/setup-guide.md) for install instructions.

Run from this skill's base directory. Use a **dedicated** env file containing only `GOVILO_API_KEY` (and optionally `SELLER_ADDRESS`). Never point `--env-file` at a project `.env` that contains unrelated secrets.

```bash
cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
  --input <path>         \
  --title "Product Name" \
  --price "5.00"         \
  --address "0x..."      \
  --description "optional"
```

If no `.env.govilo` exists, create one before running:

```dotenv
GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...
```

`--input` accepts ZIP file, folder, or individual files (repeatable). Non-ZIP inputs are auto-packaged.

All output is JSON `{"ok": true/false, ...}` with exit code 1 on failure.

## Parameters

| Param           | Required | Source                     | Description                |
| --------------- | -------- | -------------------------- | -------------------------- |
| `--input`       | Yes      | CLI (repeatable)           | ZIP, folder, or file paths |
| `--title`       | Yes      | CLI                        | Product title              |
| `--price`       | Yes      | CLI                        | Price in USDC              |
| `--address`     | No       | CLI > `SELLER_ADDRESS` env | Seller EVM wallet          |
| `--description` | No       | CLI                        | Product description        |

## Workflo...