← Back to Skills Marketplace
Stormglass Surf & Ocean Data
by
Dirk Gorissen
· GitHub ↗
· v1.0.2
525
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install stormglass
Description
Fetch surf-relevant ocean conditions from Stormglass by spot name or coordinates, including current snapshot and 1-3 day forecast windows with tides, gusts,...
Usage Guidance
This skill appears coherent with its stated purpose: it runs a Python CLI that calls Stormglass (requires STORMGLASS_API_KEY) and, if you provide it, Google Geocoding (or it falls back to OpenStreetMap). Before installing/use: 1) Be aware the registry only lists STORMGLASS_API_KEY as required—SKILL.md and the code also accept an optional GOOGLE_GEOCODING_API_KEY (so ensure any automation/exposure of credentials includes that clarification). 2) Review the bundled scripts in your environment (they will make outbound HTTPS calls to Stormglass, Google Maps, and OSM). If you want to test safely, run the included tests with --mock to avoid using keys or network. 3) Limit and rotate the Stormglass and Google keys you provide, and consider running the CLI in an isolated environment or with restricted network access if you have concerns. 4) Confirm the full surf_report.py (the file is large) matches expectations and contains no unexpected remote endpoints or hidden behavior; if you want higher assurance, run the test runner and inspect logs in a sandbox first.
Capability Analysis
Type: OpenClaw Skill
Name: stormglass
Version: 1.0.2
The OpenClaw AgentSkills skill bundle for Stormglass surf reports is benign. The `scripts/surf_report.py` script legitimately interacts with known external APIs (Stormglass, Google Geocoding, OpenStreetMap Nominatim) to fetch weather and tide data. API keys are securely read from environment variables, and input sanitization is handled via `argparse` and `urllib.parse.urlencode`. There is no evidence of malicious intent, such as unauthorized data exfiltration, arbitrary command execution, persistence mechanisms, or prompt injection attempts in the `SKILL.md` or other documentation files. All network calls are to documented and expected services, and the overall code structure is clean and follows best practices.
Capability Assessment
Purpose & Capability
Name/description match the included code and instructions: the CLI scripts fetch Stormglass weather/tide data and optionally geocode spot names. Requested binary (python3) and primary credential (STORMGLASS_API_KEY) are appropriate for this purpose.
Instruction Scope
SKILL.md and the scripts instruct the agent to run the local Python CLI which will perform network calls to Stormglass and (optionally) Google Geocoding or OpenStreetMap Nominatim. The instructions do not request reading unrelated files or broad system state. Note: SKILL.md refers to an optional GOOGLE_GEOCODING_API_KEY and OSM fallback; that optional credential is used by runtime code but is not listed in the registry's required env list (minor mismatch).
Install Mechanism
No install spec; this is instruction + bundled scripts only. That is the lowest-risk install pattern. All code is shipped in the bundle rather than downloaded at install time.
Credentials
PrimaryEnv STORMGLASS_API_KEY is appropriate. However, SKILL.md and the code reference an optional GOOGLE_GEOCODING_API_KEY for geocoding; the registry metadata did not declare this optional env var. This mismatch could confuse automated tooling that only exposes declared creds. No other unrelated secrets or config paths are requested.
Persistence & Privilege
Skill does not request always:true and does not claim to modify other skills or system-wide configuration. It runs as a CLI tool (agent invokes the script) and can be used autonomously by agents (default), which is normal for skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install stormglass - After installation, invoke the skill by name or use
/stormglass - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added a `version` field to the skill metadata.
- Introduced a `metadata` section specifying environment variable and binary requirements, as well as homepage and primary environment variable.
- No code or feature changes; documentation and metadata upgrade only.
v1.0.1
- Added a credential matrix section to clarify required environment variables for each input mode.
- No changes to code or CLI; documentation improvement only.
- Primary credential usage is now explicitly detailed for both live and mock modes.
v1.0.0
Initial release of Stormglass Surf Skill.
- Fetches surf-relevant ocean conditions from Stormglass API by spot name or coordinates, including tides, wind, gusts, and water temperature.
- Supports current readings and 1–3 day forecasts with configurable time horizons.
- Provides output as stable machine-readable JSON for agent pipelines.
- Resolves location names using Google Geocoding or OpenStreetMap if specified.
- Includes `--mock` mode for deterministic offline testing.
- Detailed error codes and environment variable requirements documented.
Metadata
Frequently Asked Questions
What is Stormglass Surf & Ocean Data?
Fetch surf-relevant ocean conditions from Stormglass by spot name or coordinates, including current snapshot and 1-3 day forecast windows with tides, gusts,... It is an AI Agent Skill for Claude Code / OpenClaw, with 525 downloads so far.
How do I install Stormglass Surf & Ocean Data?
Run "/install stormglass" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Stormglass Surf & Ocean Data free?
Yes, Stormglass Surf & Ocean Data is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Stormglass Surf & Ocean Data support?
Stormglass Surf & Ocean Data is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Stormglass Surf & Ocean Data?
It is built and maintained by Dirk Gorissen (@dgorissen); the current version is v1.0.2.
More Skills