1

This skill automates the process of uploading digital files to Govilo and generating secure, paid unlock links using crypto payments. It supports packaging files, uploading them to Govilo's storage, and managing API interactions seamlessly, making it ideal for content creators and sellers looking to monetize files with minimal manual steps. Users need to provide product details such as title, price, and optional description, with the skill handling the rest of the workflow automatically.

npx skills add https://github.com/hau823823/gen-paylink-govilo --skill 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. See 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.

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:

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

Workflow

  1. Validate config (API Key + seller address)
  2. Package inputs → ZIP (if not already ZIP)
  3. POST /api/v1/bot/uploads/presign → get upload_url + session_id
  4. PUT upload_url → upload ZIP to R2
  5. POST /api/v1/bot/items → get unlock_url

File Limits

  • Max ZIP size: 20 MB
  • Max files in ZIP: 20

Setup

Two values are required: Variable Required Description GOVILO_API_KEY Yes Bot API key from govilo.xyz SELLER_ADDRESS Yes* EVM wallet address on Base chain *SELLER_ADDRESS can also be passed via --address CLI parameter. See references/setup-guide.md for step-by-step registration and wallet setup instructions.

API Reference

See references/bot-api-quick-ref.md for Bot API endpoints and error codes.

GitHub Owner

Owner: hau823823

Files

setup-guide.md

setup-guide.md

bot-api-quick-ref.md

SKILL.md


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. See 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.

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:

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

ParamRequiredSourceDescription
--inputYesCLI (repeatable)ZIP, folder, or file paths
--titleYesCLIProduct title
--priceYesCLIPrice in USDC
--addressNoCLI > SELLER_ADDRESS envSeller EVM wallet
--descriptionNoCLIProduct description

Workflow

  1. Validate config (API Key + seller address)
  2. Package inputs → ZIP (if not already ZIP)
  3. POST /api/v1/bot/uploads/presign → get upload_url + session_id
  4. PUT upload_url → upload ZIP to R2
  5. POST /api/v1/bot/items → get unlock_url

File Limits

  • Max ZIP size: 20 MB
  • Max files in ZIP: 20

Setup

Two values are required:

VariableRequiredDescription
GOVILO_API_KEYYesBot API key from [govilo.xyz][]
SELLER_ADDRESSYes*EVM wallet address on Base chain
[govilo.xyz]: https://govilo.xyz/
*SELLER_ADDRESS can also be passed via --address CLI parameter.
See references/setup-guide.md for step-by-step registration and wallet setup instructions.

API Reference

See references/bot-api-quick-ref.md for Bot API endpoints and error codes.

More skills