Installing Skills

All AIOT skills use the same invocation:

npx skills add <repo>/<skill>

For example, to install x402-pay from this repository:

$npx skills add aiot-network/aiot-x402-sdk/x402-pay

Executable skill that lets an AI agent pay for x402-gated HTTP endpoints autonomously. (v0.1.0)

The skills CLI is a thin wrapper that clones or fetches the skill directory and writes it to your agent’s configuration directory. One command, every platform.

Platform matrix

Each agent platform stores skills in a different directory. The skills CLI detects which platforms are installed on your machine and writes to all of them by default.

Platform	Install directory
Claude Code	`~/.claude/skills/`
Codex	`~/.agents/skills/`
Cursor	`~/.cursor/skills/`
Gemini CLI	`~/.gemini/skills/`
OpenCode	`~/.config/opencode/skills/`

To target a single platform, pass --platform:

npx skills add aiot-network/aiot-x402-sdk/x402-pay --platform claude-code

Verify installation

After install, verify the skill is registered:

skills list

You should see x402-pay in the output, with its version and install path. If the list is empty, your shell may not be finding the CLI — confirm ~/.npm/bin (or equivalent for your package manager) is on $PATH.

Alternatively, each agent’s own command-listing UI will show the slash command once the skill is registered — in Claude Code, open the slash-command menu and look for /x402-pay.

Invoking a skill

Skills are invoked with a slash command matching the skill name:

/x402-pay https://api.example.com/paywalled-endpoint

All positional arguments after the slash command are passed to the skill as its input. Flags like --max-amount 25 are passed through as-is.

Tip

In Claude Code, typing / shows all available slash commands including installed skills. This is the fastest way to discover what’s installed without leaving your agent session.

Upgrading a skill

npx skills upgrade aiot-network/aiot-x402-sdk/x402-pay

The CLI fetches the latest skill.json and compares versions. If an upgrade is available, it re-installs the skill in place.

For automatic upgrades on every session, add this to your agent’s startup hook:

npx skills upgrade --all --quiet

Uninstalling

npx skills remove aiot-network/aiot-x402-sdk/x402-pay

Removes the skill from every platform directory it was installed to. Idempotent — safe to run even if the skill was only partially installed.

Environment variables

Some skills require env vars to be set before they’ll run. x402-pay requires:

AIOT_AGENT_WALLET_KEY — private key of the wallet the agent will pay from

See each individual skill’s reference page for its full env var requirements.

Danger

Never paste a mainnet private key into your shell history or a commit. Use a dedicated agent wallet with a small USDC balance, and prefer environment-variable managers (1Password CLI, direnv, Doppler) over plain-text exports when possible.

Overview x402-pay