Overview

k-skill is an open-source curated skill collection for Claude Code built specifically for Korean users, maintained by NomaDamas. With 1,371 GitHub stars and 113 forks, the project covers tasks that are deeply embedded in Korean daily life — booking SRT and KTX trains, checking KBO baseball scores, sending KakaoTalk messages, processing HWP documents, and looking up fine dust air quality.

It supports Claude Code, Codex, OpenCode, and OpenClaw/ClawHub. No additional client API layer is required: skills either run directly or route through the k-skill-proxy server with plain HTTP requests.

Architecture: How k-skill Integrates with Claude Code

The diagram below shows the full integration flow from user intent to skill execution.

flowchart TD
    User["User"] --> CC["Claude Code <br/> (AI Agent)"]
    CC --> Skills["k-skill Collection"]

    Skills --> Auth["Skills Requiring Auth"]
    Skills --> NoAuth["No Auth Required"]
    Skills --> Proxy["Proxy-Routed Skills"]

    Auth --> SRT["SRT Booking"]
    Auth --> KTX["KTX Booking"]
    Auth --> Toss["Toss Securities"]

    NoAuth --> KBO["KBO Game Results"]
    NoAuth --> Lotto["Lotto Check"]
    NoAuth --> HWP["HWP Document Processing"]
    NoAuth --> Zip["Postal Code Search"]
    NoAuth --> KakaoTalk["KakaoTalk Mac CLI"]
    NoAuth --> Delivery["Package Tracking"]

    Proxy --> Subway["Seoul Subway Arrivals"]
    Proxy --> Dust["Fine Dust <br/> PM10 & PM2.5"]
    Proxy --> Coupang["Coupang Product Search"]
    Proxy --> Law["Korean Law Search"]

    Proxy --> ProxySrv["k-skill-proxy <br/> (self-hosted)"]

Complete Skill Inventory

k-skill currently ships 18 distinct skills across five domains.

Transportation

Daily Life

Sports and Entertainment

Work and Documents

Shopping and Finance

Deep Dive: KakaoTalk Mac CLI

The KakaoTalk skill stands out as a particularly creative integration. It wraps kakaocli, a macOS-only CLI tool, allowing Claude Code to read conversation history and send messages directly from the terminal.

Prerequisites

brew install silver-flight-group/tap/kakaocli

The terminal application must have Full Disk Access and Accessibility permissions granted in System Settings. Without Full Disk Access, even read commands will fail. Without Accessibility, send and harvest automation will not work.

If KakaoTalk for Mac is not installed, mas handles that too:

brew install mas
mas account
mas install 869223134

Key Commands

# Verify permissions and DB access first
kakaocli status
kakaocli auth

# List recent conversations
kakaocli chats --limit 10 --json

# Read recent messages from a specific chat
kakaocli messages --chat "Jisoo" --since 1d --json

# Search across all conversations
kakaocli search "meeting" --json

# Test send to yourself (safe)
kakaocli send --me _ "test message"

# Dry-run to preview without sending
kakaocli send --dry-run "Team Announcements" "Meeting at 3pm today"

The safety design is worth noting. The skill workflow mandates a --dry-run preview before sending to anyone other than yourself, and actual dispatch requires explicit user confirmation. This prevents the AI agent from autonomously firing off messages — a sound default for any messaging automation.

Installation Flow

The standard setup follows three steps:

1. Follow docs/install.md to install all skills (Node.js and Python packages are both involved; global install is the default)
2. Run the k-skill-setup skill to verify credentials and environment variables
3. Read each feature doc to understand expected inputs, examples, and limitations

Skills that require authentication (SRT, KTX, Toss Securities) follow a documented credential resolution order defined in docs/setup.md. Secret storage rules and prohibited patterns are captured in docs/security-and-secrets.md, with standardized environment variable names to avoid conflicts.

The k-skill-proxy is a self-hostable proxy server for skills that need to reach public APIs (Seoul subway, fine dust, Coupang, Korean law). The proxy removes the need to configure API keys on the client side for those services.

Why k-skill Matters

The core problem k-skill addresses is straightforward: Korea’s internet ecosystem runs on a parallel set of platforms — KakaoTalk instead of iMessage or Slack, Korail and SRT instead of Amtrak, HWP files instead of Word or Google Docs, Coupang instead of Amazon. Global AI tooling is built around global services. None of these Korean platforms get first-class support out of the box.

k-skill fills that gap by packaging the knowledge of how to interact with each of these Korean-specific surfaces into reusable Claude Code skills. The approach is deliberately pragmatic: where a reliable MCP server exists (like coupang-mcp or korean-law-mcp), k-skill routes through it. Where it does not, the skill talks to official public interfaces directly or through a proxy.

The project itself is a solid piece of open-source engineering — multi-runtime (JavaScript + Python + Shell), versioned with npm Changesets, CI/CD on GitHub Actions, and a clear separation between skill logic and secret management. For Korean developers working with Claude Code, it is the most practical starting point for automating the parts of daily life that generic AI agents simply cannot reach.

• GitHub: NomaDamas/k-skill
• Stars: 1,371 | Forks: 113
• Primary language: JavaScript (Python and Shell also present)