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://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.)