Cleanup Review
python scripts/_reset_state.py is an optional cleanup helper for the NINA Warnings skill. It may recursively remove ~/.cache/skill_tmp, ~/.skill_state. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.
NINA Warnings
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
- Resolve the user location to an ARS code with
scripts/nina-lookup-ars.sh unless the user already provided a 12-digit ARS.
- Fetch current warnings with
scripts/nina-status.sh.
- Add
--details when the user needs description or instructions.
- Add
--geojson when geometry or machine-readable area data is needed.
- Use
--source <name> for nationwide feeds like mowas, dwd, katwarn, biwapp, lhp, or police.
- Summarize the result clearly:
active warnings, sender, severity, effective time, expiry if present.
- 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.
1---2name: nina-warnings3description: Read-only access to current German public warnings via the official NINA / warnung.bund.de API. Use when asked about NINA alerts, Bevölkerungswarnungen, civil protection alerts, weather warnings, flood warnings, Katwarn-style warning checks, or whether there are active warnings for a German city, district, or ARS region code.4---5
6
7
8
9### Cleanup Review
10
11`python scripts/_reset_state.py` is an optional cleanup helper for the `NINA Warnings` skill. It may recursively remove ~/.cache/skill_tmp, ~/.skill_state. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.
12
13# NINA Warnings
14
15Read current public warnings from the official German NINA API.
16Lese aktuelle oeffentliche Warnmeldungen ueber die offizielle deutsche NINA-API.
17
18Repository: [openclaw-skill-nina-warnings](https://github.com/wolf128058/openclaw-skill-nina-warnings)
19
20## Scope / Umfang
21
22- Read-only only. Do not modify systems, accounts, settings, or local state.
23- Nutze ausschliesslich lesende Zugriffe. Keine Schreiboperationen, keine Konfigurationsaenderungen.
24- The published skill is intentionally limited to public warning lookup via `warnung.bund.de`.
25- Dieser Skill ist bewusst auf die Abfrage oeffentlicher Warnungen ueber `warnung.bund.de` begrenzt.
26- No secrets, auth tokens, or private endpoints are required.
27- Es sind keine Zugangsdaten, Tokens oder privaten Endpunkte noetig.
28
29## Runtime
30
31- Requires `bash`, `curl`, and `jq`.
32- Benoetigt `bash`, `curl` und `jq`.
33- Public API base URL: `https://warnung.bund.de/api31`
34- Oeffentliche API-Basis-URL: `https://warnung.bund.de/api31`
35
36## Default Behavior / Standardverhalten
37
38- Accept either a German place/district name or a 12-digit ARS code.
39- Akzeptiere entweder einen deutschen Orts-/Kreisnamen oder einen 12-stelligen ARS-Code.
40- Normalize ARS values to district level before dashboard requests.
41- Normalisiere ARS-Werte vor Dashboard-Abrufen auf Kreisebene.
42- Prefer the helper script instead of handcrafted `curl`.
43- Bevorzuge das Helper-Skript statt manuellem `curl`.
44- If a place name resolves to multiple matches, use the best local cache match and mention ambiguity briefly if needed.
45- Wenn ein Ortsname mehrere Treffer hat, nutze den besten lokalen Cache-Treffer und erwaehne Mehrdeutigkeit kurz, falls noetig.
46
47## Quick Use / Schnellstart
48
49```bash
50~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000"
51~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "Berlin" --json
52~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000" --details
53~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh "110000000000" --geojson --json
54~/.openclaw/workspace/skills/nina-warnings/scripts/nina-status.sh --source dwd
55~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Berlin"
56```
57
58To find ARS codes for other cities or districts, use:
59Um ARS-Codes fuer weitere Staedte oder Landkreise zu finden, nutze:
60
61```bash
62~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg"
63~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg" --ars-only
64~/.openclaw/workspace/skills/nina-warnings/scripts/nina-lookup-ars.sh "Hamburg" --first
65```
66
67## Agent Workflow / Agenten-Workflow
68
691. Resolve the user location to an ARS code with `scripts/nina-lookup-ars.sh` unless the user already provided a 12-digit ARS.
702. Fetch current warnings with `scripts/nina-status.sh`.
713. Add `--details` when the user needs description or instructions.
724. Add `--geojson` when geometry or machine-readable area data is needed.
735. Use `--source <name>` for nationwide feeds like `mowas`, `dwd`, `katwarn`, `biwapp`, `lhp`, or `police`.
746. Summarize the result clearly:
75 active warnings, sender, severity, effective time, expiry if present.
767. If there are no warnings, say so plainly.
77
78## Output Guidance / Ausgabehinweise
79
80- Prefer concise summaries over raw JSON unless machine-readable output was requested.
81- Bevorzuge knappe Zusammenfassungen statt rohem JSON, ausser explizit angefordert.
82- Mention when an ARS was normalized to district level.
83- Erwaehne, wenn ein ARS auf Kreisebene normalisiert wurde.
84- Mention the resolved region when the user asked for a city or district.
85- Nenne die aufgeloeste Region, wenn der User nach einer Stadt oder einem Landkreis gefragt hat.
86- If lookup is ambiguous, say which match was used.
87- Wenn die Suche mehrdeutig ist, sage kurz, welcher Treffer verwendet wurde.
88- Do not overstate certainty beyond the API result.
89- Stelle keine groessere Sicherheit dar als die API hergibt.
90
91## Bundled Files / Enthaltene Dateien
92
93- `scripts/nina-status.sh`
94 Fetches and formats current warnings for an ARS code or location query.
95- `scripts/nina-lookup-ars.sh`
96 Resolves German place and district names to ARS candidates using the local cache.
97- `references/ars-codes.json`
98 Empty cache placeholder. Populate it during setup with installation-specific ARS mappings.
99
100## Notes / Hinweise
101
102- ARS = `Amtlicher Regionalschluessel`, 12 digits.
103- The dashboard endpoint returns an array of current warning objects or `[]`.
104- `references/ars-codes.json` contains the 16 German state capitals as bundled starter entries.
105- Add more cities or districts to `references/ars-codes.json` if you want local lookup beyond the bundled defaults.
106- Ergaenze `references/ars-codes.json` um weitere Staedte oder Landkreise, wenn du mehr als die mitgelieferten Standard-Eintraege lokal aufloesen willst.
107- This skill is suitable for a conservative ClawHub release because it is public, read-only, and has no credential handling.
knownasnaffy