# rozo-intents-skills

Adopt this skill: https://proskills.md/skills/other/rozoai-rozo-intents-skills

Page: https://proskills.md/skills/other/rozoai-rozo-intents-skills
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 5241
upstream: https://github.com/rozoai/rozo-intents-skills/blob/HEAD/SKILL.md

```text
# rozo-intents Skills

Cross-chain crypto payments and bridging via Rozo. Covers wallet detection,
balance checks, QR parsing, payment creation, and status tracking.

## Runtime

All `node scripts/dist/*.js` commands MUST run from the **plugin root**
(directory containing `.claude-plugin/plugin.json`). Use `${CLAUDE_PLUGIN_ROOT}`
when installed as a plugin. If unset, `cd` to the directory that contains
`scripts/dist/`, `skills/`, and `.claude-plugin/`.

**No API keys required.** Rozo APIs are public and rate-limited.

**Data sent to Rozo:** wallet addresses, chain/token choices, amounts,
memos, and payment IDs are transmitted to Rozo's public rate-limited APIs
(`intentapiv4.rozo.ai`, `api-balance.rozo-deeplink.workers.dev`) as part
of normal operation. Anyone who can observe a payment ID can query its
status.

## Critical Rules

These apply across all sub-skills. Never skip them.

- **EVM address without chain → always ask which chain.** Wrong chain = lost funds.
  Do this regardless of amount or confirmation threshold.
- **Stellar memo MUST be included when funding.** The deposit address is shared;
  memo routes the payment to the correct order. Missing memo = lost funds.
- **Amount limits:** $0.01 minimum, $10,000 maximum per transaction.
- **Trust the live API over chain/token support tables.** Always run
  `create-payment.js --dryrun` before telling a user a route is unsupported.
- **Stellar G-wallet: check trustline before proceeding.** Missing trustline =
  funds rejected. Run `check-stellar-trustline.js` first.
- **Do not `sleep` between status polls.** Some harnesses block it. Re-run
  `get-payment.js` immediately if status is still pending.

## Confirmation Thresholds

**Auto-execute is OFF by default.** Both thresholds ship as `0`, so every
payment — any amount — shows full details and waits for an explicit yes/no.
Skipping confirmation for small amounts is strictly opt-in: the user must
themselves raise `freeConfirmThresholdUsd` / `singleConfirmThresholdUsd` in
`version.json`. Never suggest raising them; act on the values found.

Read `version.json` for current values (both default `0` = disabled).

| Amount | Behavior |
|---|---|
| ≤ `freeConfirm` (user-raised) | Silent auto-execute, one-line result only |
| ≤ `singleConfirm` (user-raised) | Narrated auto-execute, no yes/no prompt, **skip dryrun** (fee = $0) |
| everything else (all amounts at the `0` defaults) | Run `--dryrun` for exact fee, full summary + yes/no confirmation |

Chain ambiguity is **never** skipped regardless of amount.

## Skills

| Skill | File | Triggers |
|---|---|---|
| [rozo-intents](skills/rozo-intents/SKILL.md) | skills/rozo-intents/ | Main router — "pay", "send", "transfer", wallet addresses, QR screenshots |
| [send-payment](skills/send-payment/SKILL.md) | skills/send-payment/ | "pay", "send", "transfer", "payout" with amount + destination |
| [check-balance](skills/check-balance/SKILL.md) | skills/check-balance/ | "check balance", "how much do I have", "what's my USDC balance" |
| [payment-status](skills/payment-status/SKILL.md) | skills/payment-status/ | "payment status", "track payment", payment UUID or tx hash |
| [parse-qr](skills/parse-qr/SKILL.md) | skills/parse-qr/ | QR screenshots, payment URIs (EIP-681, Solana Pay, Stellar URI) |

## Scripts

| Script | Used by | Purpose |
|---|---|---|
| `check-balance.js` | check-balance, send-payment | Fetch wallet balances (auto-detects chain from address) |
| `create-payment.js` | send-payment | Create payment or dryrun for fee estimate |
| `get-payment.js` | payment-status, send-payment | Poll payment status by ID, tx hash, or address+memo |
| `parse-qr.js` | parse-qr, send-payment | Parse EIP-681, Solana Pay, Stellar URI, plain addresses |
| `check-stellar-trustline.js` | send-payment | Verify USDC/EURC trustline on Stellar G-wallets |
| `chains.js` | (shared) | Chain IDs, token addresses, decimals |

## Supported Chains

### Pay-out (sending to)

| Chain | USDC | USDT |
|---|:---:|:---:|
| Ethereum | ✓ | ✓ |
| Arbitrum | ✓ | ✓ |
| Base | ✓ | ✓ |
| BSC | ✓ | ✓ |
| Polygon | ✓ | ✓ |
| Solana | ✓ | — |
| Stellar | ✓ | — |

### Pay-in (paying from)

| Chain | USDC | USDT |
|---|:---:|:---:|
| Ethereum | ✓ | ✓ |
| Arbitrum | ✓ | ✓ |
| Base | ✓ | — |
| BSC | ✓ | ✓ |
| Polygon | ✓ | ✓ |
| Solana | ✓ | ✓ |
| Stellar | ✓ | — |

These tables can be stale — always verify with `--dryrun`.

## Source Chain Selection

1. User specifies source → use it
2. Otherwise **ask which wallet they are paying from** and recommend Stellar
   (zero fee ≤ $10, fastest settlement). **Never go looking for wallet secrets
   yourself** — do not probe for `.stellar-secret`, read `.env` files, or
   enumerate key material to guess what the user holds. A wallet the user has
   not named is not yours to discover.

## References

- `references/supported-chains.md` — chain IDs, token addresses, decimals
- `references/api-reference.md` — Rozo API endpoints and schemas
- `references/wallet-detection.md` — address format detection rules
- API docs: <https://apidoc.rozo.ai>
- Supported tokens: <https://docs.rozo.ai/integration/api-doc/supported-tokens-and-chains>
```

## File: README.md
upstream: https://github.com/rozoai/rozo-intents-skills/blob/HEAD/README.md

````text
# rozo-intents

Cross-chain crypto payments and bridging inside Claude Code. Send USDC/USDT
across Ethereum, Arbitrum, Base, BSC, Polygon, Solana, and Stellar by just
describing what you want in plain language — Rozo handles wallet detection,
token selection, fee estimation, balance checks, and on-chain execution.

Built as a [Claude Code plugin](https://code.claude.com/docs/en/plugins.md).
Powered by the [Rozo API](https://apidoc.rozo.ai/).
Published on [ClawHub](https://clawhub.ai/plugins/rozo-intents).

## Install

In Claude Code, run:

```
/plugin marketplace add RozoAI/rozo-intents-skills
/plugin install rozo-intents@rozo
```

Or install via [ClawHub](https://clawhub.ai/plugins/rozo-intents) if you're
using an OpenClaw-compatible client.

That's it. No API keys, no env vars — the Rozo APIs are public and
rate-limited. You just need Node.js available (the plugin's runtime scripts
are plain `node`).

## Example prompts

Once installed, ask Claude Code things like:

- `pay 10 USDC on Base to 0x1234…abcd`
- `send 25 USDT on BSC to 0xabcd…1234`
- `payout 5 USDC on Solana to 9WzDXw…fkjP`
- `pay 2 USDC on Stellar to GABC…XYZ with memo invoice-42`
- `check my USDC balance on Base for 0x…`
- `what's the status of payment <uuid>?`
- *(drop in a payment QR screenshot)* → `send this`

The plugin auto-detects the wallet type, prefers USDC when the user doesn't
specify, warns you if a Stellar G-wallet is missing a trustline for the
asset, and picks a confirmation style based on amount:

- **≤ $1 (default)** — silent auto-execute, one-line result report
- **≤ $10 (default)** — narrated auto-execute, no yes/no prompt
- **> $10** — full summary with a single yes/no confirmation

Rozo charges **no fee** for transactions at or below the single-confirm
threshold. Thresholds are configurable in `version.json`.

Chain correctness questions (e.g. "which EVM chain for this `0x…`
address?") always block regardless of amount — wrong chain = lost funds.

## Supported chains

### Pay-out (sending to)

| Chain    | USDC | USDT |
|----------|:----:|:----:|
| Ethereum | ✓    | ✓    |
| Arbitrum | ✓    | ✓    |
| Base     | ✓    | ✓    |
| BSC      | ✓    | ✓    |
| Polygon  | ✓    | ✓    |
| Solana   | ✓    | —    |
| Stellar  | ✓    | —    |

### Pay-in (paying from)

| Chain    | USDC | USDT |
|----------|:----:|:----:|
| Ethereum | ✓    | ✓    |
| Arbitrum | ✓    | ✓    |
| Base     | ✓    | —    |
| BSC      | ✓    | ✓    |
| Polygon  | ✓    | ✓    |
| Solana   | ✓    | ✓    |
| Stellar  | ✓    | —    |

**Amount limits:** $0.01 min, $10,000 max per transaction. Payment type is
`exactOut` by default — the recipient gets the exact amount. For
transactions **above** the single-confirm threshold (default $10), the fee
is added on top of the amount you send; for transactions at or below the
threshold, the fee is $0.

## Links

- ClawHub plugin page: <https://clawhub.ai/plugins/rozo-intents>
- Docs: <https://docs.rozo.ai>
- API reference: <https://apidoc.rozo.ai>
- Supported tokens & chains: <https://docs.rozo.ai/integration/api-doc/supported-tokens-and-chains>

## Repo layout

```
skills/                           source skills (router + 4 sub-skills)
scripts/                          Node runtime scripts (TypeScript source + compiled dist)
references/                       chain/API/wallet reference docs
plugin/                            build tooling and manifest templates
.claude-plugin/marketplace.json    repo-root marketplace manifest (published)
build/plugin/rozo-intents/         built plugin artifact (published)
version.json                       single source of truth for version + metadata
```

### Releasing a new version

```bash
# 1. Bump version.json -> "version": "x.y.z"
# 2. Rebuild
npm run build:all
# 3. Commit and push
git add version.json .claude-plugin/ build/plugin/
git commit -m "Release x.y.z"
git push
```

Bumping `version.json` is required on every code change — Claude Code uses
the version field to invalidate installed users' caches.

## License

[MIT-0](./LICENSE.md) — do whatever you want.

## Secret scanning

Enable the local gitleaks pre-commit hook once per clone: `brew install gitleaks pre-commit && pre-commit install` (config in `.pre-commit-config.yaml`). CI also runs a report-only scan in `.github/workflows/secret-scan.yml`.
````
