NomaDamas/k-skill

AI Engineering

A collection of Korean-life skills that let coding agents query Korean public services, commerce, transit, finance, and government data.

8,215
994
JavaScript
MIT
7 months old

k-skill is a collection of 125 agent skills aimed at Korean users: instead of building a Korean-specific app, it teaches an existing coding agent (Claude Code, Codex, OpenCode, OpenClaw/ClawHub) to look up or act on Korean services — KTX timetables, bus booking, real-estate transaction prices, DART filings, KBO scores, Coupang search, spell checking, and so on. The skills are organized by daily-life category and each has its own feature document describing inputs, examples, and limits.

How it works

Skills are installed into the agent rather than run as a standalone service. The default install uses npx --yes skills add NomaDamas/k-skill --all -g and requires only Node.js 18+ and npx; individual skills can be selected with --skill, and an update command refreshes the CLI and installed skills. Claude Code users can alternatively add a plugin marketplace and invoke skills under a /k-skill:<name> namespace. The README says the full flow is: install all skills, run the k-skill-setup skill to obtain credentials and check environment variables, then use individual features installation guide.

The KTX timetable helper is an exception to the minimal Node requirement: it additionally needs Python 3.11+ and uv. Skills that use public APIs go through the project's own proxy server; the README points to the proxy privacy policy for how those skills handle personal data proxy privacy policy.

Scope and constraints

  • Read-only versus acting skills differ. The railway timetable skill is explicitly lookup-only: it reads Korail's official planned timetable and does not log in, reserve, waitlist, pay, or cancel railway timetable docs. Other skills, such as bus booking or Daangn, describe booking-assisted or optional actions — check each feature document rather than assuming all are read-only.
  • Some skills rely on undocumented surfaces. For example, the housing official-price skill reads a public web data surface that is not a documented OpenAPI, while other skills use official public-data APIs through the proxy.
  • Telemetry is opt-in-able. CLI usage analytics collects only usage statistics, not command arguments, raw input, file contents, or credentials, and can be declined with KSKILL_ANALYTICS_DISABLED=1 usage analytics docs.
  • Licensing splits by directory. The repository is MIT, but the proxy server directory and proxy dashboard are AGPL-3.0-only. Public-data lookups are described as personal, non-organizational use only; bulk crawling and access-control circumvention are disallowed.

The README lists some limits inline (e.g., Daiso per-store stock quantities blocked since 2026-05-05, and emergency-room lookup showing operating flags rather than exact bed counts), so feature-level documents are the place to verify whether a specific lookup meets your need.

HotRepo's take

The project appeared on GitHub's daily trending board on three recorded dates between 2026-08-01 and 2026-08-03, reaching 6,969 stars on 2026-08-03, and later on a weekly JavaScript board at +163 (2026-10-30). The supplied samples are too sparse to indicate whether interest is rising or fading; treat them as dated snapshots only.

Written by AI from the project's README, updated October 30, 2026. The project's own docs are the source of truth.