k‑Skill Core Features: Modular AI Utilities for Korean Services

k‑Skill is a modular collection of over 80 individual skills that lets AI agents perform everyday Korean tasks—from train ticket booking to legal searches and data look‑ups—through a unified CLI and free‑API proxy.

The k‑Skill framework provides ready‑made automation for Korean public services, financial APIs, and transit systems. Built as a monorepo with Node.js and Python workspaces, it eliminates the need for users to manage API keys for free public data while offering secure credential handling for services that require authentication.

Skill Packages: Modular Building Blocks

Every skill in k‑Skill is self‑contained and follows a standardized folder structure. Each package includes:

• SKILL.md – Human‑readable instructions consumed by the CLI.
• skill.json – Metadata declaring name, version, and capability requirements.
• Helper scripts – Node.js or Python implementations for execution.

This design lets developers add or remove capabilities without affecting the rest of the system. The CLI discovers these packages at runtime and stitches them together based on the metadata in each SKILL.md front‑matter block.

The front‑matter declares:

• Required environment variables
• Optional login flags
• References to helper scripts

Example skills include srt-booking for KTX reservations, korean-law-search for legal statutes, and real-estate-search for property transaction data.

Unified CLI and Runtime

The @nomadamas/k‑skill CLI provides installation, discovery, and execution without separate client libraries.

Core Commands

# Install the entire skill collection globally

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

# List all available skills

k-skill list

# Get detailed usage instructions for a specific skill

k-skill instruct srt-booking

# Execute a helper script directly

k-skill exec korean-spell-check scripts/korean_spell_check.py -- --text "아버지가방에들어가신다."

When a Dolshoi‑enabled environment is detected, the CLI automatically adds vault or CloakBrowser capabilities. Otherwise, it falls back to a generic instruction set. This conditional behavior is controlled at runtime through environment detection rather than configuration files.

k‑Skill‑Proxy: Free‑API Management

Public data endpoints requiring API keys are wrapped by the k-skill-proxy service at k-skill-proxy.nomadamas.org. Skills needing only free data call this proxy transparently.

# Proxy‑served Korean stock search—no user API key required

curl -fsS "https://k-skill-proxy.nomadamas.org/v1/korean-stock/search?q=삼성전자&bas_dd=20260408"

The proxy injects the free‑API credential server‑side. When the proxy is unavailable, skills fall back to direct public endpoints when possible. This proxy‑first data flow removes secret management burden from end users.

Source implementation: packages/k-skill-proxy/src/server.js

Credential Management for Paid Services

Skills requiring user credentials—such as Toss Securities or Popbill—invoke k‑skill‑setup to collect secrets via a secure .env file. All other skills operate without user‑provided secrets, creating a clear boundary between free public data and authenticated services.

The setup process:

1. Identifies required credentials from SKILL.md metadata
2. Prompts user for secrets through k‑skill‑setup
3. Validates environment before execution

Representative Skill Catalog

Skill	Category	Function
srt-booking	Transport	SRT schedules, seat availability, reservations, cancellations
ktx-booking	Transport	KTX/Korail ticket operations
seoul-subway-arrival	Transit	Real‑time Seoul subway arrival times
korean-transit-route	Navigation	End‑to‑end routing via ODsay LIVE API + Kakao geocoding
korean-law-search	Legal	Statutes, cases, and regulations (proxy‑served)
popbill	Finance	Tax invoices, SMS, Kakao, and fax APIs
real-estate-search	Real Estate	Apartment and officetel transaction prices
lotto-results	Entertainment	Lottery draws and ticket checking
korean-spell-check	NLP	Korean orthography and grammar correction
k-skill-setup	Core	Credential collection and environment validation

The complete catalog appears in README.md under the "어떤 걸 할 수 있나" section.

Monorepo Architecture

k‑Skill uses a dual‑workspace structure:

• Node workspaces – Located under packages/*, managed with Changesets for releases
• Python packages – Located under python-packages/*, managed with release‑please

Release automation rules are defined in AGENTS.md, which also governs CI policies and testing requirements.

Summary

• k‑Skill core features center on 80+ modular skill packages for Korean services, each with standardized SKILL.md descriptors and skill.json profiles.
• The unified CLI handles installation, discovery, and execution without external client libraries.
• k‑skill-proxy eliminates API key management for free public data endpoints.
• Credential isolation separates free services from authenticated ones through k-skill-setup and .env files.
• Monorepo structure supports both Node.js and Python implementations with automated release tooling.

Frequently Asked Questions

What types of tasks can k‑Skill automate?

k‑Skill covers transport (SRT/KTX booking, subway arrivals, transit routing), legal research (statute and case search), financial services (Popbill integration, stock data), real‑estate lookups, and utility functions like Korean spell‑checking. The full list exceeds 80 skills as cataloged in README.md.

Do I need API keys to use k‑Skill?

Only for authenticated services like Toss Securities or Popbill. Free public data—real‑estate transactions, law search, subway times—routes through k-skill-proxy.nomadamas.org, which injects credentials server‑side. Users never handle secrets for these endpoints.

How do I add a new skill to k‑Skill?

Create a folder with SKILL.md (with front‑matter metadata), skill.json, and helper scripts in Node.js or Python. Place it under packages/ or python-packages/ following existing structure. The CLI discovers it automatically on next k-skill list execution.

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