Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

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://agent.asksurf.ai/cli/releases/install.sh | sh
No API key required to get started. Every IP gets 30 free credits per day — just install and go. For unlimited access, set your API key: 
# Option 1: persistent (recommended)
surf auth

# Option 2: environment variable
export SURF_API_KEY=your-api-key

​
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, social, token, onchain, etc.)