bskills

Command-line tool for the BuySkills.ai marketplace. Log in with GitHub, search skills, acquire free ones, pay for premium ones via the direct-USDC-split Solana rail, install them to any of your local AI agents (Claude Code, Cursor, Windsurf, ...) and check which ones you have installed.

Install

npm install -g bskills
# or run ad-hoc
npx bskills --help

The package installs three equivalent commands for the same CLI: bskills, buyskills, and bskills-cli. The examples below use bskills.

Quick start

bskills init        # log in, acquire the free BuySkills skill, install it everywhere

init bootstraps everything in one shot: it ensures you're logged in, acquires the free BuySkills marketplace skill, and installs it to every detected AI agent.

Commands

bskills init [--slug <slug>] [--agent <id>]... [--scope global|project]
             [--mode copy|symlink] [--timeout <seconds>] [--json]

bskills login [--timeout <seconds>]
bskills logout
bskills whoami

bskills search [query] [--type skill|plugin] [--category <c>] [--sort newest|trending]
               [--min-price <cents>] [--max-price <cents>] [--featured]
               [--page <n>] [--limit <n>] [--json]

bskills acquire <plugin-id-or-slug> [--json]

bskills pay <skill-id> --wallet <solana-pubkey>     [--json]   # initiate
bskills pay <skill-id> --signature-hex <hex>        [--json]   # settle

bskills install <slug> [--agent <id>]... [--scope global|project]
                       [--mode copy|symlink] [--force] [--json]

bskills update <slug> [--agent <id>]... [--scope global|project] [--json]    # alias: upgrade

bskills uninstall <slug> [--agent <id>]... [--scope global|project] [--json] # alias: remove

bskills installed [--agent <id>] [--scope global|project] [--remote] [--json]

bskills agents [--installed] [--json]

bskills config [list|get|set] [key] [value]

bskills doctor [--wallet <name>] [--json]    # check the env is ready to pay (auth, ows, wallet)
bskills self-update [--json]                 # update the CLI to the latest published version

All commands accept --json for machine-readable output.

The CLI always targets production (https://api.buyskills.ai / https://app.buyskills.ai). There is no user-facing environment switch.

Paying for a skill

pay uses the direct-USDC-split Solana rail and is a two-phase flow. Signing happens in the separate ows CLI — bskills never holds keys. Run bskills doctor first to confirm auth, ows, and a funded Solana wallet are in place.

1. Initiate — bskills pay <slug> --wallet <pubkey> returns the unsigned transaction in hex.
2. Sign — ows sign tx --chain solana --wallet <name> --tx <hex> returns the signature.
3. Settle — bskills pay <slug> --signature-hex <hex> splices the signature in; the backend broadcasts, confirms, and grants access.

Configuration

State is stored in ~/.bskills-cli/:

• config.json — access token, user profile, preferences
• state.json — local installation records

Cache: ~/.cache/bskills-cli/repos/.

Writable preferences:

• defaultScope — global | project
• defaultInstallMode — copy | symlink