Skip to main content
skill CX Codex

moja-gmina — Claude Code skill for GUS statistics and setup

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.

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

What moja-gmina does

The skill looks up municipalities, counties and voivodeships in GUS BDL, searches statistical indicators, then compares selected areas. Its scripts/moja_gmina.py utility accepts units, indicators, indicator and compare; results are JSON. When place names match, distinguish the units by geographic level, kind and parent identifier.

Python 3.8+ and internet access are required. The API allows anonymous requests; setting BDL_API_KEY is optional and raises request limits. If no year is supplied, compare selects the latest shared year separately for each indicator. Missing observations and statistical confidentiality are not zero values. The data source is the official GUS Local Data Bank.

What it helps with

  • find a municipality by name and geographic level
  • look up an indicator and inspect its definition
  • compare population across areas for a shared year
  • compare local unemployment or construction statistics

Example prompts for the agent

  • Find municipalities named Piaseczno at level 6.
  • Find an indicator for comparing county-level unemployment.
  • Compare the population of these two units for 2024.

How to install moja-gmina

1Plugin marketplace

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

This installs the whole moja-gmina plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

~/.claude/skills/moja-gmina/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/moja-gmina/

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

Questions about moja-gmina

How do I install moja-gmina in Claude Code?

Run /plugin marketplace add b44x/ai-polish-skills, then run /plugin install moja-gmina@polskie-skille in Claude Code.

What does moja-gmina do?

It searches GUS BDL for territorial units and indicators, then compares selected areas. Results retain geographic levels, measurement units and missing-data attributes.

What does moja-gmina require?

It needs Python 3.8+ and internet access. The API supports anonymous use; BDL_API_KEY is optional and raises request limits.

Source text

SKILL.md · MIT
---
name: moja-gmina
display_name: Moja gmina — statystyki GUS BDL
version: 1.0.0
description: >-
  Search official GUS BDL statistics and compare Polish municipalities, counties or voivodeships for a common year. Use for population, local demography, construction or unemployment comparisons, finding territorial units and statistical indicators. Preserves geographic levels, units of measure and missing-data attributes.
category: public_data
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: Główny Urząd Statystyczny — Bank Danych Lokalnych
source_type: official_api
official: true
homepage: https://bdl.stat.gov.pl/
documentation: https://api.stat.gov.pl/home/bdlapi
rate_limit: Anonymous 5 requests/s, 100/15 min, 1000/12 h, 10000/week; optional BDL_API_KEY increases limits.
last_verified: 2026-11-05
tags:
  - gus
  - bdl
  - gmina
  - powiat
  - demografia
  - ludnosc
  - statystyki
compatibility: Python 3.8+ (standard library only); internet access required.
---

# GUS BDL local statistics

## Running the script

Run `python3 scripts/moja_gmina.py <command>` from this skill's directory (`py` on Windows).

| Command | Purpose |
|---|---|
| `units "Piaseczno" --level 6` | Find municipalities, preserving unit type and parent identifier |
| `indicators "ludność" --level 6` | Search indicators and their dimensions |
| `indicators "bezrobotni" --level 5` | Find an appropriate county-level series |
| `indicator ludnosc` | Full definition and available years for total population (BDL 72305) |
| `compare --units <ID_BDL_1> <ID_BDL_2> --indicators ludnosc --year 2024` | Compare units found through `units` for a common year |
| `compare --units <ID_BDL_1> <ID_BDL_2> --indicators <INDICATOR_ID>` | Select the latest year with data for both units |

## Workflow and interpretation

1. Resolve units through `units`; the 12-digit BDL identifier differs from a shortened TERYT code. For matching names, inspect `level`, `kind` and `parentId`. An urban-rural municipality, its town and its rural part may be separate units.
2. Select an indicator through `indicators`, then inspect its full definition with `indicator`. Names `n1`…`n5`, unit of measure, geographic level and available years are part of the definition. Total and per-capita income are different series; wages or unemployment rates may not be available at municipality level.
3. `compare` accepts up to 10 units of the same level and up to 5 indicators. Without `--year`, it chooses the latest common year **separately for each indicator**. `no_common_data` means no comparable data; do not substitute another unit's latest year.
4. Cite **GUS, Bank Danych Lokalnych**, the year, unit of measure and indicator definition. Preserve attributes, methodological notes and territorial scope. `null`, absent observations and statistical confidentiality do not mean zero. Population size is neither a quality-of-life rating nor a forecast.

## Cache, availability and exit codes

Metadata is cached for 24 hours and data for 1 hour in `~/.cache/ai-polish-skills/moja-gmina`. Put `--no-cache` before the command to force a fetch. `requests` contains the URL, actual retrieval time and cache status. Root-level `fetched_at` is the response preparation time. Override the cache directory with `MOJA_GMINA_CACHE_DIR`. There is no fallback to expired data.

The API supports anonymous access; optionally set `BDL_API_KEY` for the `X-ClientId` header. On HTTP 429, the skill exits with 69 and reports `retry_after`; respect that delay before another attempt. Do not increase request frequency during an outage. During verification on 2026-11-05, official API documentation and the schema were available, but REST data requests timed out; offline tests do not confirm service availability.

Success: JSON on stdout, exit `0`. Errors: JSON on stderr, exit `2` for a missing resource/results, `64` for validation or `69` for network/API/format/rate-limit errors. `--help` returns `0`. Read [references/api.md](references/api.md) for API details.

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

Similar skills

All skills for Data and databases →
deweloperuch.pl (unofficial) MBratkowski deweloperuch.pl (unofficial) is an MCP server that gives an AI assistant access to Polish new-build asking prices, registered transactions, and GUS and NBP statistics for comparing listings with transaction data. CX Codex +1 ★ 29repo stars ResultRail by LarryBuildsAI larrybuildsai ResultRail by LarryBuildsAI — an MCP server that fetches public data about domains and URLs, charging only for successful results. Returns sources, confidence scores, and receipt hashes—for quick data enrichment and lookup workflows. CX Codex +1 6,708installs LiveDataLink blackboxfoundry LiveDataLink gives AI coding agents access to source-linked public data over MCP. Use it for company checks, market data, property records, and sanctions screening. CX Codex +1 3,686installs TapWaterMap squidcode TapWaterMap connects your agent to public US EPA drinking water records covering ~19,000 cities. Inspect contaminants and recorded violations without any API keys. CX Codex +1 1,707installs cristianoaredes-mcp-dadosbr cristianoaredes The cristianoaredes-mcp-dadosbr MCP server connects Claude Code and other AI assistants to Brazilian public registries for company, address, court, contract and central bank data. CX Codex +1 ★ 10repo stars alphago2580-naramarketmcp alphago2580 alphago2580-naramarketmcp is an MCP server for Claude Code that exposes Korea’s public procurement data, including bids, contracts, and statistics. It connects over HTTP. CX Codex +1 ★ 5repo stars

From the same set52

The whole set →
adresy The adresy Claude Code skill geocodes Polish addresses and finds nearby address points from GPS coordinates. It activates for address searches and reverse geocoding requests. CX Codex +1 ★ 60repo stars 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 krs 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. 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

Project sponsors

Companies that keep this analytics open