prawo — Claude Code skill for Polish law
The prawo Claude Code skill looks up Polish laws through the Sejm’s official API. It finds articles, act status, and amendment details.
MIT ★ 60 updated 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install prawo@polskie-skilleWhat prawo does
prawo fetches Polish legal acts from the Sejm’s official API and returns structured JSON. It can search titles, check whether an act is in force, find its latest consolidated text, and list amendments with their effective dates, including future changes.
For an article lookup, the script reports the source document and wording date, along with later amendments. Some documents have no HTML version; when the text is available only as a PDF, the script cannot extract the article. The skill requires Python 3.8+ and network access to api.sejm.gov.pl; it uses only the Python standard library.
The output is legal text, not advice for an individual case. To install through the Claude Code marketplace, run /plugin marketplace add b44x/ai-polish-skills, followed by /plugin install prawo@polskie-skille.
What it helps with
- retrieve a specific article from a Polish code
- check whether a Polish act is in force
- find an act’s latest consolidated text
- list amendment effective dates
- search for an act by words in its title
Example prompts for the agent
- Find article 30 of the Polish Labour Code and give its source and wording date.
- Check whether the Polish VAT Act is in force and find its latest consolidated text.
- List amendments to the Polish Labour Code with their effective dates.
How to install prawo
1Plugin marketplace
/plugin marketplace add b44x/ai-polish-skills/plugin install prawo@polskie-skilleThis installs the whole prawo plugin with all its skills
2Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill prawo -a claude-code3Manually: put the files in place
~/.claude/skills/prawo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prawo/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill prawo -a codex2Manually: put the files in place
.agents/skills/prawo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill prawo -a cursor2Manually: put the files in place
.cursor/skills/prawo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/prawo2Manually: put the files in place
.github/skills/prawo/SKILL.md1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill prawo -a gemini-cli2Platform CLI
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/prawoManually: put the files in place
.devin/skills/prawo/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about prawo
How do I install prawo in Claude Code?
In Claude Code, run /plugin marketplace add b44x/ai-polish-skills, then run /plugin install prawo@polskie-skille.
What does prawo do?
It searches Polish legal acts and returns article text, act status, consolidated versions, and amendment details. Its source is the Sejm’s official API.
What does prawo need to run?
It requires Python 3.8+ and network access to api.sejm.gov.pl. The script uses the Python standard library.
Source text
SKILL.md · MIT
---
name: prawo
display_name: Prawo (ISAP / Dziennik Ustaw)
version: 1.0.0
description: >-
Official Polish legal acts from the Sejm ELI API (ISAP: Dziennik Ustaw, Monitor Polski).
Read the wording of a specific article of a code or statute, together with the source
document and date, and a warning about amendments that entered into force later. Check whether an
act is in force, find its latest consolidated text (tekst jednolity), list amendments with
entry-into-force dates (including upcoming ones), and search acts by title. Shortcuts for the main
codes (kp, kc, kk, kpc, ksh, kpa, vat, pit, cit, op…). Use whenever the user asks about Polish law,
e.g. "co mówi art. 30 Kodeksu pracy", "okres wypowiedzenia umowy o pracę", "czy ta ustawa
obowiązuje", "tekst jednolity ustawy o VAT", "kiedy wchodzą zmiany w Kodeksie pracy",
"Dz.U. 2023 poz. 1465", "przepisy o pracy zdalnej".
category: legal
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: Kancelaria Sejmu RP (ISAP / ELI)
source_type: official_api
official: true
homepage: https://isap.sejm.gov.pl
documentation: https://api.sejm.gov.pl/eli_pl.html
rate_limit: fair use
last_verified: 2026-09-28
tags:
- prawo
- ustawy
- kodeks
- isap
- dziennik-ustaw
- tekst-jednolity
- przepisy
- eli
compatibility: Python 3.8+ (standard library only); network access to api.sejm.gov.pl.
---
# Prawo (ISAP / Dziennik Ustaw)
Fetches Polish legal acts from the official ELI API of the Chancellery of the Sejm using
`scripts/prawo.py`. Always outputs structured JSON.
## Running the script
Run from this skill's directory (or use relative path from repo root):
| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/prawo.py <command> …` |
| Windows | `py scripts/prawo.py <command> …` (or `python`) |
Zero external dependencies required (standard library only).
## Critical: how current is the text?
The API publishes HTML only for some documents. The newest consolidated texts (teksty jednolite)
are often **PDF-only**, and the HTML of an amended act is its **original** wording from the day it
was published. `article` therefore:
1. reads the newest consolidated text that has HTML (or the act itself if it was never amended),
2. reports that document in `sourceDocument` (`ref`, `date`, `kind`),
3. lists every amendment that entered into force after that date in `amendmentsAfterSource`,
4. sets `upToDate` and `warning`.
When `upToDate` is `false`, **always** tell the user the date of the wording and that later
amendments exist, and give the PDF link of the newest consolidated text. Never present such text as
the certain current wording. For the Constitution the API has no HTML at all: give the PDF link.
## Workflow
1. **Article wording** ("co mówi art. 30 KP", "okres wypowiedzenia"):
`python3 scripts/prawo.py article kp 30`
- Article numbers: `30`, `22a`, `67^18` (superscript `67¹⁸` also works).
- Quote the text, then state `sourceDocument.displayAddress` and `sourceDocument.date`.
- If `upToDate` is false, add the `warning` in your own words and the newest PDF link.
2. **Is the act in force / latest consolidated text / upcoming changes:**
`python3 scripts/prawo.py act kp`
- `latestConsolidatedText` (with PDF link), `amendmentsAfterLatestConsolidatedText`,
`upcomingAmendments` (entry into force in the future), `status`, `inForce`.
3. **Act by reference:** `act` and `article` accept a shortcut (`kp`, `vat`…), `DU/2023/1465`,
`Dz.U. 2023 poz. 1465`, `Dz.U. 1974 nr 24 poz. 141` or an ISAP address `WDU20230001465`.
List shortcuts with `python3 scripts/prawo.py codes` (works offline).
4. **Search by title** (acts without a shortcut):
`python3 scripts/prawo.py search "o ochronie danych osobowych" --type Ustawa --in-force`
- Results include amending acts ("o zmianie ustawy…"); pick the act the user means, then call `act`.
## Commands
| Command | Description | Returns |
|---|---|---|
| `article <ref> <nr> [--original]` | Wording of one article with its source and freshness | `text`, `sourceDocument`, `upToDate`, `amendmentsAfterSource`, `newerConsolidatedTextsPdfOnly`, `warning` |
| `act <ref> [--limit N]` | Status, consolidated texts, amendments and links | `status`, `inForce`, `latestConsolidatedText`, `amendmentsAfterLatestConsolidatedText`, `upcomingAmendments`, `links` |
| `search <query> [--in-force] [--type T] [--year Y] [--publisher DU\|MP] [--limit N]` | Search acts by words in the title | `results[]` with `ref`, `displayAddress`, `title`, `status` |
| `codes` | Offline list of shortcuts for the main codes and statutes | `codes[]` with `code`, `ref`, `name` |
Field reference: [references/output.md](references/output.md).
## Exit codes
JSON goes to stdout; errors go to stderr as `{"error": "...", "type": "..."}`.
| Code | Meaning | What to do |
|---|---|---|
| `0` | Success | Use the JSON output |
| `2` | Not found / not available | Act or article does not exist, or no HTML text exists (error names the PDF link) |
| `64` | Bad usage / validation | Unrecognised act reference or article number |
| `69` | Network / API error | Retry once; check internet connection |
## Rules
- This skill returns legal text, not legal advice. Do not interpret provisions as advice for the
user's specific case; suggest a lawyer (adwokat, radca prawny) for that.
- Always cite the act and the source document, e.g. "art. 36 § 1 Kodeksu pracy (tekst jednolity
Dz.U. 2023 poz. 1465)".
- `--original` returns the historical wording of an amended act. Use it only when the user asks
about the original or historical text, and say so.
© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills