Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install prawo@polskie-skille
Open on GitHub

What 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-skille

This installs the whole prawo plugin with all its skills

2Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill prawo -a claude-code

3Manually: put the files in place

~/.claude/skills/prawo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/prawo/

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

Similar skills

All skills for Writing and docs →

From the same set52

The whole set →
biala-lista biala-lista is a Claude Code skill that checks Polish companies and VAT status by NIP or REGON. It runs on requests to verify a contractor, bank account, or Polish invoice. CX Codex +1 ★ 60repo stars terminy The terminy skill for Claude Code calculates Polish working days, public holidays and deadlines. It handles questions about payment dates, tax schedules and monthly working-time norms. CX Codex +1 ★ 60repo stars nieruchomosci The nieruchomosci Claude Code skill searches Poland’s RCN register for property transactions. Set a coordinate area and filter records by deed date, market, or size. CX Codex +1 ★ 60repo stars sejm This Claude Code skill queries the Polish Sejm’s official API. The agent uses it to look up MPs, voting records, bills and parliamentary interpellations. CX Codex +1 ★ 60repo stars imgw This Claude Code skill retrieves IMGW-PIB weather, warning and river-level data for Poland. It responds to requests about local conditions, alerts or water levels. CX Codex +1 ★ 60repo stars apteki The apteki Claude Code skill searches Poland’s official pharmacy registry export. It responds to requests for a pharmacy’s address, phone number, or registry status. CX Codex +1 ★ 60repo stars produkty The produkty Claude Code skill retrieves food-label details from a barcode or a product name. It queries Open Food Facts for ingredient, allergen-tag and nutrition data, with Poland as the default declared sales-country filter. CX Codex +1 ★ 60repo stars nfz This Claude Code skill searches NFZ services and reports estimated waits, queues, and facilities. Query by city or region, or search near a location. CX Codex +1 ★ 60repo stars

Project sponsors

Companies that keep this analytics open