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
/plugin marketplace add b44x/ai-polish-skills
/plugin install krs@polskie-skilleWhat 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-skilleThis installs the whole krs plugin with all its skills
2Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill krs -a claude-code3Manually: put the files in place
~/.claude/skills/krs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/krs/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill krs -a codex2Manually: put the files in place
.agents/skills/krs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill krs -a cursor2Manually: put the files in place
.cursor/skills/krs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/krs2Manually: put the files in place
.github/skills/krs/SKILL.md1Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill krs -a gemini-cli2Platform CLI
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/krsManually: put the files in place
.devin/skills/krs/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 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