How do I install the Surfline skill?

Run npx skillmds@latest add modbender/surfline in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Surfline safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Surfline?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Surfline free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Surfline?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Surfline

Name: Surfline
Rating: 4.2 (5 reviews)
Author: modbender

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.

modbender Updated Sep 9, 2026 12 repo stars

Research & Search

Install

Press C to copy

$ npx skillmds@latest add modbender/surfline

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

Download .zip

＋ Add to plugin

README badge

[![SkillMD](https://skillmd.com/badge/modbender/surfline.svg)](https://skillmd.com/skills/modbender/surfline)

Trust & safety

Audits pending

Not yet audited · commit 83865c1

Permissions this skill uses

Executes scripts
The instructions run shell commands or bundled script files.

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

Surfline (public, no login)

This skill uses Surfline public endpoints (no account, no cookies).

Quick start

Find a spot id:

python3 scripts/surfline_search.py "Cardiff Reef"
python3 scripts/surfline_search.py "D Street"

Get a report for a spot id (prints text + JSON by default):

python3 scripts/surfline_report.py <spotId>
# or only one format:
python3 scripts/surfline_report.py <spotId> --text
python3 scripts/surfline_report.py <spotId> --json

Favorites summary (multiple spots) (prints text + JSON by default):

Create ~/.config/surfline/favorites.json (see references/favorites.json.example).

python3 scripts/surfline_favorites.py

Notes

Keep requests gentle: don’t hammer endpoints. Scripts include basic caching.
Spot IDs are stable; store them once.
If Surfline changes endpoints/fields, update scripts/surfline_client.py.

modbender/skill-library-mcp/tree/main/data/surfline commit 83865c135f

Frequently asked questions

npx skillmds@latest add modbender/surfline