k-skill-setup Skill for Claude: Set Up the Korean k-skill Bundle

Walks Claude through installing the Korean k-skill bundle, running its CLI, setting credentials and checking that it all works.

Installs: 9.8K; on skills.sh
Stars: 8.2K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

k-skill-setup is the first stop after you install k-skill, a bundle of Korean daily-life and work skills. It makes Claude install the skills, run the k-skill command line tool, find the credentials each skill needs, and verify the setup. The repo README says to run it after the full install.

The SKILL.md is a short stub. It tells Claude to run npx -y @nomadamas/k-skill@0 instruct k-skill-setup and follow the output, so the live instructions come from an npm package at run time. The same steps are in the repo's instruction.md. It needs Node.js 18 or newer. The text is written in Korean.

Good for

People in Korea who want agent skills for KTX, Coupang, KakaoTalk, government sites and more
Anyone who installed the k-skill bundle and now needs credentials and a setup check
Users who want update checks for their agent skills

Install k-skill-setup

Claude Code

Copy this prompt.

Install the k-skill-setup 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
Paste it into Claude Code. It shows the change and asks before running it.

Requires Claude Code.

The README recommends installing the whole bundle first, then running k-skill-setup. The plugin and the skills CLI do not need to be combined. After a plugin install, call the skill as /k-skill:k-skill-setup. The --all -g command installs for every coding agent the skills CLI finds.

From the project README. Source.

What's in the skill

When it loads

Install the k-skill bundle, use the unified CLI, resolve credentials, verify the runtime, and optionally configure update checks and GitHub starring.

Sections in SKILL.md

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

Key facts

Author: NomaDamas (repo owner of NomaDamas/k-skill)
License: MIT in SKILL.md and plugin.json; the proxy server folders are AGPL-3.0-only
Installs on skills.sh: 9,787 (Nov 2, 2026)
GitHub stars: 8,232 for the whole repo (Nov 2, 2026)
Last commit: Nov 1, 2026
Files: 4 files including SKILL.md: instruction.md, skill.json and scripts/check-setup.sh
Needs: Node.js 18 or newer with npx; Python 3.11 and uv only for the KTX timetable helper
Bundle: Plugin manifest lists 135 skill folders; the README says 90+ skills
Works in: Claude Code, Codex, OpenCode and OpenClaw/ClawHub, per the README
skills.sh audits: Gen Agent Trust Hub: warn; Socket: warn; Snyk: warn (Nov 2, 2026)

What it includes

Installs the whole bundle with the skills CLI, or through the Claude Code plugin
The first step runs `npx --yes skills add NomaDamas/k-skill --all -g`, or the Claude Code plugin commands. You do not need both.
Write · 1. Install the skills
Runs update, instruct, list, exec and read through npx
`update` refreshes the CLI and every coding agent's global k-skill install. `exec` and `read` open a skill's bundled scripts and references.
Write · 2. Use the k-skill CLI
Looks in environment variables, an agent vault, then ~/.config/k-skill/secrets.env
It asks only for the values the skill you use needs. If the fallback file is needed it creates it with 0600 permissions. It tells you not to paste values into chat.
Write · 3. Resolve credentials
Runs scripts/check-setup.sh and shows Node and CLI versions
The script checks that the secrets file exists and has 600 permissions. It then reports what is ready and what you still need.
Read · 4. Verify the setup
Offers a daily `skills check` job on cron or Windows Task Scheduler
It asks first. The job writes a script under ~/.config/k-skill/bin and a log file. It is skipped unless you want it.
Write · 5. Optional update checks
Asks once, then stars the NomaDamas/k-skill repo with the gh command
It runs only if you agree and gh is signed in.
Write · 6. Optional GitHub star
No payments, messages, submissions or posts without your approval right before
SKILL.md also says never to ask for or store plaintext credentials in chat, files or shell arguments.
Hard rules

From the official docs

Permissions

High risk

This skill runs npx commands that fetch and run npm code, edits your global skill installs and can write a secrets file and a scheduled job. Read each command before you approve it, and decline the optional steps you do not need.

What it can do

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

Watch out for

It runs live npm code every time it starts
SKILL.md tells Claude to run npx -y @nomadamas/k-skill@0 instruct k-skill-setup and follow its output as the primary instructions. The instructions come from that npm package at run time, not from the file you installed, and the @0 tag floats across 0.x releases, so they can change without any change to SKILL.md. Read the output before Claude acts on it. github.com
Update changes every agent's global skills
The update command re-runs the skills CLI with --all -g, which refreshes the k-skill install for all coding agents on your machine. Use update --check if you only want to look. github.com
It can create a secrets file and a scheduled job
The credentials step may create ~/.config/k-skill/secrets.env with 0600 permissions. The optional update check writes a script and a cron entry or a Windows scheduled task. Both ask you first, and you can decline the job. github.com
The CLI sends usage statistics
The docs say a random local ID, the command, skill name, CLI version, runtime mode and success flag go to PostHog. Arguments, input, file contents and credentials are not collected, per the docs. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com
It can star a GitHub repo for you
The last step runs gh api to star NomaDamas/k-skill, only after you agree. github.com

Technical details

Turning on read-only	No read-only mode. `update --check` and `skills check` look without changing installs.
Talks to	us.i.posthog.com
Sign-in and keys	Credentials come from environment variables, an agent vault, or ~/.config/k-skill/secrets.env (0600). SKILL.md says never to ask for or store plaintext credentials in chat, files or shell arguments.
Scopes	Runs npx and the skills CLI on your machine Creates files under ~/.config/k-skill Optional: a scheduled job and a GitHub star

Questions

What does k-skill-setup do?

It guides Claude through setting up the k-skill bundle. That means installing the skills, using the k-skill CLI, finding credentials, checking the setup, and optionally scheduling update checks and starring the repo.

How do I install k-skill-setup?

Use the install box above. The README recommends installing the whole k-skill bundle first, either with the Claude Code plugin or with the skills CLI, and then running k-skill-setup. Pick one route, not both.

Do I need an API key?

Not for the setup skill itself. Each k-skill feature has its own needs, and k-skill-setup asks only for the values the skill you use requires. The instructions say several lookups use a hosted proxy, so you do not need your own upstream key for those.

Does it work in the Claude app?

There is no Claude app upload tab, because the skill runs npx commands and writes to your home folder. The README lists Claude Code, Codex, OpenCode and OpenClaw/ClawHub as supported agents.

Is k-skill-setup safe?

It runs npm code through npx and can change your global skill installs, so read each command before you approve it. The skill says payments, messages, submissions and posts need your approval right beforehand. Scheduled update checks and the GitHub star are optional, and the CLI sends usage statistics you can turn off.

What does the usage tracking send?

The docs say a random local ID, the command and skill name, CLI version, runtime mode and a success flag. They say command arguments, input, file contents, API responses and credentials are not collected. Set KSKILL_ANALYTICS_DISABLED=1 to opt out.

Is it only for people in Korea?

The bundle targets Korean services such as KTX, Coupang, KakaoTalk and government sites, and the setup text is in Korean. The README links English, Chinese and Japanese versions for foreign visitors and residents.

k-skill-setup vs k-skill-cleaner?

The README lists both as bundle management skills. k-skill-setup installs and configures the bundle. k-skill-cleaner interviews you and uses trigger counts per agent to suggest which k-skill skills to delete.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: k-skill-setup

nomadamas/k-skill skills.sh

Sources

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

Show all 9

k-skill README · github.com
instruction.md · github.com
k-skill install guide · github.com
SKILL.md · github.com
k-skill plugin.json · github.com
skills.sh listing · skills.sh
check-setup.sh · github.com
CLI usage analytics · github.com
Security and secrets · github.com