@agnic/wallet-skills 1.3.2 → 2.0.0

package/skills/ai-gateway.md

@@ -1,22 +0,0 @@
----
-name: ai-gateway
-description: Access 340+ AI models through the Agnic AI Gateway. Use when the user wants to chat with AI, generate images, or list available models.
----
-
-## Instructions
-
-1. Check auth: `npx agnic@latest status --json`
-2. List models: `npx agnic@latest ai models --json`
-3. Filter by provider: `npx agnic@latest ai models --provider openai --json`
-4. Chat with a model: `npx agnic@latest ai chat --model <provider/model> --prompt "<text>" --json`
-5. Chat with system prompt: `npx agnic@latest ai chat --model <id> --system "<system>" --prompt "<text>" --json`
-6. Generate image: `npx agnic@latest ai image --prompt "<text>" --output image.png`
-7. Generate image with aspect ratio: `npx agnic@latest ai image --prompt "<text>" --aspect-ratio 16:9 --output wide.png`
-
-Model format: `provider/model-name` (e.g., `openai/gpt-4o`, `anthropic/claude-3.5-sonnet`, `meta-llama/llama-3.3-70b`).
-Free models: meta-llama, google/gemma, mistralai.
-
-## Allowed Tools
-- npx agnic@latest ai models
-- npx agnic@latest ai chat
-- npx agnic@latest ai image

package/skills/authenticate-wallet.md

@@ -1,18 +0,0 @@
----
-name: authenticate-wallet
-description: Sign in to AgnicPay wallet. Use when the user wants to log in, authenticate, or when any command fails with auth errors.
----
-
-## Instructions
-
-1. Run `npx agnic status` to check current auth state
-2. If not authenticated, ask user for their email
-3. Run `npx agnic auth login <email>` — sends OTP code to their email
-4. Ask user for the 6-digit code from their email
-5. Run `npx agnic auth verify <flowId> <otp>`
-6. Confirm with `npx agnic status`
-
-## Allowed Tools
-- npx agnic status
-- npx agnic auth login
-- npx agnic auth verify

package/skills/check-balance.md

@@ -1,15 +0,0 @@
----
-name: check-balance
-description: Check USDC balance across networks. Use when the user asks about their balance, funds, or how much they have.
----
-
-## Instructions
-
-1. Run `npx agnic balance --json` to get balances across all networks
-2. If user asks about a specific network, use `npx agnic balance --network <network> --json`
-3. Present the balance in a clear format with network and amount
-
-Supported networks: base, solana, base-sepolia, solana-devnet
-
-## Allowed Tools
-- npx agnic balance

package/skills/fund-wallet.md

@@ -1,17 +0,0 @@
----
-name: fund-wallet
-description: Get instructions for funding your AgnicPay wallet. Use when the user needs to add funds, deposit, or top up.
----
-
-## Instructions
-
-1. Check current balance: `npx agnic balance --json`
-2. Show the wallet address: `npx agnic address`
-3. Provide funding instructions:
-   - Visit https://pay.agnic.ai to fund via the dashboard
-   - Or send USDC directly to the displayed wallet address on Base or Solana
-4. After funding, verify with `npx agnic balance --json`
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic address

package/skills/get-agent-identity.md

@@ -1,19 +0,0 @@
----
-name: get-agent-identity
-description: Check agent's on-chain identity, trust score, and KYA credentials. Use when the user asks about agent identity, trust, reputation, or credentials.
----
-
-## Instructions
-
-1. Check auth status: `npx agnic status --json`
-2. If authenticated, show the agent's wallet address and identity info
-3. Explain what ERC-8004 agent identity provides:
-   - On-chain identity (NFT-based)
-   - Trust score and reputation
-   - KYA (Know Your Agent) credentials for identity verification
-   - Delegation credentials for authorized actions
-4. Direct user to https://pay.agnic.ai for full identity management
-
-## Allowed Tools
-- npx agnic status
-- npx agnic address

package/skills/pay-for-service.md

@@ -1,16 +0,0 @@
----
-name: pay-for-service
-description: Make a paid request to an x402-enabled API. Use when the user wants to call, use, or pay for an API service.
----
-
-## Instructions
-
-1. Confirm the API URL and HTTP method with the user
-2. Check balance: `npx agnic balance --network base --json`
-3. Execute: `npx agnic x402 pay <url> --method <METHOD> --json`
-4. If the request needs a body, add `--body '{"key":"value"}'`
-5. Present the API response and cost to the user
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic x402 pay

package/skills/search-for-service.md

@@ -1,15 +0,0 @@
----
-name: search-for-service
-description: Search for x402-enabled APIs and services. Use when the user wants to find, discover, or browse available paid APIs.
----
-
-## Instructions
-
-1. Run `npx agnic x402 search "<query>" --json` with the user's search terms
-2. Present results with name, description, and price per request
-3. If user wants to filter by category, add `--category <category>`
-
-Available categories: AI, Crypto, Data, Trading, Finance, Weather
-
-## Allowed Tools
-- npx agnic x402 search

package/skills/send-usdc/SKILL.md

@@ -1,96 +0,0 @@
----
-name: send-usdc
-description: Send USDC to an Ethereum address or ENS name. Use when you or the user want to send money, pay someone, transfer USDC, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", "transfer to vitalik.eth", "tip someone", "send USDC".
-user-invocable: true
-disable-model-invocation: false
-allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest send *)", "Bash(npx agnic@latest balance*)"]
----
-
-# Sending USDC
-
-Use the `npx agnic@latest send` command to transfer USDC from the wallet to any Ethereum address or ENS name on Base.
-
-## Confirm wallet is initialized and authed
-
-```bash
-npx agnic@latest status
-```
-
-If the wallet is not authenticated, refer to the `authenticate-wallet` skill.
-
-## Command Syntax
-
-```bash
-npx agnic@latest send <amount> <recipient> [--chain <chain>] [--json]
-```
-
-## Arguments
-
-| Argument    | Description                                                                                                                                                                                                                          |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `amount`    | Amount to send: `'$1.00'`, `1.00`, or atomic units (1000000 = $1). Always single-quote amounts that use `$` to prevent bash variable expansion. If the number looks like atomic units (no decimal or > 100), treat as atomic units. |
-| `recipient` | Ethereum address (0x...) or ENS name (vitalik.eth)                                                                                                                                                                                   |
-
-## Options
-
-| Option           | Description                        |
-| ---------------- | ---------------------------------- |
-| `--chain <name>` | Blockchain network (default: base) |
-| `--json`         | Output result as JSON              |
-
-## Input Validation
-
-Before constructing the command, validate all user-provided values to prevent shell injection:
-
-- **amount**: Must match `^\$?[\d.]+$` (digits, optional decimal point, optional `$` prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.
-- **recipient**: Must be a valid `0x` hex address (`^0x[0-9a-fA-F]{40}$`) or an ENS name (`^[a-zA-Z0-9.-]+\.eth$`). Reject any value containing spaces or shell metacharacters.
-
-Do not pass unvalidated user input into the command.
-
-## USDC Amounts
-
-| Format        | Example                | Description                            |
-| ------------- | ---------------------- | -------------------------------------- |
-| Dollar prefix | `'$1.00'`, `'$0.50'`  | USD notation (single-quote the `$`)    |
-| Decimal       | `1.0`, `0.50`          | Human-readable with decimal point      |
-| Whole number  | `5`, `100`             | Interpreted as whole USDC tokens       |
-| Atomic units  | `500000`               | Large integers treated as atomic units |
-
-**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).
-
-## ENS Resolution
-
-ENS names are automatically resolved to addresses via Ethereum mainnet. The command will:
-1. Detect ENS names (any string containing `.eth`)
-2. Resolve the name to an address
-3. Display both the ENS name and resolved address in the output
-
-## Examples
-
-```bash
-# Send $1.00 USDC to an address
-npx agnic@latest send 1 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
-
-# Send $0.50 USDC to an ENS name
-npx agnic@latest send 0.50 vitalik.eth
-
-# Send with dollar sign prefix (note the single quotes)
-npx agnic@latest send '$5.00' 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
-
-# Get JSON output
-npx agnic@latest send 1 vitalik.eth --json
-```
-
-## Prerequisites
-
-- Must be authenticated (`npx agnic@latest status` to check)
-- Wallet must have sufficient USDC balance (`npx agnic@latest balance` to check)
-
-## Error Handling
-
-Common errors:
-
-- "Not authenticated" — Run `npx agnic@latest auth login` first
-- "Insufficient balance" — Check balance with `npx agnic@latest balance`
-- "Could not resolve ENS name" — Verify the ENS name exists
-- "Invalid recipient" — Must be valid 0x address or ENS name

package/skills/send-usdc.md

@@ -1,19 +0,0 @@
----
-name: send-usdc
-description: Send USDC to a wallet address. Use when the user wants to send, transfer, or pay someone USDC.
----
-
-## Instructions
-
-1. Confirm the recipient address and amount with the user
-2. Check balance first: `npx agnic balance --network base --json`
-3. If sufficient funds, execute: `npx agnic send <amount> <address> --json`
-4. Report the transaction hash and explorer link
-
-Optional flags:
-- `--network <network>` — default is "base"
-- `--memo <text>` — attach a memo to the transaction
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic send

package/skills/trade-tokens/SKILL.md

@@ -1,107 +0,0 @@
----
-name: trade-tokens
-description: Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "swap tokens", "trade USDC for WETH".
-user-invocable: true
-disable-model-invocation: false
-allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest trade *)", "Bash(npx agnic@latest balance*)"]
----
-
-# Trading Tokens
-
-Use the `npx agnic@latest trade` command to swap tokens on Base network. You must be authenticated to trade.
-
-## Confirm wallet is initialized and authed
-
-```bash
-npx agnic@latest status
-```
-
-If the wallet is not authenticated, refer to the `authenticate-wallet` skill.
-
-## Command Syntax
-
-```bash
-npx agnic@latest trade <amount> <from> <to> [options]
-```
-
-## Arguments
-
-| Argument | Description                                                            |
-| -------- | ---------------------------------------------------------------------- |
-| `amount` | Amount to swap (see Amount Formats below)                              |
-| `from`   | Source token: alias (usdc, eth, weth) or contract address (0x...)      |
-| `to`     | Destination token: alias (usdc, eth, weth) or contract address (0x...) |
-
-## Amount Formats
-
-| Format        | Example                | Description                            |
-| ------------- | ---------------------- | -------------------------------------- |
-| Dollar prefix | `'$1.00'`, `'$0.50'`  | USD notation (decimals based on token) |
-| Decimal       | `1.0`, `0.50`, `0.001` | Human-readable with decimal point      |
-| Whole number  | `5`, `100`             | Interpreted as whole tokens            |
-| Atomic units  | `500000`               | Large integers treated as atomic units |
-
-**Auto-detection**: Large integers without a decimal point are treated as atomic units. For example, `500000` for USDC (6 decimals) = $0.50.
-
-**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).
-
-## Token Aliases
-
-| Alias | Token | Decimals | Address                                    |
-| ----- | ----- | -------- | ------------------------------------------ |
-| usdc  | USDC  | 6        | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
-| eth   | ETH   | 18       | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE |
-| weth  | WETH  | 18       | 0x4200000000000000000000000000000000000006   |
-
-## Options
-
-| Option               | Description                                   |
-| -------------------- | --------------------------------------------- |
-| `-s, --slippage <n>` | Slippage tolerance in basis points (100 = 1%) |
-| `--json`             | Output result as JSON                         |
-
-## Input Validation
-
-Before constructing the command, validate all user-provided values to prevent shell injection:
-
-- **amount**: Must match `^\$?[\d.]+$` (digits, optional decimal point, optional `$` prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.
-- **from / to**: Must be a known alias (`usdc`, `eth`, `weth`) or a valid `0x` hex address (`^0x[0-9a-fA-F]{40}$`). Reject any other value.
-- **slippage**: Must be a positive integer (`^\d+$`).
-
-Do not pass unvalidated user input into the command.
-
-## Examples
-
-```bash
-# Swap $1 USDC for ETH (dollar prefix — note the single quotes)
-npx agnic@latest trade '$1' usdc eth
-
-# Swap 0.50 USDC for ETH (decimal format)
-npx agnic@latest trade 0.50 usdc eth
-
-# Swap 0.01 ETH for USDC
-npx agnic@latest trade 0.01 eth usdc
-
-# Swap with custom slippage (2%)
-npx agnic@latest trade '$5' usdc eth --slippage 200
-
-# Get JSON output
-npx agnic@latest trade '$1' usdc eth --json
-```
-
-## Prerequisites
-
-- Must be authenticated (`npx agnic@latest status` to check)
-- Wallet must have sufficient balance of the source token
-- Trading is only available on Base mainnet
-
-## Error Handling
-
-Common errors:
-
-- "Not authenticated" — Run `npx agnic@latest auth login` first
-- "Invalid token" — Use a valid alias (usdc, eth, weth) or 0x address
-- "Cannot swap a token to itself" — From and to must be different
-- "Swap failed: TRANSFER_FROM_FAILED" — Insufficient balance or approval issue
-- "No liquidity" — Try a smaller amount or different token pair
-- "Amount has X decimals but token only supports Y" — Too many decimal places

package/skills/trade-tokens.md

@@ -1,22 +0,0 @@
----
-name: trade-tokens
-description: Trade/swap tokens on Base. Use when the user wants to buy, sell, swap, trade, or exchange tokens like ETH, USDC, DAI, AERO, cbETH.
----
-
-## Instructions
-
-1. Confirm which tokens to trade and the amount
-2. Check balance: `npx agnic balance --network base --json`
-3. Optionally preview: `npx agnic trade <amount> <sellToken> <buyToken> --dry-run --json`
-4. Execute trade: `npx agnic trade <amount> <sellToken> <buyToken> --json`
-5. Report results: tokens received, price, transaction hash
-
-Supported tokens: USDC, ETH, WETH, cbETH, DAI, AERO
-
-Optional flags:
-- `--slippage <percent>` — max slippage percentage (default: 1.0)
-- `--dry-run` — show quote without executing
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic trade