Skill: RIS Rechtsprechung (Österreich)

Du recherchierst österreichische Gerichtsentscheidungen über die offene RIS-API v2.6 (Rechtsinformationssystem des Bundes, betrieben vom Bundeskanzleramt). Die API ist authentifizierungsfrei und liefert JSON.

Scope dieses Skills: nur Rechtsprechung (Judikatur), nur Metadaten + Link. Es wird kein Volltext heruntergeladen oder konvertiert. Bundes- und Landesrecht sind nicht enthalten.

Wann diesen Skill anwenden

Hauptpfad — thematische / explorative Recherche im Chat:

• nach Stichworten / Schlagworten (--suchworte, --schlagworte)
• in einem bestimmten Zeitraum (--von / --bis)
• bei einer bestimmten Gerichtsbarkeit (--applikation)

Beispiele, die diesen Skill triggern:

• „Gibt es OGH-Judikatur zu Mietzinsminderung in der Pandemie?"
• „Aktuelle BVwG-Entscheidungen zu Afghanistan-Asyl seit 2023"
• „Was sagt der VfGH zur Versammlungsfreiheit?"

Sekundärpfade (technisch unterstützt, aber meist im RIS-Web-Frontend schneller — nur nutzen, wenn der User explizit darum bittet oder die Suche aus dem Chat-Kontext heraus eindeutig per Skript schneller geht):

• Geschäftszahl-Lookup (--geschaeftszahl)
• Norm-Suche (--norm "ABGB §1319a")
• Rechtssatznummer-Lookup (--rechtssatznummer RS0123456)

Norm-Suche → Rechtssätze: bei reiner --norm-Suche (ohne --suchworte) liefert die OGD-API per Default überwiegend Rechtssätze, kaum Volltext-Entscheidungen — Rechtssätze sind im Norm-Index hinterlegt, Entscheidungstexte erst über die zusätzlichen Flags SucheNachRechtssatz / SucheNachText. Das Skript sendet diese Flags bewusst nur bei --suchworte-Suchen, weil bei reiner Norm-Recherche Rechtssätze i. d. R. die gewollte Trefferart sind.

Nicht anwenden, wenn:

• die Frage rein dogmatisch / rechtspolitisch ist, ohne Bezug zu einer konkreten Entscheidung (z. B. „Was sagt die Lehre zu §..." → Kommentar, nicht RIS),
• Bundes-/Landesrecht gemeint ist (Gesetzestext, nicht Rechtsprechung),
• nach EuGH/EGMR-Urteilen gefragt wird (RIS enthält nur österreichische Gerichte; ggf. wird die österreichische Folgejudikatur gesucht — dann Skill anwenden, aber den Hinweis geben),
• nach laufenden Verfahren oder Pressemitteilungen gefragt wird (RIS enthält nur veröffentlichte Entscheidungen).

API-Grundlagen

• Base-URL: https://data.bka.gv.at/ris/api/v2.6/
• Endpoint Rechtsprechung: GET /Judikatur
• Response-Format: JSON (Accept: application/json)
• Keine Auth, keine Quotas, aber:
  • Bei Pagination 1–2 s Pause zwischen Seiten einlegen.
  • Massenabfragen außerhalb 06–18 Uhr (MEZ) oder am Wochenende.
  • Bei Fehlern Geduld haben — das System teilt sich Ressourcen mit dem Web-Frontend.

Pflichtparameter

Applikation (genau einer):

Wert	Gericht/Behörde
Justiz	OGH, OLG, LG, BG (Zivil-/Strafgerichtsbarkeit) — Standard
Vfgh	Verfassungsgerichtshof
Vwgh	Verwaltungsgerichtshof
Bvwg	Bundesverwaltungsgericht
Lvwg	Landesverwaltungsgerichte
Dsk	Datenschutzbehörde (vormals -kommission)
AsylGH	Asylgerichtshof (historisch, bis 2013)
Normenliste	Normprüfungs-/Normenliste
Pvak	Personalvertretungs-Aufsichtskommission
Gbk	Gleichbehandlungskommission
Dok	Disziplinarkommission

Plus mindestens einer dieser Suchparameter (sonst HTTP 400):

Parameter	Beispiel	Hinweis
Suchworte	Mietzinsminderung	URL-encoden; * nur am Wortende; AND/OR/NOT. OGD-API-Einschränkung: nur ein Platzhalter pro Wort (Web-Frontend toleriert mehrere).
Geschaeftszahl	5Ob234/20b	exakte Aktenzeichen-Suche
Norm	ABGB §1319a	Format: {Gesetzeskürzel} §{Paragraph} (kanonische Zitierform) — andere Reihenfolgen wie 1319a ABGB liefern fast keine Treffer. Fehlt nur das §-Zeichen (ArbVG 105), ergänzt das Skript es automatisch und schreibt einen Hinweis in den Output. Für EU-Verordnungen (z. B. DSGVO) ist der Norm-Index unzuverlässig; lieber Volltextsuche via Suchworte.
Rechtssatznummer	RS0123456	bei OGH-Rechtssatz-Suche
Schlagworte	Datenschutz	kontrolliertes RIS-Vokabular
EntscheidungsdatumVon / Bis	2024-01-01	ISO-Datum

Optional:

• SucheNachRechtssatz, SucheNachText — steuern, in welchen Feldern das Suchworte-Token gesucht wird (Rechtssatz-Text vs. Entscheidungstext). Nicht ein Filter für Trefferarten — auch mit --no-rechtssatz können Rechtssatz-Dokumente zurückkommen, wenn der Suchbegriff im Volltext gefunden wurde. Das Skript sendet die Flags nur bei --suchworte-Suchen.
• ImRisSeit ∈ {Undefined, EinerWoche, EinemMonat, DreiMonaten, SechsMonaten, EinemJahr}
• Sortierung ∈ {Datum, Geschaeftszahl, Relevanz} — die API toleriert weitere Werte; nur die hier gelisteten sind in den RIS-Handbüchern dokumentiert. Skript-Default: setzt das Skript weder --sortierung noch --sort-direction, sortiert es nach Datum/Descending (im Chat-Kontext meist gewollt — „aktuelle Judikatur zu …"). Der API-Default Relevanz ist mit --sortierung Relevanz zurückzuholen.
• SortDirection ∈ {Ascending, Descending}

Pagination:

• DokumenteProSeite ∈ {Ten, Twenty, Fifty, OneHundred} — Default Twenty
• Seitennummer (1-basiert) — bei --alle-seiten der Einstiegspunkt
• Auto-Pagination: --alle-seiten holt mehrere Seiten automatisch, bis Treffer erschöpft oder --max-seiten N (Default 5) erreicht. RIS-konforme Pause zwischen Seiten konfigurierbar via --pause-pagination (Default 1.5 s). Default-Cap: 5 × 20 = 100 Treffer. Für breite Themen-Recherchen mit --pro-seite Fifty --alle-seiten --max-seiten 5 bis zu 250 Treffer auf einmal.

Empfohlenes Vorgehen

Verwende immer das beigelegte Skript scripts/ris_search.py (Python 3, nur Standardbibliothek). Es kapselt URL-Bau, Pflichtparameter-Validierung, JSON-Parsing und Rendering in einem Aufruf.

1. Mapping: User-Frage → --applikation + Suchparameter. Bei Unsicherheit --applikation Justiz + Volltext-Suche.

2. Aufruf — das Skript liegt immer bei scripts/ris_search.py relativ zum Skill-Ordner (dem Verzeichnis, das diese SKILL.md enthält). Der absolute Pfad zum Skill-Ordner hängt von der Umgebung ab; Du als ausführendes Modell weißt, in welcher Umgebung Du läufst.

   Generisches Aufrufmuster — cd in den Skill-Ordner, dann relativ aufrufen. Standard-Chat-Recherche (Themensuche mit Auto-Pagination):

   cd <skill-folder> && python scripts/ris_search.py \
     --applikation Justiz \
     --suchworte "Mietzinsminderung" \
     --von 2020-01-01 --bis 2024-12-31 \
     --pro-seite Fifty --alle-seiten --max-seiten 3
   

   Liefert bis zu 150 Treffer, sortiert nach Datum absteigend (Default).

   Python-Aufruf je Umgebung — probiere in dieser Reihenfolge: python → python3 → py -3. Üblicherweise:

   • Linux / macOS / Claude.ai-Sandbox: python3 oder python
   • Windows (Claude Code): py -3 (python3 fehlt meist im PATH)

   Skill-Ordner je Umgebung — typische Pfade:

   • Claude Code (Linux/macOS): ~/.claude/skills/ris-rechtsprechung/
   • Claude Code (Windows): %USERPROFILE%\.claude\skills\ris-rechtsprechung\
   • Claude.ai Custom Skills: vom Harness gemounteter Pfad (meist unter /mnt/skills/... oder /home/.../skills/...); folge der Pfadangabe, die Dir der Skill-Loader liefert.

   Falls cd in der Umgebung nicht zur Verfügung steht (manche Sandboxes), verwende den absoluten Pfad zum Skript, z. B.:

   python "<skill-folder>/scripts/ris_search.py" --applikation Justiz ...
   

   Ausgabe ist Markdown (Default) oder strukturiertes JSON (--json).

3. Antwort an den User: die Top-Treffer mit Geschäftszahl, Datum, Leitsatz (sofern vorhanden) und RIS-Link weitergeben. Bei mehr als 10 Treffern die ersten 10 ausführlich, den Rest als Bullet-Liste.

4. Pagination: bei mehr als einer Seite vor jeder weiteren Anfrage ca. 1,5 s warten (RIS-Empfehlung).

Skript-Output

Default (Markdown). Für Rechtssatz-Dokumente (häufigster Fall bei Norm-Suchen — Rechtssätze sind im Norm-Index hinterlegt):

**Treffer:** 7 (Seite 1, 10 pro Seite)

### 1. OGH 2 Ob 554/86 vom 28.10.1986 [Rechtssatz RS0051942]
**Norm:** ArbVG §105 Abs3 Z2 litb
- [Rechtssatz im RIS](https://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Justiz&Dokumentnummer=JJR_19861028_OGH0002_0020OB00554_8600000_007)
- [Volltext der Stammentscheidung](https://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Justiz&Dokumentnummer=JJT_19861028_OGH0002_0020OB00554_8600000_000)
_Auch zitiert in 21 weiteren Entscheidungen._

Für Volltext-Dokumente:

### 2. OGH 5 Ob 234/20b vom 15.04.2021 [Volltext]
_Leitsatz:_ ...
**Norm:** ABGB §1119
- [Zur Entscheidung im RIS](https://ris.bka.gv.at/Dokumente/Justiz/JJT_20210415_OGH0002_.../JJT_....html)

Anmerkungen

• Heading aus Stamm-Entscheidung: Bei Rechtssätzen liefert die API in Geschaeftszahl eine Verkettung aller zitierenden Geschäftszahlen und in Entscheidungsdatum das jüngste Update-Datum. Beides ist irreführend. Wir nutzen stattdessen Justiz.Entscheidungstexte.item[0] — die Stamm-Entscheidung — als Quelle für Heading-GZ + Datum.
• Volltext-URL bei Rechtssätzen: kommt direkt aus der API (Stamm- DokumentUrl), nicht mehr aus der Heuristik. Die Heuristik bleibt als Fallback für seltene Sonderfälle.
• Gericht aus Technisch.Organ (zuverlässiger als Justiz.Gericht). Fallback auf Applikation.
• Rechtssatznummer im Doktyp-Label: [Rechtssatz RS0051942] — praktisch zum Zitieren.
• „Auch zitiert in N weiteren Entscheidungen": Anzahl − 1 (die Stamm zählt nicht), nur ausgegeben wenn N > 1.
• Datumsformat: ISO-Datum → DD.MM.YYYY.

JSON-Output

--json liefert ein normalisiertes Objekt mit allen Feldern:

{
  "total_hits": 7, "page": 1, "page_size": 10,
  "documents": [
    {
      "dokumentnummer": "JJR_19861028_OGH0002_0020OB00554_8600000_007",
      "applikation": "Justiz",
      "gericht": "OGH",
      "doc_type": "Rechtssatz",          // "Volltext" | "Rechtssatz" | null
      "rechtssatznummer": "RS0051942",   // null bei Volltext-Dokumenten
      "geschaeftszahl": "2 Ob 554/86",   // Stamm-GZ aus Entscheidungstexte[0]
      "geschaeftszahlen": [...],         // ALLE zitierenden GZ
      "entscheidungsdatum": "1986-10-28", // Stamm-Datum
      "leitsatz": null,                  // Bei Rechtssätzen meist null
      "normen": ["ArbVG §105 Abs3 Z2 litb"],
      "fachgebiete": [],
      "entscheidungstexte_count": 22,
      "link": "https://www.ris.bka.gv.at/Dokument.wxe?...JJR_..._007",
      "volltext_url": "https://www.ris.bka.gv.at/Dokument.wxe?...JJT_..._000",
      "content_urls": { "html": "...", "pdf": "...", "xml": "...", "rtf": "..." }
    }
  ]
}

doc_type und rechtssatznummer sind nur bei OGH/VfGH/VwGH-Dokumenten zuverlässig gesetzt (J{Court}{T|R}-Konvention). Andere Applikationen (BVWG, LVWG, DSB u. a.) folgen der Konvention nicht; dort bleibt doc_type = null.

--raw gibt die unveränderte API-Antwort aus, falls du selbst parsen willst.

Direkte HTML-Volltext-URLs

Aus der Dokumentennummer ableitbar (Präfix → Pfad):

Präfix	Pfad
JJT, JJR	https://ris.bka.gv.at/Dokumente/Justiz/{nr}/{nr}.html
JFT, JFR	https://ris.bka.gv.at/Dokumente/Vfgh/{nr}/{nr}.html
JWT, JWR	https://ris.bka.gv.at/Dokumente/Vwgh/{nr}/{nr}.html
BVWG	https://ris.bka.gv.at/Dokumente/Bvwg/{nr}/{nr}.html
LVWG	https://ris.bka.gv.at/Dokumente/Lvwg/{nr}/{nr}.html
DSB	https://ris.bka.gv.at/Dokumente/Dsk/{nr}/{nr}.html
GBK	https://ris.bka.gv.at/Dokumente/Gbk/{nr}/{nr}.html
PVAK	https://ris.bka.gv.at/Dokumente/Pvak/{nr}/{nr}.html

Validierung: Dokumentennummern matchen ^[A-Z][A-Z0-9_]+$, Länge 5–50. Das Skript leitet diesen Link automatisch ab und stellt ihn unter link bzw. content_urls.html bereit.

Volltext-Download ist explizit nicht Teil dieses Skills. Wenn der User den Volltext einer Entscheidung will, gib ihm den Link aus dem Trefferdatensatz und überlasse ihm das Lesen.

Web-Search-Fallback (bei 0 API-Treffern)

Bei Suchworte-Anfragen mit 0 Treffern erzeugt das Skript automatisch eine Google site:-Such-Query nach dem Muster

site:ris.bka.gv.at <Applikation> <Suchworte> [<Norm>] ["<Geschaeftszahl>"] [after:<Jahr>] [before:<Jahr>]

und gibt sie zusammen mit dem Hinweis aus. Hintergrund: Google indexiert das RIS-Web-Frontend deutlich breiter als der OGD-API-Volltext-Index — insbesondere bei alten Entscheidungen (vor ca. 1990), wo der API-Volltext oft amputiert oder gar nicht durchsuchbar ist.

Wenn Du in einem Claude-Kontext mit web_search-Tool läufst: sobald Du die Query im Output siehst, übergib sie unverändert an das web_search-Tool. Aus den Treffern extrahierst Du RIS-URLs der Form https://www.ris.bka.gv.at/Dokument.wxe?Abfrage=…&Dokumentnummer=… und holst Dir bei Bedarf den Volltext mit web_fetch. Daraus baust Du dann dieselben Trefferzeilen wie aus der API-Antwort (Geschäftszahl, Datum, Leitsatz/Rechtssatz, Link).

Das Skript selbst führt keine Web-Suche aus — die Logik bleibt bei Claude. Im JSON-Output ist die Query als websearch_query-Feld verfügbar; im Markdown-Output steht sie im Hinweis-Block am Ende der Trefferliste.

Fehlerfälle

• HTTP 400 → mindestens einen Suchparameter ergänzen oder spezifischer machen.
• 0 Treffer → Suche entschärfen (allgemeinere Suchworte, größerer Zeitraum, andere Applikation).
• 0 Treffer bei Suchworte trotz nachweisbarem Vorkommen → Bekannte Limitation des OGD-Volltext-Index, insbesondere bei alten Entscheidungen (vor ca. 1990). Der Volltext kann existieren und das Suchwort enthalten, ohne dass der API-Index ihn findet. Das Skript generiert in diesem Fall automatisch eine Google site:-Such-Query als Fallback (siehe Abschnitt Web-Search-Fallback).
• Timeout → einmal mit kleinerem --pro-seite wiederholen (das Skript retried automatisch zwei Mal mit 2/4 s Pause).
• API-Pflichtparameter unbekannt → Default-Pfad: --applikation Justiz, --suchworte ... setzen.

Installation

Im Repo liegt der Skill unter recherche-ris-rechtsprechung/skill-draft/ris-rechtsprechung/ und ist self-contained: ein Ordner mit SKILL.md und scripts/ris_search.py. Da das Skript ausschließlich die Python-Standardbibliothek nutzt, ist keine Build-Phase und keine Pip-Installation nötig.

Claude Code (lokal, Linux/macOS)

mkdir -p ~/.claude/skills
cp -r recherche-ris-rechtsprechung/skill-draft/ris-rechtsprechung \
      ~/.claude/skills/

Claude Code (lokal, Windows — PowerShell)

$dest = "$env:USERPROFILE\.claude\skills"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item -Recurse -Force `
  "recherche-ris-rechtsprechung\skill-draft\ris-rechtsprechung" `
  $dest

Claude.ai Custom Skills (Web-App)

1. Skill-Ordner als ZIP packen:

   cd recherche-ris-rechtsprechung/skill-draft/
   zip -r ris-rechtsprechung.zip ris-rechtsprechung/
   

   PowerShell:

   Compress-Archive -Path "recherche-ris-rechtsprechung\skill-draft\ris-rechtsprechung" `
                    -DestinationPath ris-rechtsprechung.zip -Force
   

2. Claude.ai → Settings → Capabilities → Skills → Upload skill → ZIP-Datei auswählen.
3. Wichtig: Im selben Settings-Bereich unter Web search & code execution → Network access die folgenden Hosts freigeben. Falls Claude.ai Wildcards akzeptiert, deckt *.bka.gv.at alle drei mit einem Eintrag ab.
   • data.bka.gv.at — OGD-API (Pflicht; ohne das blockt die Sandbox alle Skript-Aufrufe).
   • ris.bka.gv.at — RIS-Direkt-HTML-URLs der Form /Dokumente/Justiz/JJT_…/JJT_….html (abgeleitete „Volltext (vermutet)"-Links bei Rechtssatz-Treffern; Hinweis-Link auf die RIS-Web-Suche https://www.ris.bka.gv.at/Judikatur/ bei 0 Volltext-Treffern).
   • www.ris.bka.gv.at — Dokument.wxe?…-URLs, die die API selbst in der Trefferliste zurückgibt.

Endstruktur (überall identisch)

ris-rechtsprechung/
├── SKILL.md
└── scripts/ris_search.py

Voraussetzung: Python ≥ 3.9 in der ausführenden Umgebung. Keine Pip-Pakete nötig.

Lizenz, Namensnennung, Disclaimer

Die über die OGD-Schnittstelle bezogenen RIS-Daten stehen unter Creative Commons Namensnennung 4.0 International (CC BY 4.0). Bei Wiedergabe ist die Quelle zu nennen — das Skript hängt deshalb an jeden Markdown-Output automatisch eine Attribution-Zeile (Quelle: RIS, Bundeskanzleramt — CC BY 4.0) und im JSON-Output ein attribution-Feld.

Rechtlich verbindlich ist laut Bundeskanzleramt ausschließlich der Wortlaut im Bundesgesetzblatt (Applikation „Bundesgesetzblatt authentisch") bzw. in den jeweiligen Landesgesetzblättern. Der OGD-Datenbestand wird ohne Gewähr für Richtigkeit, Aktualität oder Vollständigkeit bereitgestellt. Wenn Du RIS-Treffer im Chat ausgibst, formuliere entsprechend — die zurückgelieferten Texte sind Recherchehilfe, keine authentische Rechtsquelle.

Massenabfragen: ein durchschnittlicher Skill-Aufruf (bis 5 Seiten × 100 Treffer) ist unbedenklich. Wer den Skill systematisch über den Tag verteilt nutzt oder --max-seiten deutlich hochdreht, sollte das RIS-Team unter ris.it@bka.gv.at vorab informieren (siehe OGD-FAQ), um nicht versehentlich als DDoS-Verkehr klassifiziert zu werden.

Quellen

• Offizielle Doku-PDF: https://data.bka.gv.at/ris/ogd/v2.6/Documents/Dokumentation_OGD-RIS_API.pdf
• OGD-FAQ: https://www.ris.bka.gv.at/RisInfo/OGD-FAQ.pdf
• Datensatz-Eintrag: https://www.data.gv.at/katalog/dataset/ris2_6
• Referenz-Implementierungen:
  • shrinkwrap-legal/shrinkwrap-legal-api (Java/Spring)
  • philrox/ris-mcp-ts (TypeScript MCP-Server)
• Kontakt für API-Fragen: ris.it@bka.gv.at