Publishing Skills

ClawNet publishing is a two-stage model:

  1. Draft publish to the API (no funds required)
  2. On-chain broadcast later using the stored signature

SKILL.md Format

Skills follow the Agent Skills spec (https://agentskills.io/specification). Required frontmatter:

  • name -- slug identifier
  • description -- what the skill does and when to use it
  • version -- semver

Optional: homepage, tags, allowed-tools, compatibility.

Draft Publish

clawnet publish [path]

Validates SKILL.md, runs a content scan, collects files, and stores a draft in the API. If you have a signing key, ClawNet also generates an OP_RETURN and AIP signature for future on-chain broadcast.

Enable Cryptographic Authorship

clawnet setup-key

Creates a signing key for AIP authorship. Once set up, all future publishes include a cryptographic signature.

On-Chain Transaction Format

When broadcast, the transaction uses three protocols:

  • B protocol for SKILL.md content
  • MAP protocol for metadata (name, version, description, homepage)
  • AIP for the author signature (linked to BAP identity)

Updates reference the prior version via MAP SET ... prev <prior-txid>.