feat(skills): add markitdown document converter and regensburg-stadtrat civic intelligence skills

2026-09-12 09:15:16 +02:00
parent e2944efb3e
commit 71e8909251
5 changed files with 767 additions and 0 deletions
@@ -0,0 +1,68 @@
+---
+name: regensburg-stadtrat
+description: Municipal politics, city council resolutions, meeting agendas, and Ratsinformation for the City of Regensburg (ALLRIS net). Use when the user asks about Regensburg city council politics, upcoming council or committee meetings (Stadtrat, Ausschüsse), local building/traffic decisions (e.g. Stadtbahn, Kaufhof, Radwege, Schulen), or specific Vorlagen and Beschlüsse.
+---
+
+# 🏛️ Regensburg Stadtrat & Ratsinformationssystem (ALLRIS)
+
+Query the Regensburg municipal council information system (**ALLRIS net** on `srv19.regensburg.de/bi/`) for real-time meeting schedules, committee agendas, council proposals (*Vorlagen*), and binding resolutions (*Beschlüsse*).
+
+## 🚀 Quick Usage
+
+Use `scripts/regensburg_ris.py`. The tool auto-executes via `uv` and interfaces directly with ALLRIS XML feeds and search endpoints.
+
+### 1. Search Council Documents & Resolutions
+Search by keyword (e.g., "Kaufhof", "Stadtbahn", "Haushalt", "Klimaschutz"):
+```bash
+python3 scripts/regensburg_ris.py search "Kaufhof" --limit 10
+```
+
+### 2. View Meeting Calendar (Upcoming or Recent)
+See what council or committee meetings are scheduled:
+```bash
+# Next 30 days
+python3 scripts/regensburg_ris.py calendar --days 30
+
+# Specific date range
+python3 scripts/regensburg_ris.py calendar --from-date 01.09.2026 --to-date 30.09.2026
+```
+
+### 3. Inspect a Meeting Agenda (TOPs)
+Fetch all agenda items (Tagesordnungspunkte) and linked proposal IDs for a meeting ID (`SILFDNR`):
+```bash
+python3 scripts/regensburg_ris.py session 2665
+```
+
+### 4. Read a Vorlage & Extract Resolutions
+View proposal metadata, responsible departments, voting results, and exact resolution text:
+```bash
+python3 scripts/regensburg_ris.py vorlage 21362
+```
+
+To automatically download and convert linked PDF attachments to Markdown using the `markitdown` skill:
+```bash
+python3 scripts/regensburg_ris.py vorlage 21362 --convert-attachments
+```
+
+### 5. Compile a Topic Dossier for Knowledge-Wiki
+Compile a multi-document synthesis and automatically file it into the Obsidian `knowledge-wiki`:
+```bash
+python3 scripts/regensburg_ris.py compile-topic "Kaufhof" --vault /Users/moritz/src/infrapuzzle/knowledge-wiki
+```
+
+---
+
+## 🏛️ Major Committees in Regensburg
+- **Stadtrat der Stadt Regensburg**: Full city council plenum chaired by Oberbürgermeisterin Gertrud Maltz-Schwarzfischer.
+- **Ausschuss für Stadtplanung, Verkehr und Wohnungsfragen**: Urban development, mobility, zoning, housing.
+- **Ausschuss für Verwaltung, Finanzen und Beteiligungen**: Budget, municipal companies, personnel.
+- **Ausschuss für Umweltfragen, Natur- und Klimaschutz**: Environmental policy, energy, climate transition.
+- **Ausschuss für Wirtschaft**: Local business, commerce, downtown vitality.
+- **Sportausschuss / Kulturausschuss / Ausschuss für Bildung**: Sports, culture, schools, and daycares.
+
+---
+
+## 💡 Best Practices for OpenClaw
+- **Always Cite Sources**: Provide the exact Vorlagen code (e.g. `VO/25/21865/61`) and direct ALLRIS URL in responses.
+- **Check Resolution Outcomes**: When examining controversial topics or motions, check whether an Antrag was *zurückgezogen* (withdrawn), *durch Bericht erledigt* (settled by report), or *beschlossen* (enacted).
+- **Combine with `markitdown`**: When deep technical details (such as urban planning maps, budget numbers, or expert appraisals) are in PDF attachments, pass them to `skills/markitdown/scripts/convert_to_markdown.py`.