Skip to main content
skill CX Codex

krs — Claude Code skill: KRS records and installation

This Claude Code skill retrieves Polish KRS registry records through the Ministry of Justice API. Ask about a company to see its status, officers, and rules for signing contracts.

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 krs@polskie-skille
Open on GitHub

What krs does

The skill queries official KRS records and returns structured JSON. Its info command gathers a company’s or foundation’s name, legal form, address, share capital, NIP, REGON, and status. It pads KRS numbers with leading zeroes to 10 digits, searches the entrepreneurs register first, then checks the associations and foundations register.

Use repr to retrieve representation rules, board members, and proxies. The full command returns the complete extract; add --history to include past changes. It requires Python 3.8+ and network access to api-krs.ms.gov.pl; it uses only Python’s standard library. The sposobReprezentacji field must be checked before stating who can legally bind a company.

What it helps with

  • check a Polish company’s current status
  • find board members and commercial proxies
  • identify who can sign a contract for a company
  • retrieve a full KRS extract with change history

Example prompts for the agent

  • Check company KRS number 6865 and show its status and address.
  • Find out who can sign a contract for the company with KRS number 0000006865.
  • Retrieve the full KRS extract for 0000006865, including its change history.

How to install krs

1Plugin marketplace

/plugin marketplace add b44x/ai-polish-skills
/plugin install krs@polskie-skille

This installs the whole krs plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

~/.claude/skills/krs/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about krs

How do I install krs in Claude Code?

Run these commands in order: /plugin marketplace add b44x/ai-polish-skills, then /plugin install krs@polskie-skille.

What does krs do?

It fetches official Polish KRS records for companies and foundations, including status, board composition, and representation rules. The full command retrieves a complete extract, and --history adds past changes.

What does krs need to run?

It requires Python 3.8+ and network access to api-krs.ms.gov.pl. The skill uses Python’s standard library.

Source text

SKILL.md · MIT
---
name: krs
display_name: Krajowy Rejestr Sądowy (KRS)
version: 1.0.0
description: >-
  Fetch official company and foundation records from Krajowy Rejestr Sądowy (KRS)
  via the Ministry of Justice API. Retrieve company legal status, board members (zarząd),
  supervisory council (rada nadzorcza), commercial proxies (prokurenci), share capital,
  registered address, NIP, REGON, and exact legal representation rules (sposób reprezentacji:
  kto może podpisywać umowy). Checks both commercial companies (Rejestr Przedsiębiorców P:
  Sp. z o.o., S.A., P.S.A.) and non-profits (Rejestr Stowarzyszeń/Fundacji S). Automatically
  pads KRS numbers to 10 digits. Use whenever the user asks about KRS, "kto może podpisać umowę",
  "sprawdź spółkę w KRS", "odpis KRS", "zarząd spółki", "kapitał zakładowy", or "reprezentacja spółki".
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: Ministerstwo Sprawiedliwości
source_type: official_api
official: true
homepage: https://ekrs.ms.gov.pl
documentation: https://api-krs.ms.gov.pl/
rate_limit: fair use
last_verified: 2026-09-28
tags:
  - krs
  - spolki
  - zarzad
  - reprezentacja
  - prawo
  - umowy
  - rejestr-sadowy
compatibility: Python 3.8+ (standard library only); network access to api-krs.ms.gov.pl.
---

# Krajowy Rejestr Sądowy (KRS)

Fetches official registration records, corporate representation rules, and board composition
from the Polish Ministry of Justice (*Ministerstwo Sprawiedliwości*) using `scripts/krs.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/krs.py <command> …` |
| Windows | `py scripts/krs.py <command> …` (or `python`) |

Zero external dependencies required (standard library only).

## Workflow

1. **Company Summary & Verification:**
   - User provides a KRS number (with or without leading zeros, e.g. `6865` or `0000006865`):
     `python3 scripts/krs.py info <krs>`
   - The script automatically pads the number to 10 digits and queries the Entrepreneurs register (`P`), falling back to Associations/Foundations (`S`).
   - Report company name, legal form, registered seat/address, share capital, and active status.

2. **Contract Signing Authority (Representation Check):**
   - User asks "who can sign a contract for company X?" or wants to verify a signature:
     `python3 scripts/krs.py repr <krs>`
   - Carefully review `sposobReprezentacji` (e.g. single board member vs. two members acting jointly vs. member + proxy).
   - List the active board members (`zarzad`) and proxies (`prokurenci`).

3. **Full Extract (Historical):**
   - When the user needs the complete record or past changes:
     `python3 scripts/krs.py full <krs> --history`

## Commands

| Command | Description | Returns |
|---|---|---|
| `info <krs> [--rejestr P\|S]` | Structured digest of company/foundation data | `nazwa`, `formaPrawna`, `nip`, `regon`, `adres`, `kapitalZakladowy`, `sposobReprezentacji`, `zarzad`, `prokurenci`, `radaNadzorcza`, `czyWLikwidacji` |
| `repr <krs> [--rejestr P\|S]` | Representation formula and authorized signatories | `sposobReprezentacji`, `zarzad`, `prokurenci` |
| `full <krs> [--history]` | Complete raw JSON extract from Ministry of Justice | Full OdpisAktualny or OdpisPelny |

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 | KRS number not found in register P or S |
| `64` | Bad usage | Invalid KRS format (must be 1-10 digits) |
| `69` | Network / KRS server error | Retry once; check internet connection |

## Rules

- Always verify the representation method (`sposobReprezentacji`) before confirming who can legally bind the company.
- Never invent board members or proxy holders not present in the official KRS extract.

© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills

Similar skills

All skills for Finance and business →

From the same set52

The whole set →
energia energia is a Claude Code skill that retrieves Poland’s PSE market electricity prices. It finds the cheapest continuous usage window and summarizes past prices. CX Codex +1 ★ 60repo stars otwarte-dane The otwarte-dane Claude Code skill searches Polish government datasets and their resource details. It responds to requests for open data, analysis sources, or APIs from Polish public agencies. CX Codex +1 ★ 60repo stars ostrzezenia-gis The ostrzezenia-gis Claude Code skill searches GIS warnings on Gov.pl by product or brand terms. It opens notices so batch numbers and dates can be checked against the product package. CX Codex +1 ★ 60repo stars moja-gmina The moja-gmina Claude Code skill searches GUS BDL data and compares Polish territorial units for a shared year. It handles queries about population, demographics, construction or unemployment. CX Codex +1 ★ 60repo stars przetargi The przetargi Claude Code skill searches Polish public procurement notices in BZP and retrieves notice details. Filter results by subject, contracting authority region, CPV code or publication date. CX Codex +1 ★ 60repo stars solid-jobs This Claude Code skill searches SOLID.Jobs listings and salary statistics. Filter results by keywords, city, experience, remote work, or pay range. CX Codex +1 ★ 60repo stars inpost This Claude Code skill tracks InPost parcels and finds parcel lockers and pickup points in Poland. It runs on requests about delivery status, a locker address, or nearby locations. CX Codex +1 ★ 60repo stars nbp The nbp skill for Claude Code retrieves Narodowy Bank Polski exchange rates and gold prices. It handles currency conversions and invoice tax calculations in PLN. CX Codex +1 ★ 60repo stars

Project sponsors

Companies that keep this analytics open