---
title: AI Agent Skills
description: Pre-built AI agent skills for wallet operations, x402 transactions, and identity verification
---

# AI Agent Skills

The `@agnic/wallet-skills` package provides pre-built skills that teach AI assistants how to use Agnic. Compatible with any AI coding tool that supports the SKILL.md specification — Claude Code, Cline, Cursor, Windsurf, and more.

---

## Installation

```bash
npx skills add agnicpay/agnic-wallet-skills
```

Or clone locally:

```bash
git clone https://github.com/agnicpay/agnic-wallet-skills
npx skills add ./agnic-wallet-skills
```

---

## Available Skills

| Skill | Trigger Phrases | Description | Side Effects |
|-------|-----------------|-------------|--------------|
| **authenticate-wallet** | "log in", "sign in", "authenticate" | Browser OAuth or headless token auth | None |
| **check-balance** | "check balance", "how much do I have" | USDC balance across networks | None |
| **search-for-service** | "find an API", "search for" | Discover x402-enabled APIs | None |
| **pay-for-service** | "call this API", "use this service" | Make x402 requests | Spends USDC |
| **fund-wallet** | "add funds", "deposit", "top up" | Instructions for funding wallet | None |
| **get-agent-identity** | "agent identity", "trust score" | ERC-8004 identity and credentials | None |
| **agent-email** | "agent email", "check inbox", "send email" | Send, receive, and manage agent email | Sends email |
| **ai-gateway** | "ask GPT", "generate an image", "list models" | Access 340+ AI models — chat and image generation | Spends USDC |

---

## How Skills Work

Each skill is a markdown file (`SKILL.md`) that instructs the AI assistant on how to complete a task using the `agnic` CLI. When a user's request matches a skill, the AI follows the instructions to execute the right commands.

### Example: Accessing an x402 API

When a user says "call this weather API", the `pay-for-service` skill instructs the AI to:

1. Check the wallet balance
2. Execute the x402 request
3. Report the results

```bash
# The AI runs these commands automatically:
npx agnic@latest balance --network base --json
npx agnic@latest x402 pay https://api.example.com/weather --json
```

---

## Authentication

Skills support two authentication modes:

### Headless (CI, servers, AI agents)

Generate an API token at [app.agnic.ai](https://app.agnic.ai) > Settings > API Tokens:

```bash
export AGNIC_TOKEN=<your-api-token>
agnic status --json
```

### Interactive (browser available)

```bash
agnic auth login
# Opens browser → sign in → set spending limits → done
```

---

## Prerequisites

Skills require the `agnic` CLI to be available:

```bash
npm install -g agnic
```

---

## Unique: Agent Identity Skill

The `get-agent-identity` skill has no equivalent in other wallet tools. It lets AI agents check their on-chain ERC-8004 identity, trust score, and KYA credentials — enabling identity-verified transactions.

---

## Next Steps

<Cards>
  <Card title="CLI Reference" href="/docs/agnicpay-features/cli">
    Full CLI command reference
  </Card>
  <Card title="MCP Server" href="/docs/agnicpay-features/mcp-server">
    Connect AI assistants via MCP
  </Card>
  <Card title="X402 Fetch" href="/docs/x402/x402-fetch">
    Learn about X402 transactions
  </Card>
</Cards>