Surf/Docs

Skills

Agent skills that teach AI coding agents how to use the Surf CLI

Surf Skills are instruction packages that teach AI coding agents how to use the Surf CLI correctly and efficiently.

In a skills-compatible agent environment, a Surf Skill can help the agent:

  • Discover the right Surf command for a natural-language request
  • Use the correct parameter names and command patterns
  • Avoid common mistakes around search flags, chain names, and output formatting
  • Move from exploration to implementation faster when building Surf-powered apps

Installation

The Surf Skill is hosted at asksurf-ai/surf-skills.

npx skills add asksurf-ai/surf-skills --skill surf

This works with any agent that supports the skills protocol (Claude Code, Codex, etc.).

Prerequisites

Install the Surf CLI:

curl -fsSL https://downloads.asksurf.ai/cli/releases/install.sh | sh

No API key required to try it out. Every IP gets 30 free credits per day — just install and go.

For full access, get your API key from agents.asksurf.ai (sign in → Dashboard → Generate API Key), then:

# Option 1: save the key (prefers OS keychain, falls back to ~/.surf/config.json)
surf auth --api-key sk-your-key-here
 
# Option 2: environment variable (the Skill picks this up automatically)
export SURF_API_KEY=sk-your-key-here

Example Queries

Here's what you can ask your AI agent once the Surf Skill is installed:

Market & Exchange

  • "Bitcoin price update" → market-price
  • "Top 10 cryptocurrencies by market cap" → market-ranking
  • "What's the current open interest in BTC futures?" → market-futures
  • "Fear and greed index chart for the last 30 days" → market-fear-greed
  • "Give me the 1h klines for SOL-USDT on OKX from the past month" → exchange-klines
  • "What's the order book depth for BTC-USDT on Binance?" → exchange-depth
  • "현재 비트코인 롱숏비율 알려줘" → exchange-long-short-ratio

Wallet & Token

  • "Show me the full portfolio breakdown for wallet 0x28c6..." → wallet-detail
  • "Vitalik's wallet transactions over the last 24 hours" → wallet-history
  • "UNI代币目前的前几大持有者是谁？" → token-holders
  • "Show me the DEX trades for $PEPE token in the last 7 days" → token-dex-trades
  • "$ROBO 根据现有流通和接下来的解锁情况，帮我分析价格走势" → token-tokenomics

Prediction Markets

  • "Polymarket上'Trump赢得大选'这个市场的1小时K线" → polymarket-price-ohlcv
  • "Who's the smart money flowing into on Polymarket?" → polymarket-smart-money
  • "지난 30일 동안 Polymarket 수익 리더보드에 누가 있어?" → polymarket-leaderboard
  • "Current Kalshi markets for US elections" → kalshi-markets
  • "Top prediction markets by volume — what's the momentum trend?" → prediction-market-analytics

News

  • "Anything new happening with Ethereum lately?" → news-feed

Onchain SQL

  • "用SQL查一下过去7天以太坊上USDC的每日转账总量" → onchain-sql
  • "What tables and columns are available in the on-chain SQL database?" → onchain-schema
  • "过去7天哪些跨链桥的交易量排名最高？" → onchain-bridge-ranking

Search & Discovery

  • "过去7天有什么新的空投吗？" → search-airdrop
  • "give me airdrop, Tier S only" → search-airdrop

What the Skill Teaches

The surf skill teaches an agent to:

  1. Run surf sync before discovery
  2. Use surf list-operations and surf <command> --help to find the right endpoint
  3. Prefer JSON output with -o json -f body.data for structured downstream processing
  4. Match user intent to the correct domain (market, wallet, token, onchain, etc.)
Surf — Crypto Intelligence for AI Agents