PlugWiki

seoul-subway-arrival Skill for Claude Code: Live Seoul Train Times

Shows live Seoul subway arrival times for a station, using the Seoul Open Data real-time API. Part of the k-skill collection.

Installs
9.2K
on skills.sh
Stars
8.2K
on GitHub
Files
2
besides SKILL.md
Updated
Nov 2026
last repo commit

seoul-subway-arrival makes your agent ask a hosted proxy for the trains arriving at a Seoul station, then summarize them. The summary lists the line, the direction, the first and second arrival messages and the time left, with the lookup time.

The SKILL.md in the folder is a short stub. It tells the agent to run an npx command to load the full instructions. The instructions say you do not need to get your own Seoul Open Data key. Seoul stations only.

Good for

  • People in Seoul who want to know when the next train reaches a station
  • Visitors planning a ride who want a quick check from chat
  • Claude Code and Codex users who already run skills

Install seoul-subway-arrival

Claude Code

  1. 1

    Copy this prompt.

    Install the seoul-subway-arrival skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

The plugin route installs every skill listed in the manifest (135) and namespaces them, for example /k-skill:lotto-results, so this one is /k-skill:seoul-subway-arrival. The repo root has no hooks, agents or .mcp.json file. The skills CLI route installs this skill alone. Pick one route, not both. The README suggests installing the whole set first and running the k-skill-setup skill for shared setup.

From the project README. Source.

What's in the skill

When it loads

Look up Seoul real-time subway arrival information with the official Seoul Open Data API. Use when the user asks when a train arrives, which trains are approaching a station, or how crowded Seoul subway timing looks right now.

Sections in SKILL.md

  1. Get the full instructions (required first step)
  2. Hard rules even without the CLI

Key facts

Author
NomaDamas (k-skill collection)
License
MIT (SKILL.md frontmatter)
Installs on skills.sh
9,192 (Nov 2, 2026)
GitHub stars
8,232 for the whole k-skill repo (Nov 2, 2026)
Last repo commit
Nov 1, 2026
Files in the folder
3: SKILL.md, instruction.md, skill.json
Needs
Node.js 18+ with npx; curl; jq is optional
Part of
The k-skill plugin and skill collection (135 skills listed in plugin.json)

What it includes

  • Runs an npx command from the k-skill package to get the full instructions

    SKILL.md says this is a required first step. The command is npx -y @nomadamas/k-skill@0 instruct seoul-subway-arrival.

    Runs code · Load instructions

  • Calls the hosted proxy for a station's real-time arrivals with curl

    Sends stationName to /v1/seoul-subway/arrival. The optional startIndex and endIndex limit how many rows come back.

    Try: “강남역 지금 몇 분 뒤 도착해?”

    Runs code · Query arrivals

  • Lists line, direction, first and second arrival messages and seconds left

    The instructions ask the agent to summarize only these items first.

    Summarize

  • Adds the lookup time because live data changes every few seconds

    The instructions ask for the lookup time in every answer.

    Mark the data time

From the official docs

Permissions

Medium risk

The skill runs a package from npm and sends the station name to a hosted proxy. Check the commands your agent proposes before you approve them.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It runs a package from npm every time

    SKILL.md tells the agent to run npx -y @nomadamas/k-skill@0 instruct seoul-subway-arrival first, and the real instructions come from that package at run time. The install guide says npx fetches the latest compatible 0.x version, so the instructions can change without you reinstalling. The -y flag installs the package without asking you. Review what your agent runs. github.com

  • The station name goes to a hosted proxy

    The query is sent to the hosted proxy, which holds the Seoul Open Data key. The README links a privacy notice for proxy-backed skills. Set KSKILL_PROXY_BASE_URL to use your own proxy. github.com

  • The k-skill CLI can send usage statistics

    Per the repo docs, each CLI call can send an event with a random local id, the command, the skill name, CLI version, runtime mode and success flag to PostHog. Command arguments, inputs and credentials are not in it. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com

Technical details
Talks tonpm registry (npx). k-skill-proxy.nomadamas.org. us.i.posthog.com (usage statistics unless opted out)
Sign-in and keysNo user key. The Seoul Open Data key is held by the hosted proxy, per instruction.md.
Scopes

  • Runs npx -y @nomadamas/k-skill@0 to load instructions

  • Runs curl against k-skill-proxy.nomadamas.org with the station name

Questions

What does seoul-subway-arrival do?

It answers questions like when the next train reaches a Seoul station. The agent fetches live arrival data and summarizes the line, direction and time left.

How do I install it?

Use the install box above. The plugin route installs the whole k-skill set; the skills CLI route installs this skill alone. You need Node.js 18 or newer, because the skill loads its instructions through npx.

Do I need a Seoul Open Data key?

The instructions say no. The key stays on the hosted proxy. You only set KSKILL_PROXY_BASE_URL if you run your own proxy.

Does it work in the Claude app or Claude.ai?

It runs curl and npx on your machine, so use Claude Code or another coding agent. The README lists Claude Code, Codex, OpenCode and OpenClaw/ClawHub as supported.

Is it safe?

It runs an npm package through npx and sends the station name to a hosted proxy. See the safety box for what to check. Its hard rules forbid payments, messages and public posts without your approval right before.

Why do I get no result or an error?

The instructions list three causes: the proxy has no upstream key set, the daily quota is used up, or the station name is spelled differently from the API. Seoul's guide says the real-time API can have a daily call limit.

Information

updated Nov 2, 2026

Repository
nomadamas/k-skill
Folder
seoul-subway-arrival

nomadamas/k-skillskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6
  1. k-skill README · github.com
  2. k-skill plugin.json · github.com
  3. k-skill install guide · github.com
  4. seoul-subway-arrival SKILL.md · github.com
  5. seoul-subway-arrival instruction.md · github.com
  6. k-skill CLI usage analytics · github.com

Updated Nov 2, 2026.