Agent Skills

Package axo workflows as reusable skills for skills.sh and OpenClaw-compatible agents.

Skills let agent runners call proven axo flows with better defaults, safer guardrails, and faster onboarding.

axo Skill Source

Official skill files, references, and OpenClaw metadata for axo operations.

skills.sh

Discovery and installation index for agent skills.

Skills CLI

Install, list, and validate skills with npx skills.

OpenClaw Skill Format

Runtime-compatible format for metadata and install requirements.

Info

Need a direct OpenClaw walkthrough? Use Install axo Skill on OpenClaw.

Quick Install

npx skills add https://github.com/zbdpay/axobot-cli --full-depth --skill axo

npx skills add ./axobot-cli/skills/axo

Tip

Use npx skills add <source> --list to verify discovery without installing.

What the Skill Covers

axo init, info, balance
axo receive, send, payments, payment
axo paylink create|get|list|cancel
axo withdraw create|status

axo fetch <url> --max-sats <n>
payment-cap enforcement
token-cache reuse behavior

maps JSON errors to recovery actions
enforces destination and amount validation
documents API key precedence

Skill Layout

skills/axo/
  SKILL.md
  references/
    command-reference.md
    troubleshooting.md

Authoring Notes for High Discovery

Describe triggers clearly

Include natural language triggers users actually type: send sats, withdraw, payment id, L402, paywall.

Document exact JSON contracts

Keep examples machine-readable so agents can parse fields like payment_id, amount_paid_sats, and error.

Keep references close

Place task mappings and troubleshooting in a local references/ folder and link them from SKILL.md.

Include runtime metadata

Add OpenClaw metadata for required binaries and install instructions so runners can self-heal setup.

OpenClaw Metadata Example

metadata:
  openclaw:
    emoji: "⚡"
    requires:
      anyBins:
        - axo
        - npx
    install:
      - id: node-global
        kind: node
        package: "@axobot/cli"
        bins:
        - axo

Publish Checklist

Run package checks in axobot-cli: npm run typecheck && npm run build && npm test
Verify skill discovery: npx skills add <source> --list
Ensure SKILL.md links resolve and references exist
Push to GitHub and validate install from a clean machine/user profile