stormglass-surf-skill
Fetch surf-relevant ocean conditions from Stormglass by spot name or coordinates, including current snapshot and 1-3 day forecast windows with tides, gusts, and water temperature. Use when users ask for surf reports, wave or swell conditions, tide timing, wind, gusts, or water temperature for a beach or surf spot.
Why use this skill?
Integrate real-time surf reports and marine weather forecasts into your OpenClaw agent with the Stormglass Surf Skill. Supports coordinates, geocoding, and JSON output.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/dgorissen/stormglassWhat This Skill Does
The stormglass-surf-skill provides OpenClaw agents with the ability to retrieve real-time and forecasted ocean conditions from the Stormglass API. It acts as a bridge between high-level user requests and structured, machine-readable environmental data. Whether a user is looking for a quick surf report at their local break or needs a multi-day forecast to plan a trip, this skill translates human-readable location names or raw GPS coordinates into comprehensive JSON payloads containing wave height, swell period, wind speeds, gusts, tide timing, and water temperature. Designed for reliability and automation, the skill supports various forecast horizons (now, 24h, 48h, 72h) and includes a mock mode for testing pipelines without consuming API credits.
Installation
To integrate this skill into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/dgorissen/stormglass
Ensure you have your environment configured by setting the STORMGLASS_API_KEY. While an optional GOOGLE_GEOCODING_API_KEY can improve location resolution, the skill is capable of falling back to OpenStreetMap Nominatim for geocoding services, ensuring high availability even without additional third-party keys.
Use Cases
This skill is ideal for automating environmental intelligence gathering. It serves surf enthusiasts who require granular data for specific beaches, event coordinators planning coastal activities, and developers building agentic workflows that trigger alerts based on optimal swell or wind conditions. Because the output is strictly structured JSON, it is perfectly suited for downstream agents that perform data analysis or trigger automated notifications via Slack, email, or other messaging platforms.
Example Prompts
- "What are the surf conditions at Mavericks right now, and what does the tide look like for this afternoon?"
- "Check the 48-hour surf forecast for Tofino, BC. I am looking for the best window for swell and wind speed."
- "Is the water temperature at Bondi Beach warm enough for a swim today? Provide a quick summary of the current wind and wave conditions."
Tips & Limitations
When deploying, always use --output json to ensure your downstream pipelines can parse the response correctly. If you are developing new agent logic, utilize the --mock flag to ensure your scripts handle the expected schema without hitting live API limits. Be aware that null values represent unavailable data rather than zero-metrics; ensure your logic interprets nulls gracefully to avoid skewed analysis. For production cron jobs, we recommend wrapping the execution in a validation step using scripts/normalize_surf_data.py to maintain data integrity.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-dgorissen-stormglass": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api