household-waste-info Skill (NomaDamas) for Claude Code: What It Does and How to Install It
Makes Claude look up household, food and recycling waste disposal days, times and places for a Korean city or district.
- Installs
- 8.8K
- on skills.sh
- Stars
- 8.2K
- on GitHub
- Files
- 2
- besides SKILL.md
- Updated
- Nov 2026
- last repo commit
You give Claude a city or district name such as 강남구. It queries the Ministry of the Interior and Safety household waste API through a proxy and sums up disposal places, methods, days and times, uncollected days and the office to contact. It is a community skill from NomaDamas.
You need no API key of your own. instruction.md says the data.go.kr key is added on the proxy server. SKILL.md is a stub that has Claude run an npx command to print the live instructions. The repo copy is instruction.md.
Good for
- Residents who want the pickup day for their district, such as 강남구
- Anyone who needs food waste or recycling disposal rules for an area
- Newcomers who want the local office's contact for waste questions
Install household-waste-info
Claude Code
- 1
Copy this prompt.
Install the household-waste-info 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.
Requires Node.js 18 or newer.
Pick one route. The plugin route installs the k-skill plugin, which covers the whole repo: 135 top-level skill folders (counted from the repo tree), with no hooks or MCP config files in the tree. The skills CLI and folder routes install only household-waste-info. The skill needs Node.js 18 or newer and runs npx at use time. KSKILL_PROXY_BASE_URL is optional, for a self-hosted proxy. There is no Claude app upload route.
From the project README. Source.
What's in the skill
When it loads
Use when the user asks for 생활쓰레기 배출 요일/시간/장소 정보 by 지역명(시군구) and wants official data.go.kr household waste guidance.
Sections in SKILL.md
- Get the full instructions (required first step)
- Hard rules even without the CLI
Key facts
- License
- MIT
- Installs on skills.sh
- 8,798 (Nov 2, 2026)
- Last repo commit
- Nov 1, 2026
- Audits on skills.sh
- Gen Agent Trust Hub: pass, Socket: warn, Snyk: warn
- Needs
- Internet access, curl and python3; no API key of your own; Node.js 18 or newer for the npx step
What it includes
SKILL.md tells Claude to run this first and follow its output
Fetches the current instructions from the k-skill npm package. The repo copy of those instructions is instruction.md.
Runs code ·
Bootstrap: npx -y @nomadamas/k-skill@0 instruct household-waste-infoClaude asks for the city or district before any lookup
instruction.md says not to query without a location, and to ask again with the higher-level district when the name is vague.
Try: “강남구 쓰레기 배출 요일 알려줘”
Read ·
Ask for the area firstGET /v1/household-waste/info with cond[SGG_NM::LIKE]
A curl call to the proxy. pageNo must be 1 and numOfRows must be 100, or the proxy returns 400.
Try: “우리 동네 음식물쓰레기 언제 버려?”
Runs code ·
Waste info lookupReports places, methods, days, times, uncollected days and contact
Claude keeps the answer to 3 to 6 key points and sorts multiple records by latest update.
Read ·
SummaryExtra npx commands SKILL.md lists for helper files and updates
SKILL.md lists npx -y @nomadamas/k-skill@0 files and update, which it says keeps the CLI and every coding-agent skill install current.
Runs code ·
k-skill files and update commands
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 household-waste-info 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. Read the output before Claude acts on it. github.com
npx -y installs packages without asking
The bootstrap command and the files and update commands that SKILL.md lists run through npx -y, which downloads and runs third-party code. github.com
Your district query goes to a proxy server
The curl request in instruction.md goes to https://k-skill-proxy.nomadamas.org by default and includes the district name you asked about. Set KSKILL_PROXY_BASE_URL to use your own proxy. github.com
The plugin route installs the whole k-skill set
The k-skill plugin in the repo tree has 135 top-level skill folders, including skills that cover other services. The skills CLI route can install just this one. github.com
The k-skill CLI can send a usage event
docs/usage-analytics.md says the CLI can send a cli_invocation event to PostHog with a random local ID stored in ~/.config/k-skill/analytics-id, the command, skill name, CLI version, runtime mode and success. It says command arguments, input, file contents and credentials are not sent. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com
Hard rules in SKILL.md
SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without explicit approval, and never to handle plaintext credentials in chat or files. github.com
Technical details
| Turning on read-only | No read-only mode. The documented request is a search. |
|---|---|
| Talks to | k-skill-proxy.nomadamas.org (default proxy; KSKILL_PROXY_BASE_URL overrides it). npm registry (@nomadamas/k-skill via npx). us.i.posthog.com (k-skill CLI usage event, unless you opt out) |
| Sign-in and keys | instruction.md says you store no data.go.kr key and the proxy server holds it. SKILL.md says never to ask for or store plaintext credentials. |
| Scopes |
|
Questions
What does the household-waste-info skill do?
It makes Claude look up waste disposal days, times, places and methods for a Korean city or district. It covers general, food and recycling waste.
Do I need an API key?
Not for the default setup. instruction.md says no key is required from you and the data.go.kr key is injected on the proxy server. KSKILL_PROXY_BASE_URL is optional, for a self-hosted proxy.
Where does the data come from?
From the household waste API on data.go.kr, the official Korean public data portal. Requests go to the k-skill proxy at k-skill-proxy.nomadamas.org by default, which forwards them to that API.
Why does it return nothing for my area?
instruction.md lists a district name that does not match the API data as a cause of empty results. Try the full city and district, such as 수원시 영통구.
How do I install it?
Use the install box at the top of this page. The repo README documents a Claude Code plugin that installs the whole k-skill set and a skills CLI command that installs one skill. The npx step needs Node.js 18 or newer.
Can I use it in the Claude app?
There is no upload route on this page. The skill runs npx and curl commands on your machine, so it needs a client that can run commands locally, such as Claude Code or Codex.
Does it send usage data?
docs/usage-analytics.md says the k-skill CLI can send a usage event to PostHog (random local ID, command, skill name, CLI version, runtime mode, success). It says command arguments, input, file contents and credentials are not sent, and KSKILL_ANALYTICS_DISABLED=1 opts out.
Is it safe?
It runs npx with -y, which downloads and runs an npm package without asking, and Claude follows the instructions that package prints. The district name you ask about is sent to the proxy. Read the printed instructions before Claude acts on them, and see the permissions section on this page.
Information
updated Nov 2, 2026
- Repository
- nomadamas/k-skill
- Folder
household-waste-info
Sources
Docs, issue trackers and discussions this page is built from.
Show all 5Hide
- k-skill README · github.com
- k-skill marketplace.json · github.com
- household-waste-info SKILL.md · github.com
- household-waste-info instruction.md · github.com
- k-skill CLI usage analytics · github.com