NomaDamas/k-skill

k‑skill – a Korean‑focused toolbox for AI agents

What it is

• k-skill is a collection of 125 ready‑to‑use “skills” (small command‑line tools) that let an LLM‑based AI agent interact with Korean public services, e‑commerce sites, government data, transport APIs, finance portals, and more.
• Each skill is a tiny program (mostly Node.js, some Python) that performs a single, well‑defined action – e.g. “fetch the KTX timetable”, “search Coupang for a product”, “check Korean real‑estate transaction prices”, or “run a Korean spell‑check”.
• The repository ships a proxy server (k-skill‑proxy) that can be called via a simple HTTP request, so an AI model only needs to know the endpoint and the skill name.
• It also provides a Claude Code plugin so Claude agents can install the whole suite with a single marketplace command.

Why it matters

• Modern AI agents (Claude, Codex, Claude Code, etc.) can call external tools, but most publicly available toolkits focus on English‑language services. k-skill fills the gap for Korean users by exposing dozens of official Korean APIs (KTX, KBO, government portals, public‑data‑portal datasets, etc.) and popular commercial services (Coupang, Naver Shopping, Daangn, etc.).
• By wrapping these services in a uniform CLI / HTTP interface, developers can build Korean‑centric autonomous agents that can, for example, book a bus ticket, look up a property’s official price, or generate a Korean‑language privacy‑policy without writing custom scrapers.

How to get started

1. Install – the README shows a one‑liner using npx:

   npx --yes skills add NomaDamas/k-skill --all -g   # install every skill
   # or install a single skill, e.g.
   npx --yes skills add NomaDamas/k-skill --skill railway-timetable -g
   

   Only Node 18+ and npx are required; a few skills (e.g., the KTX timetable helper) also need Python 3.11+ and the uv package manager.
2. Configure – run k-skill-setup to obtain any needed API keys (e.g., for Kakao, public‑data‑portal, or commercial services) and to set environment variables.
3. Call a skill – from an AI agent or a script, send an HTTP request to the proxy, e.g.:

   POST https://k-skill-proxy.example.com/railway-timetable
   { "origin": "서울", "destination": "부산", "date": "2024-10-01" }
   

   The proxy forwards the request, fetches the data, and returns a JSON response.
4. Use with Claude Code – add the plugin via the Claude marketplace and invoke skills with the /k-skill:<name> syntax, such as /k-skill:lotto-results.

What you can do with it

• Travel & transport – real‑time KTX schedules, bus seat availability, flight price look‑ups, Seoul subway arrivals, traffic congestion, highway CCTV streams.
• Real‑estate & law – official transaction prices, cadastral registers, LH housing announcements, court auction listings, Korean law and patent searches, automated privacy‑policy generation.
• Finance & business – corporate registration checks, tax delinquency lists, stock quotes, DART disclosures, government procurement searches.
• Shopping & daily life – product searches on Coupang, Naver, Danawa, market‑kurly, price‑comparison, delivery tracking, nearby gas stations, EV charger status.
• Health, weather, culture – emergency‑room bed availability, food‑safety alerts, Korean weather forecasts, marathon schedules, lottery results, Korean‑language spell‑check and AI‑humanizer.
• Developer utilities – HWP document conversion, Korean WHOIS lookup, Korean‑language character counting.

Who it’s for

• Korean‑speaking developers building autonomous agents or chat‑bots.
• Power users who want their LLM assistants to perform concrete Korean‑specific tasks without manual web‑scraping.
• Organizations that need a standardized way for AI agents to access public‑data‑portal APIs and commercial Korean services.

Limitations

• Most skills are read‑only (e.g., timetable lookup, price search). Booking or payment actions are explicitly excluded for safety.
• Some data sources require a proxy because the original APIs are unauthenticated or have CORS restrictions.
• Accuracy depends on the upstream service; if a public API changes, the corresponding skill may need an update.

Bottom line k-skill is a practical, well‑documented toolbox that turns a wide range of Korean web services into machine‑readable actions, making it far easier to build AI agents that can actually do things for Korean users.