Skip to content
TakoAPI
Back to skills

stormglass

by dgorissen

Coding Agents & IDEs
315Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Fetch surf-relevant ocean conditions from Stormglass by spot name or coordinates, including current snapshot.

Description

What This Skill Does

Fetches ocean and surf conditions from Stormglass by spot name or coordinates. Returns a structured JSON payload covering wave height, swell, wind, gusts, tides, and water temperature. Supports current snapshots and forecast windows up to 72 hours.

The stable JSON output contract and explicit exit codes make it reliable for automated agent pipelines without additional normalization work.

When to Use It

  • Check surf conditions before heading to the beach
  • Get tide timing for a specific coastal location
  • Pull wind and gust data for a kitesurfing session
  • Automate daily surf reports via cron pipeline
  • Test offline with mock data before going live

Example Workflow

INPUT

User asks: What are the surf conditions at Highcliffe Beach for the next 48 hours?

AGENT
  1. 1

    Resolve spot name to coordinates using Google Geocoding or OSM Nominatim fallback

  2. 2

    Call Stormglass API with resolved coordinates and 48h horizon

  3. 3

    Parse response into structured JSON with wave, swell, wind, and tide fields

  4. 4

    Return forecast summary including best windows and tide extremes

OUTPUT

JSON payload with waveHeightM, swellPeriodS, windGustMps, waterTemperatureC, and tide extremes for the next 48 hours

Requirements

  • STORMGLASS_API_KEY environment variable
  • GOOGLE_GEOCODING_API_KEY environment variable (optional, falls back to OpenStreetMap)

Installation

clawhub install dgorissen/stormglass

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links