moja-gmina — скилл для Claude Code: статистика и установка
Скилл moja-gmina для Claude Code ищет статистику GUS BDL и сравнивает польские территориальные единицы за общий год. Запускается для запросов о населении, демографии, строительстве или безработице.
MIT ★ 60 обновлён 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install moja-gmina@polskie-skilleЧто делает moja-gmina
Скилл находит муниципалитеты, повяты и воеводства в базе GUS BDL, ищет статистические показатели и сравнивает выбранные единицы. Скрипт scripts/moja_gmina.py принимает команды units, indicators, indicator и compare; результат выводится в JSON. При совпадающих названиях территорий важно различать их по уровню, типу и родительскому идентификатору.
Для работы нужны Python 3.8+ и доступ в интернет. API принимает анонимные запросы, а ключ BDL_API_KEY можно задать, чтобы повысить лимиты. Без общего года с данными для всех выбранных единиц сравнение подбирает последний общий год отдельно для каждого показателя; пустые наблюдения и статистическая конфиденциальность не означают ноль. Данные поступают из официального Банка локальных данных GUS.
Какие задачи решает
- найти муниципалитет по названию и уровню
- подобрать показатель и посмотреть его определение
- сравнить население нескольких территорий за общий год
- сопоставить безработицу или строительство на местном уровне
Примеры запросов агенту
- Найди муниципалитеты с названием Piaseczno на уровне 6.
- Подбери показатель для сравнения безработицы на уровне повята.
- Сравни население этих двух единиц за 2024 год.
Как установить moja-gmina
1Через маркетплейс плагинов
/plugin marketplace add b44x/ai-polish-skills/plugin install moja-gmina@polskie-skilleКоманда ставит плагин moja-gmina целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill moja-gmina -a claude-code3Вручную: положить файлы
~/.claude/skills/moja-gmina/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/moja-gmina/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill moja-gmina -a codex2Вручную: положить файлы
.agents/skills/moja-gmina/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill moja-gmina -a cursor2Вручную: положить файлы
.cursor/skills/moja-gmina/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/moja-gmina2Вручную: положить файлы
.github/skills/moja-gmina/SKILL.md1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill moja-gmina -a gemini-cli2Командой платформы
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/moja-gminaВручную: положить файлы
.devin/skills/moja-gmina/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о moja-gmina
Как установить moja-gmina в Claude Code?
Выполни /plugin marketplace add b44x/ai-polish-skills и затем /plugin install moja-gmina@polskie-skille. Команды вводятся в Claude Code.
Что делает moja-gmina?
Скилл ищет территориальные единицы и показатели в GUS BDL, а затем сравнивает выбранные территории. В результатах сохраняются уровень территории, единицы измерения и атрибуты пропущенных данных.
Что нужно для работы moja-gmina?
Нужны Python 3.8+ и доступ в интернет. API доступен анонимно; BDL_API_KEY необязателен и повышает лимиты запросов.
Исходный текст
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