← 返回 Skills 市场
Stormglass Surf & Ocean Data
作者
Dirk Gorissen
· GitHub ↗
· v1.0.2
525
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install stormglass
功能描述
Fetch surf-relevant ocean conditions from Stormglass by spot name or coordinates, including current snapshot and 1-3 day forecast windows with tides, gusts,...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install stormglass - 安装完成后,直接呼叫该 Skill 的名称或使用
/stormglass触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 525 次。
如何安装 Stormglass Surf & Ocean Data?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install stormglass」即可一键安装,无需额外配置。
Stormglass Surf & Ocean Data 是免费的吗?
是的,Stormglass Surf & Ocean Data 完全免费(开源免费),可自由下载、安装和使用。
Stormglass Surf & Ocean Data 支持哪些平台?
Stormglass Surf & Ocean Data 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Stormglass Surf & Ocean Data?
由 Dirk Gorissen(@dgorissen)开发并维护,当前版本 v1.0.2。
推荐 Skills