NINA Warnings

Read-only access to current German public warnings via the official NINA / warnung.bund.de API. Use when asked about NINA alerts, Bevölkerungswarnungen, civi...

Security Scan

The skill is internally coherent: it requires only bash/curl/jq, reads a local ARS cache and the public warnung.bund.de API, and contains read-only helper scripts that match the declared purpose.

Purpose & Capability

Name/description match the actual requirements and behavior. Required binaries (bash, curl, jq), local ARS cache, and use of the official NINA API are appropriate and expected for a read-only warning-lookup skill.

Instruction Scope

SKILL.md and scripts limit actions to resolving locations via a local cache and fetching public endpoints on warnung.bund.de. There are no instructions to read unrelated files, access credentials, or transmit data to third-party endpoints.

Install Mechanism

No install spec — instruction-only plus included helper scripts. No downloads or archive extraction; all code is present in the bundle and no external installers are invoked.

Credentials

The skill requests no environment variables or credentials. The only external access is to the public NINA API; local config is limited to the optional references/ars-codes.json cache.

Persistence & Privilege

always:false and no code attempts to modify system-wide settings or other skills. The skill uses only its own script directory and a local references file; no elevated persistence or privilege requested.

Assessment

This skill appears safe and does exactly what it says: resolve German place names (using a local cache) and fetch public warning data from https://warnung.bund.de. It requires network access and the binaries bash/curl/jq. Review references/ars-codes.json if you want additional local lookup entries, and verify your environment allows outbound HTTPS to warnung.bund.de. If you have strict network or privacy policies, confirm that outgoing requests to warnung.bund.de are acceptable; otherwise no credentials or other sensitive data are requested.

Read current public warnings from the official German NINA API. Lese aktuelle oeffentliche Warnmeldungen ueber die offizielle deutsche NINA-API.

Repository: openclaw-skill-nina-warnings

Scope / Umfang

• Read-only only. Do not modify systems, accounts, settings, or local state.
• Nutze ausschliesslich lesende Zugriffe. Keine Schreiboperationen, keine Konfigurationsaenderungen.
• The published skill is intentionally limited to public warning lookup via warnung.bund.de.
• Dieser Skill ist bewusst auf die Abfrage oeffentlicher Warnungen ueber warnung.bund.de begrenzt.
• No secrets, auth tokens, or private endpoints are required.
• Es sind keine Zugangsdaten, Tokens oder privaten Endpunkte noetig.

Runtime

• Requires bash, curl, and jq.
• Benoetigt bash, curl und jq.
• Public API base URL: https://warnung.bund.de/api31
• Oeffentliche API-Basis-URL: https://warnung.bund.de/api31

Default Behavior / Standardverhalten

• Accept either a German place/district name or a 12-digit ARS code.
• Akzeptiere entweder einen deutschen Orts-/Kreisnamen oder einen 12-stelligen ARS-Code.
• Normalize ARS values to district level before dashboard requests.
• Normalisiere ARS-Werte vor Dashboard-Abrufen auf Kreisebene.
• Prefer the helper script instead of handcrafted curl.
• Bevorzuge das Helper-Skript statt manuellem curl.
• If a place name resolves to multiple matches, use the best local cache match and mention ambiguity briefly if needed.
• Wenn ein Ortsname mehrere Treffer hat, nutze den besten lokalen Cache-Treffer und erwaehne Mehrdeutigkeit kurz, falls noetig.

Quick Use / Schnellstart

~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000"
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "Berlin" --json
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000" --details
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000" --geojson --json
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh --source dwd
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Berlin"

To find ARS codes for other cities or districts, use: Um ARS-Codes fuer weitere Staedte oder Landkreise zu finden, nutze:

~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg"
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg" --ars-only
~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg" --first

Agent Workflow / Agenten-Workflow

1. Resolve the user location to an ARS code with scripts/nina-lookup-ars.sh unless the user already provided a 12-digit ARS.
2. Fetch current warnings with scripts/nina-status.sh.
3. Add --details when the user needs description or instructions.
4. Add --geojson when geometry or machine-readable area data is needed.
5. Use --source <name> for nationwide feeds like mowas, dwd, katwarn, biwapp, lhp, or police.
6. Summarize the result clearly: active warnings, sender, severity, effective time, expiry if present.
7. If there are no warnings, say so plainly.

Output Guidance / Ausgabehinweise

• Prefer concise summaries over raw JSON unless machine-readable output was requested.
• Bevorzuge knappe Zusammenfassungen statt rohem JSON, ausser explizit angefordert.
• Mention when an ARS was normalized to district level.
• Erwaehne, wenn ein ARS auf Kreisebene normalisiert wurde.
• Mention the resolved region when the user asked for a city or district.
• Nenne die aufgeloeste Region, wenn der User nach einer Stadt oder einem Landkreis gefragt hat.
• If lookup is ambiguous, say which match was used.
• Wenn die Suche mehrdeutig ist, sage kurz, welcher Treffer verwendet wurde.
• Do not overstate certainty beyond the API result.
• Stelle keine groessere Sicherheit dar als die API hergibt.

Bundled Files / Enthaltene Dateien

• scripts/nina-status.sh Fetches and formats current warnings for an ARS code or location query.
• scripts/nina-lookup-ars.sh Resolves German place and district names to ARS candidates using the local cache.
• references/ars-codes.json Empty cache placeholder. Populate it during setup with installation-specific ARS mappings.

Notes / Hinweise

• ARS = Amtlicher Regionalschluessel, 12 digits.
• The dashboard endpoint returns an array of current warning objects or [].
• references/ars-codes.json contains the 16 German state capitals as bundled starter entries.
• Add more cities or districts to references/ars-codes.json if you want local lookup beyond the bundled defaults.
• Ergaenze references/ars-codes.json um weitere Staedte oder Landkreise, wenn du mehr als die mitgelieferten Standard-Eintraege lokal aufloesen willst.
• This skill is suitable for a conservative ClawHub release because it is public, read-only, and has no credential handling.