What Are the Common Use Cases for k-skill? 8 Korean Domain Categories Explained

k-skill is a modular collection of ~150 tiny "skills" that turn Korean-specific data lookups and transaction flows into simple CLI or API calls, covering transportation, public services, finance, commerce, media, legal, health, and cultural domains.

The k-skill repository by NomaDamas packages discrete Python and Node.js scripts into reusable, self-contained units. Each skill ships with a skill.json descriptor and exposes a namespaced CLI command like k-skill:zipcode-search. This architecture lets developers cherry-pick functionality for automation, agent workflows, or HTTP endpoints without managing complex dependencies or authentication flows manually.

---

Core Architecture That Enables Diverse Use Cases

Understanding how k-skill is built explains why it spans so many domains. The design follows three layers:

• Skill Descriptor (skill.json) — Defines inputs, schema, and login requirements. The CLI stub generator (npm run generate:skill-stubs) reads this to expose commands.
• Implementation Script — Python for data-heavy tasks, Node for others. Located in scripts/ within each skill directory.
• Proxy / Runtime Layer — Optional k-skill-proxy (AGPL-3.0) routes authenticated calls; browser runtime handles sessions requiring login.

This modularity means each use case below is implemented as a drop-in module you can install individually or as a group.

---

Transportation and Travel

k-skill automates Korean rail, bus, and flight workflows that normally require navigating fragmented booking sites.

Skill	Purpose	Authentication
srt-booking	SRT (Super Rapid Train) schedules and reservations	Browser runtime
ktx-booking	KTX high-speed rail lookup and booking	Browser runtime
express-bus-booking	Express bus routes and seat selection	Browser runtime
intercity-bus-booking	Intercity bus timetables	Browser runtime
flight-ticket-search	Price comparison across carriers	Proxy or direct

The typical pattern: query schedules and pricing via CLI, then hand off to a logged-in browser session for final reservation. The skill.json for transit skills sets "requiresLogin": true to trigger this behavior.

---

Public Services and Government Data

Many skills pull from Korea's Public Data Portal without requiring user credentials. These are ideal for civic tech and data journalism.

• zipcode-search — Korean address and postal code lookup. Implementation in zipcode-search/scripts/zipcode_search.py builds a curl command, parses HTML, and returns structured JSON.
• seoul-subway-arrival — Real-time arrival times by station.
• seoul-density — Population density by administrative district.
• seoul-bike — Ddareungi (Seoul bike share) station status.
• korean-law-search — Statute and case law queries.
• housing-official-price — Officially assessed property values.
• real-estate-search — Transaction history and market trends.
• nts-business-registration — National Tax Service business verification.
• national-pension-workplace — Employer pension contribution records.

These skills hit open APIs directly or scrape public pages, making them zero-config for end users.

---

Finance and Securities

Financial skills interface with brokerage APIs, market data feeds, and e-invoice systems.

• toss-securities — Account balances and order status from Toss Securities.
• k-dart — Financial disclosures from Korea's DART system.
• popbill — Electronic tax invoice issuance and management.
• korean-stock-search — Real-time KOSPI/KOSDAQ quotes.

The k-skill-proxy (source in packages/k-skill-proxy/src/server.js) handles rate limiting and API key management when direct access requires credentials.

---

Commerce and Marketplace

Price comparison and inventory search across Korea's dominant platforms.

Skill	Platform	Use Case
daangn-cars-search	Karrot Market	Used vehicle listings
daangn-used-goods-search	Karrot Market	Secondhand goods
coupang-product-search	Coupang	E-commerce price tracking
danawa-price-search	Danawa	Electronics comparison
ohou-today-deal	Ohouse	Home goods daily deals
market-kurly-search	Kurly	Fresh grocery availability

These skills return structured product data; checkout typically launches a browser session for payment completion.

---

Media, Sports, and Entertainment

Real-time scores, schedules, and ticketing for Korean cultural events.

• kbo-results — Korea Baseball Organization scores and standings.
• kbl-results — Korean Basketball League data.
• kleague-results — Professional football match results.
• lck-analytics — League of Legends Champions Korea statistics.
• ticket-availability — Concert and event ticket release monitoring.
• lotto-results — Lottery number drawings and prize tiers.
• naver-news-search — News article search with sentiment filtering.

---

Legal and Administrative Automation

Skills that reduce paperwork for businesses and legal professionals.

• iro-registry-automation — Intellectual property registry filings.
• court-payment-order-assistant — Civil court payment order workflows.
• g2b-sanctioned-supplier — Government e-procurement blacklisted vendor checks.
• g2b-order-plan-search — Public sector purchase forecasts.

These often combine form-filling automation with data validation against public registries.

---

Health, Safety, and Environment

Location-based services for daily life in Korea.

• ev-charger-nearby — Electric vehicle charging station locations and availability.
• ev-subsidy-status — National and local EV purchase incentive eligibility.
• fine-dust-location — Real-time PM2.5/PM10 readings by district.
• han-river-water-level — Flood monitoring data.
• emergency-room-beds — Hospital ER capacity and wait times.

---

Culture, Knowledge, and Productivity

Academic, historical, and document processing utilities.

• keris-academic-search — Korean academic paper database queries.
• korean-heritage-search — Cultural Heritage Administration registry.
• joseon-sillok-search — Annals of the Joseon Dynasty full-text search.
• korean-patent-search — KIPO patent and utility model lookup.
• hwp / rhwp-edit — Hangul Word Processor format conversion and editing.
• korean-character-count — Accurate Korean text metrics (hangul jamo handling).
• korean-humanizer / korean-slang-writing — Tone and style transformation.

---

How to Install and Use k-skill Skills

Install the Full Collection or Single Skills

Per the Installation section of README.md:

# Install every skill globally

npx --yes skills add NomaDamas/k-skill --all -g

# Install only the postcode lookup skill

npx --yes skills add NomaDamas/k-skill --skill zipcode-search -g

Run a Skill from CLI

# Look up postal code for "강남역"

k-skill:zipcode-search "강남역"

This executes zipcode-search/scripts/zipcode_search.py, which performs the HTTP request, HTML parsing, and JSON serialization.

Call Programmatically in Python

from zipcode_search import lookup_korean_address

result = lookup_korean_address("서울역", limit=3)
print(result.to_json())

The function accepts an optional runner parameter for custom HTTP handling—useful for testing or proxy injection.

---

Summary

• k-skill packages ~150 Korean domain-specific automations into installable, CLI-exposed modules.
• Use cases span 8 major categories: transportation, public data, finance, commerce, media, legal, health, and culture.
• Each skill contains skill.json (descriptor), scripts/ (implementation), and integrates with optional k-skill-proxy for authenticated flows.
• Install globally with npx, invoke via k-skill:<name>, or import Python functions directly.
• Zero-config skills pull open data; login-required skills hand off to browser runtime transparently.

---

Frequently Asked Questions

What is the minimum setup needed to use a k-skill?

For open-data skills like zipcode-search, no setup is required—install via npx and run immediately. For skills requiring authentication, the CLI prompts for credentials or launches a browser session automatically. The skill.json descriptor in each skill directory declares whether login is needed.

How does k-skill handle API rate limits and authentication?

Authenticated requests route through k-skill-proxy (source in packages/k-skill-proxy/src/server.js), an AGPL-3.0 licensed gateway that manages API keys and rate pooling. Alternatively, skills can use a browser runtime for session-based authentication when proxy access is unavailable.

Can I use k-skill in a production service or just for CLI automation?

Both. The Python functions are deliberately pure and testable—import them directly into applications. The CLI layer adds environment loading, proxy selection, and output formatting suitable for shell scripts and CI pipelines. For HTTP services, wrap the Python imports in a FastAPI or Flask endpoint.

Where is the skill implementation code located?

Each skill lives in its own directory under the repository root. The descriptor is skill.json, and the logic resides in scripts/—typically Python for data tasks, Node for others. For example, zipcode-search/scripts/zipcode_search.py contains the address lookup implementation that the CLI stub invokes.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}