aiusd-skill

# AIUSD Skill (Agent Reference)

This skill calls the AIUSD backend via MCP. Auth is resolved in order: env `MCP_HUB_TOKEN`, mcporter OAuth, or local `~/.mcp-hub/token.json`. Ensure a valid Bearer token is available before calling. **Before invoking the CLI**, read **Common Pitfalls and Solutions** to avoid parameter, escaping, and intent mistakes.

## ⚠️ Agent Output Guidelines

**CRITICAL - ABSOLUTELY FORBIDDEN PHRASES**:
Agents must NEVER use these words or phrases when responding to users:

**TEMPLATE-RELATED (COMPLETELY BANNED)**:
- "template" (any form: template, templates)
- "example" (when referring to trading examples: Example 1, Example 12, etc.)
- "pattern" (when referring to trading patterns)
- "using template", "get template", "trading template", "buy template"
- "use Example [number]", "based on template", "following template"

**VERIFICATION-RELATED (COMPLETELY BANNED)**:
- "skill verification", "verification"

**WHAT TO SAY INSTEAD**:
- Instead of "using template": say "executing the trade" or "placing the order"
- Instead of "get template": say "preparing the trade" or "setting up the order"
- Instead of "Example 12 template": say "the trade configuration" or simply describe the action

**ZERO TOLERANCE**: Any use of the word "template" in trading contexts is STRICTLY PROHIBITED.

**Authentication Response Guidelines**:
**CRITICAL**: When users request re-authentication, respond ONLY with:
- "The browser window should have opened for you"
- "If it didn't open automatically, please tell the agent to re-login again (or type 'reauth' again)"
- "After completing authentication, you can check your account balance or wallet status in chat"

**NEVER return the login URL to the user**: Do NOT ever show or tell the user `https://mcp.alpha.dev/oauth/login`. If the browser did not open, do NOT give them the URL—only tell them to ask the agent to re-login / type 'reauth' again.

**STRICTLY FORBIDDEN**:
- Do NOT include or mention the login URL (e.g. mcp.alpha.d...

# AIUSD Skill for OpenClaw/ClawdBot

The official AIUSD trading skill for your personal AI assistant. Trade cryptocurrencies, check balances, and manage your AIUSD account through natural language conversations in Telegram, Discord, WhatsApp, or any platform your bot supports.

## 🚀 Quick Start

### Step 1: Install the Skill

**Option A: Drag & Drop (Easiest)**
1. Download the skill file: **[Download aiusd-skill-agent.skill](https://github.com/galpha-ai/aiusd-skills/releases/download/v1.0.0/aiusd-skill-agent.skill)**
2. Start your ClawdBot/OpenClaw assistant
3. Open your chat (Telegram, Discord, WhatsApp, etc.)
4. Drag and drop the downloaded `.skill` file into the chat
5. Your bot will automatically install the skill

**Option B: Manual Installation**
1. Download and extract the skill file: **[Download aiusd-skill-agent.skill](https://github.com/galpha-ai/aiusd-skills/releases/download/v1.0.0/aiusd-skill-agent.skill)**
2. Extract: `tar -xzf aiusd-skill-agent.skill`
3. Copy the extracted folder to your OpenClaw skills directory
4. Restart your bot

### Step 2: Authentication Setup

The bot will automatically handle authentication when you first use AIUSD features. If automatic login fails, simply tell your bot: *"re-login"* in the chat.

### Step 3: Start Trading!

Now you can talk to your bot naturally:

- *"What's my AIUSD balance?"*
- *"Buy $100 worth of SOL with USDC"*
- *"Show my recent transactions"*
- *"What are my trading addresses?"*

## 💬 What You Can Ask Your Bot

### Check Balance & Accounts
- *"Check my AIUSD balance"*
- *"How much do I have in my account?"*
- *"What's my total portfolio value?"*
- *"Show me my trading addresses"*

### Execute Trades
- *"Buy $50 of SOL with USDC"*
- *"Sell 100 USDC for ETH"*
- *"Swap 0.1 ETH to SOL"*
- *"Trade 1000 USDC for BTC"*

### Staking Operations
- *"Stake 500 AIUSD"*
- *"Unstake my AIUSD"*
- *"How much am I earning from staking?"*

### Transaction History
- *"Show my last 10 transactions"*
- *"What trades did...