From saos-orzecznictwo
Search and retrieve Polish court judgments via the SAOS REST API (System Analizy Orzeczen Sadowych, Fundacja ePanstwo). Use this skill whenever the user wants to find Polish case law - orzeczenia, wyroki, postanowienia - from sady powszechne, Sad Najwyzszy, Trybunal Konstytucyjny or Krajowa Izba Odwolawcza; search by case number (sygnatura), date range, court, judge, keyword, legal basis or referenced regulation; fetch full judgment text; or bulk-download the judgment corpus. Also trigger on "orzecznictwo PL", "SAOS", "szukaj wyroku", "sygnatura akt", "baza orzeczen". Companion to eu-sparql-search (which covers EU law / CJEU).
How this skill is triggered — by the user, by Claude, or both
Slash command
/saos-orzecznictwo:saos-orzecznictwoThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Polski konektor orzecznictwa dla projektu legal AI MateMatic. Komplementarny do
Polski konektor orzecznictwa dla projektu legal AI MateMatic. Komplementarny do
eu-sparql-search (CJEU / prawo UE): SAOS pokrywa sady krajowe RP.
https://www.saos.org.pl/api
Publiczne, otwarte REST API. Bez klucza, bez autoryzacji. Zwraca JSON.
API ma trzy czesci:
| Czesc | Sciezka | Do czego |
|---|---|---|
| Search API | /api/search/judgments | przeszukiwanie wg kryteriow, zwraca skroty + textContent |
| Browse API | /api/judgments/{id} | pelny obiekt pojedynczego orzeczenia |
| Dump API | /api/dump/judgments | hurtowe pobranie calej bazy + synchronizacja |
Pelna referencja parametrow, pol odpowiedzi i enumeracji → references/api.md
| courtType | Sad | Status |
|---|---|---|
COMMON | sady powszechne (rejonowe, okregowe, apelacyjne) | pelny |
SUPREME | Sad Najwyzszy | pelny |
CONSTITUTIONAL_TRIBUNAL | Trybunal Konstytucyjny | pelny |
NATIONAL_APPEAL_CHAMBER | Krajowa Izba Odwolawcza (zamowienia publiczne) | pelny |
ADMINISTRATIVE | sady administracyjne (WSA/NSA) | PUSTY - uzyj orzeczenia.nsa.gov.pl |
⚠️ Zakres SAOS (zweryfikowane na zywym API 2026-05-19). SAOS zawiera orzecznictwo biezace (~17 tys. z 2024, ~14 tys. z 2025+). Pokrycie nierowne wg typu sadu. Realne ograniczenia: brak WSA/NSA i artefakty OCR w datach.
Skrypt scripts/saos.py w tym skillu owija API. Z bash_tool:
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py search \
--all "RODO" --court SUPREME --from 2023-01-01 --size 10
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py get 352475
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py case "I ACa 772/13"
Przyklad inline Python bez zaleznosci → references/api.md
WAZNE: Uzywaj
urllibw bash_tool, NIEweb_fetch- URL-e SAOS z zapytan programowych beda odrzucone przez ograniczenia narzedziaweb_fetch.
caseNumber; temat → all lub keywords; akt → referencedRegulation.scripts/saos.py lub inline Python. Zacznij pageSize=10.Kazda odpowiedz oparta na tresci orzeczenia MUSI konczyc sie zrodlem. Bez tego uzytkownik nie odroznia realnego cytatu od halucynacji.
Format bloku zrodla na koncu odpowiedzi:
**Zrodlo:** Sad Apelacyjny w Lodzi, wyrok z 4.12.2013, sygn. I ACa 772/13
- SAOS: https://www.saos.org.pl/judgments/31345
- Oryginal sadu: http://api.orzeczenia.wroclaw.sa.gov.pl/...
pageSize ma twardy dolny limit 10 (400 WRONG REQUEST PARAMETER dla < 10).
Nie da sie pobrac 1 wyniku - bierz 10 i tnij.courtType=ADMINISTRATIVE zwraca pustke. Dla WSA/NSA odeslij do orzeczenia.nsa.gov.pl.judgmentDate:"3013-12-04", "2101-04-14").
Sortowanie DESC wypycha te rekordy na gore. Filtruj jawnie judgmentDateTo=<dzis>.textContent zawiera znaczniki HTML (<p>, <em> wokol trafien). Zdejmij
znaczniki przed cytowaniem (html.parser / regex).all - proste wyszukiwanie pelnotekstowe.
Zlozone zapytania rozbijaj na kilka wywolan./api/commonCourts bez id → 404). Id sadu bierz
z pola division w wynikach orzeczen.urllib.parse.urlencode robi to sam).Ten skill to warstwa live query dla SAOS. Komplementarny do:
legal-data-hunter-pl - warstwa harvestu/katalogu. Uzywa tylko Dump API
(hurtowe archiwum do lokalnego korpusu RODO-safe).eu-sparql-search - prawo UE / orzecznictwo CJEU.Realna luka: orzecznictwo sadow administracyjnych (WSA/NSA) - SAOS nie indeksuje.
Potrzebny osobny konektor do orzeczenia.nsa.gov.pl.
mcp-saos (6 disclaimerow + filtr judgmentDateTo).Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub matematicsolutions/awesome-matematic-skills-pl --plugin saos-orzecznictwo