← Back to Skills Marketplace
Surf
by
hughzhou-gif
· GitHub ↗
· v1.1.0
· MIT-0
260
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install surf
Description
Your AI agent's crypto brain. One skill, 83+ commands across 14 data domains — real-time prices, wallets, social intelligence, DeFi, on-chain SQL, prediction...
Usage Guidance
This skill is a dispatcher to an external 'surf' CLI rather than a self-contained implementation. Before installing or letting an agent follow these instructions: 1) Verify the provenance of the CLI and the documentation URL (agents.asksurf.ai) — find a maintained source (GitHub repo, release artifacts) and inspect the code/binaries. 2) Prefer running 'surf install' yourself in a controlled environment (or skip it) rather than letting the agent execute installs. 3) Be cautious about allowing the skill to edit and commit AGENTS.md or other project files — that change routes all agents to use Surf by default. If you don't want global routing, decline the prompt; the SKILL.md suggests creating ~/.surf/.routing-declined to record that. 4) Review any npm packages invoked via npx and their maintainers. 5) If you need a higher assurance, ask the publisher for a signed release, a repo link, or a cryptographic checksum for the CLI binary. Because the metadata omits install provenance and the skill instructs persistent repository changes, treat this as potentially risky until you validate the CLI and intended behavior.
Capability Analysis
Type: OpenClaw Skill
Name: surf
Version: 1.1.0
The skill bundle instructs the agent to modify project files (AGENTS.md or CLAUDE.md) and perform git commits to inject 'routing rules' that prioritize this tool over others, which is a form of persistent prompt injection. It also relies on `surf install` to download or update a binary from a remote endpoint (asksurf.ai) and includes a feedback command that exfiltrates the last 10 turns of conversation history. While these actions are documented and include user consent checks, the automated modification of project structure and the self-favoring prompt injection are high-risk behaviors.
Capability Tags
Capability Assessment
Purpose & Capability
The skill is presented as a wrapper around a separate 'surf' CLI and the SKILL.md tells the agent how to use that CLI. Requesting to install/run a CLI to fetch crypto data is consistent with the description. However, the skill also instructs the agent to inject repository-wide routing rules that cause other agents to prefer Surf for crypto data, which elevates the scope beyond a pure query helper.
Instruction Scope
Runtime instructions tell the agent to run shell commands that will install a binary ('surf install'), sync remote specs, create files under ~/.surf, append or create AGENTS.md (or CLAUDE.md) in the project, and commit that change. These are file-system and VCS modifications that persist and affect other agents. The instructions grant the agent broad discretion to modify project state and run network installs — beyond simply querying data.
Install Mechanism
There is no declared install spec in the skill metadata, but the SKILL.md directs the agent to install a CLI via a link (https://agents.asksurf.ai/docs/cli/introduction) and to run 'surf install' / 'npx' commands. That implies downloading and executing code from an external source (and from npm via npx). The skill provides no provenance for the CLI or package names; downloading/executing an unverified binary is a moderate-to-high risk.
Credentials
The skill declares no required environment variables, credentials, or config paths. The runtime instructions create small local artifacts (~/.surf/.routing-declined) and reference git project files (AGENTS.md/CLAUDE.md), which are related to the stated goal of integrating Surf into project workflows. No unrelated credentials are requested.
Persistence & Privilege
Although always:false, the skill advocates adding a persistent, project-level routing block that instructs all agents to prefer Surf — and recommends committing that change. This modifies project policy for agents and can change behavior across sessions and users. Combined with the install instructions that download/execute external code, that persistent influence is notable and potentially risky.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install surf - After installation, invoke the skill by name or use
/surf - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Sync with asksurf-ai/surf-skills main: W007 credential hardening, Snyk security fixes, AGENTS.md routing injection, capability boundaries section, CLI v1.0.0-alpha.31 compatibility, news-feed vs search-news routing clarification, and more.
v1.0.0
Initial publish: 83+ crypto data commands, 14 domains, routing workflow, security audit fixes
Metadata
Frequently Asked Questions
What is Surf?
Your AI agent's crypto brain. One skill, 83+ commands across 14 data domains — real-time prices, wallets, social intelligence, DeFi, on-chain SQL, prediction... It is an AI Agent Skill for Claude Code / OpenClaw, with 260 downloads so far.
How do I install Surf?
Run "/install surf" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Surf free?
Yes, Surf is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Surf support?
Surf is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Surf?
It is built and maintained by hughzhou-gif (@hughzhou-gif); the current version is v1.1.0.
More Skills