Skip to main content
skill CX Codex

smog — Claude Code skill for air quality data

The smog Claude Code skill retrieves GIOŚ air quality readings in Poland. It finds stations by city or coordinates and reports pollutant measurements with the Polish air quality index.

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

What smog does

The skill queries official GIOŚ measurements and locates stations by city or coordinates. Results include the station name, pollutant values with units and measurement times, plus the index category provided by GIOŚ. Sensors can report readings from different hours.

Python 3.8+ and internet access are required; the script uses only Python’s standard library and needs no API key. When the latest time slot has no reading, the skill marks it as missing rather than showing zero. It does not provide forecasts, health advice, or continuous monitoring. A nearby station may not reflect conditions at a specific address.

What it helps with

  • find GIOŚ stations in a city
  • locate the nearest station from coordinates
  • retrieve recent pollutant readings
  • check the Polish air quality index and measurement times

Example prompts for the agent

  • Show GIOŚ stations and air quality in Kraków.
  • Find the nearest GIOŚ station to coordinates 50.06 19.94.
  • Show the latest PM2.5 and PM10 readings for station 400.

How to install smog

1Plugin marketplace

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

This installs the whole smog plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

~/.claude/skills/smog/SKILL.md

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

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

Questions about smog

How do I install smog in Claude Code?

Add the marketplace with /plugin marketplace add b44x/ai-polish-skills, then install the skill with /plugin install smog@polskie-skille.

What does smog do?

It retrieves official GIOŚ readings, finds stations by city or coordinates, and reports pollutant measurements, timestamps, and the Polish air quality index category.

What does smog need to run?

It requires Python 3.8+ and internet access. The script uses Python’s standard library and does not need an API key.

Source text

SKILL.md · MIT
---
name: smog
display_name: Smog — jakość powietrza GIOŚ
version: 1.0.0
description: >-
  Read official GIOŚ air quality measurements and the Polish air quality index. Find stations by city or the nearest station by GPS. Use for "smog", "jakość powietrza", "PM2.5", "PM10", "najbliższa stacja GIOŚ". Shows measurement times and missing data; does not provide forecasts or medical advice.
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 Inspektorat Ochrony Środowiska (GIOŚ)
source_type: official_api
official: true
homepage: https://powietrze.gios.gov.pl/
documentation: https://powietrze.gios.gov.pl/pjp/content/api
rate_limit: Endpoint-specific limits; see GIOŚ documentation
last_verified: 2026-11-04
tags:
  - smog
  - powietrze
  - pm10
  - pm25
  - gios
  - jakosc-powietrza
compatibility: Python 3.8+ (standard library only); internet access required.
---

# GIOŚ air quality

## Running the script

Run from this skill's directory:

| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/smog.py <command> ...` |
| Windows | `py scripts/smog.py <command> ...` |

| Command | Purpose |
|---|---|
| `stations --city Kraków` | All stations in the city; `Krakow` also works |
| `stations` | GIOŚ station catalogue |
| `near 50.06 19.94` | Nearest station, straight-line distance, index and measurements |
| `station 400` | Index and latest available measurements for a station |

## Choosing a station and reporting results

1. For a city, call `stations --city` first. If several stations match, present the options; do not describe one station as the city-wide average. Use `near` for supplied coordinates.
2. Report the station name, **GIOŚ** attribution, value, unit and measurement time for each pollutant. All concentrations from this API, including CO, are in µg/m³. Measurement and index times are local Europe/Warsaw times; `fetched_at` is UTC.
3. `latest_slot_missing` means the latest time slot has no measurement and the result comes from an earlier slot. `no_current_data` and `null` mean missing data, never zero. Different sensors may report measurements from different hours.
4. Show the index category supplied by GIOŚ; do not calculate a separate index or substitute US AQI. Report missing or incomplete index status. The data is provisional and may be corrected later.
5. This skill does not provide forecasts, health advice or continuous monitoring. The nearest station may not reflect conditions at the user's exact address.

## API and exit codes

Use `https://api.gios.gov.pl/pjp-api/v1/rest/`. The script supports JSON-LD pagination without pip dependencies or API keys. Do not use the retired `/pjp-api/rest/` endpoint.

Success: JSON on stdout, exit `0`. Errors: JSON on stderr, exit `2` for a missing station, `64` for validation or `69` for API/network failures. Missing measurements at an existing station are a valid result with `null` fields. A sensor-fetch network failure stops the lookup instead of masquerading as a missing measurement. `--help` and `-h` return `0`.

Read [references/output.md](references/output.md) for field details. Source: [GIOŚ API documentation](https://powietrze.gios.gov.pl/pjp/content/api).

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

Similar skills

All skills for Data and databases →
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 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 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 rundata.re · La Réunion 974 en direct rundata-re rundata.re · La Réunion 974 en direct is an MCP server for Claude Code that answers queries about current weather, volcano status, sea conditions, air quality, buses and services on Réunion. CX Codex +1 ★ 1repo stars

From the same set52

The whole set →
biala-lista biala-lista is a Claude Code and Gemini CLI plugin for checking Polish businesses and their VAT status against Poland’s official Ministry of Finance White List. ★ 60repo stars apteki apteki is a Claude Code plugin that searches Poland’s official CeZ Rejestr Aptek CSV export for pharmacy records. Search by city, street, or pharmacy name. ★ 60repo stars polskie-skille The polskie-skille plugin for Claude Code connects an AI agent to Polish registries, services, and open datasets. It handles questions about companies, weather, medicines, transit, and other Polish sources. ★ 60repo stars cert-pl cert-pl — a skill for Claude Code checks domains and URLs against CERT Polska’s active warning list. It runs when an agent is asked to inspect a suspicious text message or parcel-fee link. CX Codex +1 ★ 60repo stars 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

Project sponsors

Companies that keep this analytics open