Agent Skills
An Agent Skill is a capability package that teaches an AI agent how to do a job: when to do it, which commands to run, and how to involve the user. FluxA publishes its wallet as a skill. Once it's installed, an agent running in Claude Code, OpenClaw or any other skill-compatible runtime can pay, get paid and use paid tools within limits the user approves.
Skills load on demand. The agent reads the short main SKILL.md first and opens a sub-guide (for example the payout or payment link guide) only when the task needs it, which keeps context usage small.
Recommended path: Skill + CLI
For most agents, the fluxa-agent-wallet skill plus the FluxA Wallet CLI (@fluxa-pay/fluxa-wallet) is the recommended way to use FluxA. The skill tells the agent what to do and the CLI does it. Every command prints JSON, so the agent never handles private keys or payment signing code.
Other integration surfaces:
| Surface | Use it when | Coverage |
|---|---|---|
| Skill + CLI (recommended) | Your agent can run shell commands | Everything: x402, payouts, payment links, refunds, agent cards, AgentMarket, Agent VC, scheduled tasks |
| MCP Server | Your client only supports MCP tools, not shell commands | A subset of the CLI: Agent ID, mandates, x402, payouts, payment links. See MCP tools |
| HTTP API | You're building a backend or a custom agent runtime | Raw REST endpoints |
Available skills
| Skill | Status | What it does |
|---|---|---|
| fluxa-agent-wallet | Stable | The FluxA Agent Wallet: x402 payments, payouts, agent-to-agent transfers, payment links, refunds, agent cards, AgentMarket, Agent VC, token management |
| agentic-checkout | Beta | Browser checkout automation for online stores, with a clean handoff to a human when a CAPTCHA, OTP or 3DS step appears |
INFO
The former fluxa-agent-wallet-via-api skill has been retired. Agents that call FluxA over HTTP should follow the API Guide, and agents that can run shell commands should use the fluxa-agent-wallet skill.
Install
The quickest way is to tell your agent:
Read and install https://fluxapay.xyz/skill.mdOr install the skill yourself with the skills installer:
npx skills add -s fluxa-agent-wallet -y -g FluxA-Agent-Payment/FluxA-AI-Wallet-MCPAfter installing, the agent runs the skill's Setup section: it installs the CLI, registers an Agent ID and asks you to link it to your wallet. See fluxa-agent-wallet for details.