← Back to Skills Marketplace
miguelcarranza

Surfline (public)

by MiguelCarranza · GitHub ↗ · v0.1.0
cross-platform ✓ Security Clean
1843
Downloads
3
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install surfline
Description
Get surf forecasts and current conditions from Surfline public endpoints (no login). Use to look up Surfline spot IDs, fetch forecasts/conditions for specific spots, and summarize multiple favorite spots.
Usage Guidance
This skill appears to do what it claims: query Surfline public endpoints and summarize results. Before installing, note: (1) the author is unknown — if you need stronger assurance, review the included Python files yourself; (2) it requires python3 at runtime (not declared in registry metadata); (3) it will read ~/.config/surfline/favorites.json (if you use favorites) and create/read cache files under ~/.cache/surfline by default — you can set SURFLINE_CACHE_DIR and SURFLINE_CACHE_TTL_SEC to control this; (4) it uses the network to contact services.surfline.com and sets a custom User-Agent; (5) run in a sandbox if you prefer, but no credentials or secrets are requested and there is no suspicious or obfuscated behavior in the code.
Capability Analysis
Type: OpenClaw Skill Name: surfline Version: 0.1.0 The skill's code and documentation are clearly aligned with its stated purpose of fetching public surf forecasts from Surfline. It uses standard Python libraries for network requests to `https://services.surfline.com` and for local caching in `~/.cache/surfline`. Configuration is read from `~/.config/surfline/favorites.json`. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent in SKILL.md. All observed behaviors are benign and expected for a skill of this type.
Capability Assessment
Purpose & Capability
Name/description say 'public Surfline endpoints (no login)' and the code exclusively queries https://services.surfline.com endpoints (search, kbyg/*). The provided search, report, and favorites functionality matches the claimed purpose.
Instruction Scope
SKILL.md instructs running the included Python scripts. The scripts only perform HTTP GETs to Surfline, parse JSON, and output summaries/JSON. They also read a user favorites config (~/.config/surfline/favorites.json) and write/read a cache (~/.cache/surfline by default), which is documented in the README; this is within the skill's stated scope.
Install Mechanism
There is no install spec (instruction-only), and the Python scripts use only the standard library. One mismatch: registry metadata lists no required binaries but SKILL.md commands assume python3 is available. That is minor (standard expectation) but worth noting.
Credentials
The skill declares no required env vars or credentials. The code does read optional env vars SURFLINE_CACHE_DIR and SURFLINE_CACHE_TTL_SEC (non-sensitive, control cache location/TTL) and otherwise accesses user files under the home directory (favorites config and cache). These accesses are proportional to the feature and documented in SKILL.md.
Persistence & Privilege
always: false and no special persistence requested. The skill creates and uses its own cache/config paths and does not attempt to modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install surfline
  3. After installation, invoke the skill by name or use /surfline
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial public surfline skill: search spot IDs, favorites summary, per-spot report. Public endpoints only (no login).
Metadata
Slug surfline
Version 0.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Surfline (public)?

Get surf forecasts and current conditions from Surfline public endpoints (no login). Use to look up Surfline spot IDs, fetch forecasts/conditions for specific spots, and summarize multiple favorite spots. It is an AI Agent Skill for Claude Code / OpenClaw, with 1843 downloads so far.

How do I install Surfline (public)?

Run "/install surfline" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Surfline (public) free?

Yes, Surfline (public) is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Surfline (public) support?

Surfline (public) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Surfline (public)?

It is built and maintained by MiguelCarranza (@miguelcarranza); the current version is v0.1.0.

💬 Comments