Agent Skills

Reusable scripts for AI agents to automate tipping workflows with the Grove CLI.

Prerequisites

Install the Grove CLI first:

curl -fsSL https://grove.city/install-cli.sh | bash
grove setup

See CLI Installation for details.

What Are Agent Skills?

Agent skills are standalone bash scripts that extend the Grove CLI with:

• Batch operations - Tip multiple destinations from a CSV file
• Monitoring - Check balance and alert on low funds
• Auto-funding - Automatically top up when balance drops below threshold

All skills are available for direct download from grove.city and can be integrated into your agent's workflow.

---

Available Skills

File	Description	URL
SKILL.md	CLI installation, philosophy, and quick start guide	View
batch-tip.sh	Batch tip multiple destinations from CSV	View
monitor-balance.sh	Monitor balance and alert on low funds	View
auto-fund.sh	Auto-fund when balance drops below threshold	View

---

Installation

Quick Install (All Skills)

Download all skills to your local Grove directory:

Create skills directory:

mkdir -p ~/.grove/skills/scripts

Download main skill documentation:

curl -fsSL https://grove.city/skills/SKILL.md > ~/.grove/skills/SKILL.md

Download scripts:

curl -fsSL https://grove.city/skills/scripts/batch-tip.sh > ~/.grove/skills/scripts/batch-tip.sh
curl -fsSL https://grove.city/skills/scripts/monitor-balance.sh > ~/.grove/skills/scripts/monitor-balance.sh
curl -fsSL https://grove.city/skills/scripts/auto-fund.sh > ~/.grove/skills/scripts/auto-fund.sh

Make scripts executable:

chmod +x ~/.grove/skills/scripts/*.sh

Individual Script Installation

Install only the scripts you need:

Batch tipping:

mkdir -p ~/.grove/skills/scripts
curl -fsSL https://grove.city/skills/scripts/batch-tip.sh > ~/.grove/skills/scripts/batch-tip.sh
chmod +x ~/.grove/skills/scripts/batch-tip.sh

Balance monitoring:

mkdir -p ~/.grove/skills/scripts
curl -fsSL https://grove.city/skills/scripts/monitor-balance.sh > ~/.grove/skills/scripts/monitor-balance.sh
chmod +x ~/.grove/skills/scripts/monitor-balance.sh

Auto-funding:

mkdir -p ~/.grove/skills/scripts
curl -fsSL https://grove.city/skills/scripts/auto-fund.sh > ~/.grove/skills/scripts/auto-fund.sh
chmod +x ~/.grove/skills/scripts/auto-fund.sh

---

Script Reference

batch-tip.sh

Tip multiple destinations from a CSV file.

Usage:

~/.grove/skills/scripts/batch-tip.sh tips.csv

CSV Format:

destination,amount,network,token
olshansky.info,0.01,base,USDC
@olshansky,0.05,base,USDC
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb,0.10,base,USDC

Features:

• Validates CSV format before processing
• Shows preview of all tips before execution
• Requires confirmation before sending
• Detailed success/failure reporting
• Calculates total amount tipped

Example:

Create tips.csv:

cat > tips.csv << EOF
destination,amount,network,token
olshansky.info,0.01,base,USDC
@olshansky,0.05,base,USDC
EOF

Run batch tip:

~/.grove/skills/scripts/batch-tip.sh tips.csv

---

monitor-balance.sh

Monitor balance and alert when funds are low.

Usage:

~/.grove/skills/scripts/monitor-balance.sh [threshold]

Parameters:

• threshold - Minimum balance in USDC (default: 1.00)

Features:

• Checks current balance via grove balance --json
• Compares against threshold
• Exits with code 0 if balance OK, 1 if low
• Outputs JSON for easy parsing by agents

Example:

Check if balance is above $5:

~/.grove/skills/scripts/monitor-balance.sh 5.00

Use in a cron job (check every hour):

0 * * * * ~/.grove/skills/scripts/monitor-balance.sh 10.00 || echo "Low balance alert!"

Output (JSON):

{
  "status": "low",
  "current_balance": "0.50",
  "threshold": "1.00",
  "needs_funding": true
}

---

auto-fund.sh

Automatically fund account when balance drops below threshold.

Usage:

~/.grove/skills/scripts/auto-fund.sh [threshold] [amount]

Parameters:

• threshold - Balance threshold in USDC (default: 1.00)
• amount - Amount to fund in USDC (default: 10.00)

Features:

• Checks balance before funding
• Only funds if balance is below threshold
• Uses grove fund (requires wallet features)
• Detailed logging of funding operations

Example:

Auto-fund $10 if balance drops below $5:

~/.grove/skills/scripts/auto-fund.sh 5.00 10.00

Use in a cron job (check every 6 hours):

0 */6 * * * ~/.grove/skills/scripts/auto-fund.sh 10.00 20.00

Output:

✓ Balance check: $12.50 (threshold: $5.00)
→ No funding needed

✓ Balance check: $3.00 (threshold: $5.00)
→ Funding account with $10.00...
✓ Funded successfully
✓ New balance: $13.00

Wallet Required

The auto-fund.sh script requires a wallet to use the grove fund command. Run grove setup (choose Wallet + Crypto) or grove keygen --save to generate one.

---

Integration Examples

Python Agent Integration

import subprocess
import json

def check_balance(threshold: float = 1.0) -> dict:
    """Check if balance is sufficient using monitor-balance.sh"""
    result = subprocess.run(
        [f"{os.path.expanduser('~')}/.grove/skills/scripts/monitor-balance.sh", str(threshold)],
        capture_output=True,
        text=True
    )
    return json.loads(result.stdout)

def batch_tip(csv_file: str) -> bool:
    """Execute batch tipping from CSV"""
    result = subprocess.run(
        [f"{os.path.expanduser('~')}/.grove/skills/scripts/batch-tip.sh", csv_file],
        capture_output=True,
        text=True
    )
    return result.returncode == 0

# Usage
balance = check_balance(threshold=5.0)
if balance['needs_funding']:
    print(f"Low balance: ${balance['current_balance']}")
else:
    batch_tip("rewards.csv")

Bash Automation

#!/bin/bash
set -e

SKILLS_DIR="$HOME/.grove/skills/scripts"
TIPS_CSV="$HOME/daily-tips.csv"

if ! "$SKILLS_DIR/monitor-balance.sh" 10.00; then
    echo "Low balance, auto-funding..."
    "$SKILLS_DIR/auto-fund.sh" 10.00 20.00
fi

"$SKILLS_DIR/batch-tip.sh" "$TIPS_CSV"

---

Updating Skills

Skills are updated alongside the Grove CLI. To get the latest versions:

curl -fsSL https://grove.city/skills/scripts/batch-tip.sh > ~/.grove/skills/scripts/batch-tip.sh
curl -fsSL https://grove.city/skills/scripts/monitor-balance.sh > ~/.grove/skills/scripts/monitor-balance.sh
curl -fsSL https://grove.city/skills/scripts/auto-fund.sh > ~/.grove/skills/scripts/auto-fund.sh
chmod +x ~/.grove/skills/scripts/*.sh

Or check the main skill documentation for version information:

curl -fsSL https://grove.city/skills/SKILL.md