fine-dust-location Skill for Claude: Korean PM10 and PM2.5 by Region

Makes Claude report Korean fine dust (PM10, PM2.5) and the overall air grade for a region you name.

Installs: 9.3K; on skills.sh
Stars: 8.2K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

This skill makes Claude answer "how is the air here?" for Korean regions. You give a district name such as 서울 강남구. Claude asks the k-skill proxy, which reads AirKorea, and replies with the station, the time, PM10 and PM2.5 values and grades, and the combined air grade.

If a name matches several stations, the proxy returns candidates and Claude asks again with an exact station name. The default path needs no API key. The helper script can also call AirKorea directly, and that route reads AIR_KOREA_OPEN_API_KEY. It is made by NomaDamas, not by AirKorea.

Good for

People in Korea who want the current air quality before heading out
Anyone who can name a district such as 서울 강남구
Claude Code or Codex users who already run k-skill skills

Install fine-dust-location

Claude Code

Copy this prompt.

Install the fine-dust-location skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. The plugin installs every skill listed in its plugin.json (135 entries today, the README says 90+) and names them /k-skill:<skill-name>. The skills CLI route installs only this skill. The skill's SKILL.md then runs npx -y @nomadamas/k-skill@0 instruct fine-dust-location on first use, so Node.js 18+ and internet must be available. The helper script needs Python 3.

From the project README. Source.

What's in the skill

When it loads

에어코리아 기반 미세먼지/초미세먼지를 지역명 또는 위치 힌트로 조회한다. 기본 경로는 k-skill-proxy의 report endpoint다.

Sections in SKILL.md

Get the full instructions (required first step)
Hard rules even without the CLI

Key facts

Author: NomaDamas (named as author in the repo plugin manifest)
Repo: NomaDamas/k-skill
Installs on skills.sh: 9,312 (Nov 2, 2026)
GitHub stars: 8,232 (Nov 2, 2026, whole repo)
License: MIT (SKILL.md); the repo README says the proxy server folders are AGPL-3.0-only
Last repo commit: Nov 1, 2026
What installs: 4 files including SKILL.md: instruction.md, skill.json and scripts/fine_dust.py
Needs: Internet and Node.js 18+; the script needs Python 3; no key on the default proxy path
skills.sh audits: Gen Agent Trust Hub pass, Socket warn, Snyk warn (Nov 2, 2026)
Works in: Claude Code, Codex, OpenCode, OpenClaw/ClawHub

What it includes

Runs npx to print the current instructions for this skill, then follows them
SKILL.md says to run `npx -y @nomadamas/k-skill@0 instruct fine-dust-location` first.
Runs code · Fetch instructions
GET /v1/fine-dust/report with regionHint or stationName on the k-skill proxy
Returns PM10, PM2.5 and the combined grade. Region names closest to a station name, such as 강남구, work best.
Network · report endpoint
Helper script: report --region-hint "<region>" --json, run through npx exec
Calls the same proxy endpoint by default. Its code also has direct AirKorea routes that read AIR_KOREA_OPEN_API_KEY.
Runs code · fine_dust.py report
Proxy returns candidate stations; Claude asks again with an exact station name
Example in the instructions: 광주 광산구 returns candidates, and 우산동(광주) is then queried by stationName.
Network · Ambiguous locations
Lists station, time, PM10 and grade, PM2.5 and grade, combined grade and lookup method
The instructions ask for these fields first, before anything else.
Compact answer

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Claude runs whatever the k-skill npm package prints
SKILL.md says to run npx -y @nomadamas/k-skill@0 instruct fine-dust-location and follow its output as the primary instructions. Claude therefore acts on text that comes from an npm package at run time, and the @0 tag floats across 0.x releases, so the instructions can change without any change to SKILL.md. SKILL.md also lists an update command. The same text is in the repo as fine-dust-location/instruction.md. Read the output before Claude acts on it. github.com
Your region goes through a third-party proxy
By default fine_dust.py sends the region or station name to k-skill-proxy.nomadamas.org. The README points to a privacy policy for proxy-backed skills at k-skill-proxy.nomadamas.org/privacy.
A direct route reads an AirKorea key
If you set KSKILL_PROXY_BASE_URL to off, the script calls apis.data.go.kr and needs AIR_KOREA_OPEN_API_KEY from your environment.
The k-skill CLI can send usage statistics
The docs say it sends a random local ID, the command and skill name, CLI version, runtime mode and success flag, but not arguments, input, file contents or credentials. Set KSKILL_ANALYTICS_DISABLED=1 to opt out.
Hard rules in SKILL.md
SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without explicit approval immediately beforehand, and never to ask for, print or store plaintext credentials in chat, files or shell arguments.

Technical details

Talks to	k-skill-proxy.nomadamas.org. apis.data.go.kr (direct AirKorea route in fine_dust.py). npm registry (npx). us.i.posthog.com (k-skill CLI usage event, unless you opt out)
Sign-in and keys	No key on the default proxy path. The direct AirKorea route reads AIR_KOREA_OPEN_API_KEY from your environment.
Scopes	Runs npx -y to fetch and run the k-skill CLI and a bundled Python script Sends the region or station name to k-skill-proxy.nomadamas.org

Questions

What does fine-dust-location do?

It reports PM10, PM2.5 and the combined air quality grade for a Korean region or station. Claude gets the numbers from the k-skill proxy, which reads AirKorea.

How do I install it in Claude Code?

Use the install box at the top. The plugin route installs the whole k-skill set, and the skills CLI route installs only this skill.

Does it need an API key?

Not on the default path. The instructions send requests to the k-skill proxy. The script's direct AirKorea route reads AIR_KOREA_OPEN_API_KEY from your environment, and you can point it there by setting KSKILL_PROXY_BASE_URL to off.

Does it use my GPS location?

The instructions ask for a region name or station name. The script also accepts latitude and longitude arguments, but SKILL.md does not say Claude reads your device location.

Is it made by AirKorea?

No. It is a community skill by NomaDamas. SKILL.md carries a legal notice: the skill is not an official feature of, supported by or affiliated with any trademark owner or service it names.

Does it work in the Claude app?

The README lists Claude Code, Codex, OpenCode and OpenClaw/ClawHub. The skill runs npx and a Python script, so use a client that can run commands.

Is it safe?

The skill fetches its instructions and a Python helper with npx -y @nomadamas/k-skill@0 at use time. The region you name goes to the k-skill proxy. Optional usage statistics are on unless you set KSKILL_ANALYTICS_DISABLED=1. Read instruction.md and the script first.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: fine-dust-location

nomadamas/k-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

SKILL.md · github.com
instruction.md · github.com
fine_dust.py · github.com
k-skill README · github.com
usage-analytics.md · github.com