Developers

The skillpub CLI

Every command, with flags and examples.

# install via npm
$ npm install -g skillpub

# or run directly
$ npx skillpub --help

skillpub init

Initialize a new skill project

Scaffolds a new skill directory with a SKILL.md template, metadata file, and recommended structure.

$ skillpub init my-skill
  Created my-skill/
    SKILL.md
    skillpub.json
    README.md
  Ready to edit. Run skillpub publish when done.

skillpub publish <path>

Sign and publish a skill to relays

Signs the skill bundle with your Nostr key, uploads assets to Blossom, and publishes the skill event to configured relays.

--price <sats> Set price in sats (default: free)
--relay <url> Publish to a specific relay
--dry-run Validate without publishing
$ skillpub publish ./flight-search --price 500
  Skill: flight-search v2.1.0
  Signing with nsec... ✓
  Uploading to Blossom... ✓
  Publishing to relay.skillpub.net... ✓
  Live at: skillpub.net/s/flight-search
Discovery & install

skillpub install <name>

Install a skill (pay if required)

Downloads, verifies, and installs a skill. Handles Cashu payment automatically if the skill has a price. Verifies SHA-256 hash and publisher signature before installing.

--version <ver> Install a specific version
--force Reinstall even if already installed
--verify-only Verify without installing
$ skillpub install web-scraper-pro
  Found: web-scraper-pro v1.3.0 by npub1ab2...c3d4
  Price: 200 sats · Paying via Cashu... ✓
  Verifying signature... ✓
  Verifying SHA-256 hash... ✓
  Installed to ~/.openclaw/skills/web-scraper-pro/

skillpub list

List installed skills

Shows all locally installed skills with version, publisher, and install path.

skillpub update [name]

Update installed skills

Checks for newer versions and updates. Omit name to update all. Verifies signatures and hashes on every update.

Account

skillpub earnings

View your earnings

Shows your sales, revenue, and ratings across all published skills.

$ skillpub earnings
  This week: 47,200 sats (312 sales)
  All time: 312,800 sats (2,041 sales)
  Rating: 4.8/5 (38 reviews from WoT)

skillpub whoami

Show your npub and profile

Displays your Nostr public key, published skills count, and earnings summary.

Trust

skillpub verify <name>

Verify a skill's signature and hash

Checks the cryptographic signature against the publisher's npub and verifies the bundle hash. Returns attestation details from your web-of-trust.

skillpub attest <name>

Sign an attestation for a skill

Publishes a signed attestation (review or audit) for a skill. Your npub is staked on the attestation — visible in the publisher's and installer's web-of-trust.

--type <review|audit> Attestation type
--rating <1-5> Rating (for reviews)
--comment <text> Attestation comment
Configuration

skillpub config <key> <value>

Manage CLI configuration

Set relays, Blossom servers, default WoT thresholds, and Cashu mint URLs. Skills install to ~/.openclaw/skills/ by default — OpenClaw is the agent runtime that reads them.

relays Comma-separated relay URLs
blossom Blossom server URLs
mint Cashu mint URL
wot-threshold Default minimum WoT score (0–100)
install-path Skill install directory (default: ~/.openclaw/skills/)

Skill format

A skill is a SKILL.md file with optional supporting files. Same format used by OpenClaw, Claude Code, Cursor, Windsurf, and 30+ others.

# skillpub.json
{
  "name": "flight-search",
  "version": "2.1.0",
  "description": "Search and compare flights",
  "price": 500,
  "tags": ["travel", "flights"],
  "files": ["SKILL.md", "prompts/"]
}

Be first to publish.

Install the CLI, scaffold a skill, push to relays.

Get Early Access