K Skill Setup
Finish shared configuration and credential verification after you install the full k-skill bundle globally.
Overview
k-skill-setup is an agent skill for the Build phase that configures and verifies shared k-skill credentials and environment after a full bundle install.
Install
npx skills add https://github.com/nomadamas/k-skill --skill k-skill-setupWhat is this skill?
- Four-step credential resolution order: env vars → agent vault → ~/.config/k-skill/secrets.env → prompt user
- Creates default secrets.env at 0600 when no vault is in use
- Never schedules cron/launchd/schtasks or runs gh star without explicit user consent
- Verifies runtime environment variables after install (e.g. npx skills add --all -g)
- ko-KR locale metadata; MIT license; setup phase v1
- 4-step credential resolution order
- default secrets path ~/.config/k-skill/secrets.env with permission 0600
Adoption & trust: 2.8k installs on skills.sh; 5.4k GitHub stars; 0/3 security scanners passed (skills.sh audits).
What problem does it solve?
You installed the whole k-skill pack but keys are scattered or missing and you are unsure which env names the other skills expect.
Who is it for?
Builders who just ran a global k-skill install and want vault-aware or secrets.env fallback setup before any paid or authenticated skill runs.
Skip if: Teams not using the k-skill bundle, or anyone who already has a locked credential flow and does not need bundle-wide verification.
When should I use this skill?
After the full k-skill installation finishes and before calling any credential-bearing k-skill.
What do I get? / Deliverables
Shared credentials resolve in a documented order, runtime env is verified, and only user-approved optional update or GitHub-star actions run.
- Resolved credentials in env or secrets.env
- Verified runtime environment for the bundle
- User-approved optional update or star actions only
Recommended Skills
Journey fit
Runs immediately post-install as the canonical shelf for wiring agent skills infrastructure before other k-skill capabilities. Agent-tooling is where bundle-wide secrets, env checks, and optional update/star hooks belong—not product feature code.
How it compares
Bundle post-install checklist, not a generic dotenv generator or marketplace MCP server.
Common Questions / FAQ
Who is k-skill-setup for?
Solo and indie builders using the nomadamas k-skill bundle who need one shared setup pass after installing all skills globally.
When should I use k-skill-setup?
Right after npx skills add completes in Build (agent-tooling); also when you rotate secrets in Operate (infra) before re-running credential-bearing k-skills.
Is k-skill-setup safe to install?
It is designed to avoid silent cron, task scheduler, or gh changes and to require consent for starring; review the Security Audits panel on this page before storing production secrets.
SKILL.md
READMESKILL.md - K Skill Setup
# k-skill Setup ## Purpose 전체 `k-skill` 설치가 끝난 뒤, 공통 후속 작업을 처리한다. - credential 확보 (에이전트 vault 또는 기본 secrets.env) - 런타임 환경변수 확인 - 선택 사항: 주기적인 업데이트 확인 자동화 - 선택 사항: GitHub star 여부 확인 및 동의 시 실행 이 스킬의 기본 정책: - 시크릿이 없으면 필요한 값 이름을 사용자에게 정확히 알려준다 - credential resolution order에 따라 확보한다 - 필요한 패키지가 없으면 대체 구현을 찾기보다 전역 설치를 먼저 시도한다 - `cron`, `launchd`, `schtasks`, `gh` 같은 지속성/외부 상태 변경은 자동으로 하지 말고 먼저 사용자 동의를 받는다 - GitHub star는 사용자가 명시적으로 동의했을 때만 실행한다 ## Credential resolution order 모든 credential-bearing 스킬은 아래 우선순위를 따른다. 1. **이미 환경변수에 있으면** 그대로 사용한다. 2. **에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면** 거기서 꺼내 환경변수로 주입해도 된다. 3. **`~/.config/k-skill/secrets.env`** (기본 fallback) — plain dotenv 파일, 퍼미션 `0600`. 4. **아무것도 없으면** 유저에게 물어서 2 또는 3에 저장한다. 기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다. ## Standard file location - secrets file (기본 fallback): `~/.config/k-skill/secrets.env` ## Install 이 스킬은 `k-skill` 전체 스킬 설치가 끝난 뒤 실행하는 것을 기본으로 한다. 예: ```bash npx --yes skills add <owner/repo> --all -g ``` 설치가 끝나면 이 스킬을 호출해 아래 setup 단계를 이어간다. ## Setup steps ### 1. Create the default secrets file (if no vault is in use) 에이전트가 자체 vault를 쓰지 않는 경우, 기본 fallback 파일을 만든다. ```bash mkdir -p ~/.config/k-skill cat > ~/.config/k-skill/secrets.env <<'EOF' KSKILL_SRT_ID=replace-me KSKILL_SRT_PASSWORD=replace-me KSKILL_KTX_ID=replace-me KSKILL_KTX_PASSWORD=replace-me KSKILL_FORESTTRIP_ID=replace-me KSKILL_FORESTTRIP_PASSWORD=replace-me LAW_OC=replace-me KIPRIS_PLUS_API_KEY=replace-me AIR_KOREA_OPEN_API_KEY=replace-me KSKILL_PROXY_BASE_URL= EOF chmod 0600 ~/.config/k-skill/secrets.env ``` 유저에게 물어서 실제 값을 채운다. 서울 지하철 도착정보, 서울 실시간 혼잡도 조회, 서울 따릉이 실시간 대여소 조회, 한국 날씨, 미세먼지, 한강 수위, 주유소 가격, 생활쓰레기 배출정보 조회, 학교 급식 식단 조회, 의약품 안전 체크, 식품 안전 체크는 `KSKILL_PROXY_BASE_URL` 을 비워 두면 기본 hosted path(`k-skill-proxy.nomadamas.org`)를 그대로 쓴다. 별도 self-host proxy를 쓸 때만 `KSKILL_PROXY_BASE_URL` 을 채운다. 한국 법령 검색은 로컬 `korean-law-mcp` 경로를 쓸 때만 `LAW_OC` 를 채운다. remote endpoint는 사용자 `LAW_OC` 없이 `url`만 등록하면 되고, 기존 경로 장애 시에는 `법망`(`https://api.beopmang.org`)을 fallback으로 안내한다. 한국 부동산 실거래가 조회는 기본 hosted proxy(`k-skill-proxy.nomadamas.org`)를 경유하므로 사용자 쪽 `DATA_GO_KR_API_KEY` 가 불필요하다. 한국 주식 정보 조회는 기본 hosted proxy(`k-skill-proxy.nomadamas.org`)를 경유하므로 사용자 쪽 `KRX_API_KEY` 가 불필요하다. self-host proxy 운영자만 서버 환경변수 `KRX_API_KEY` 를 사용한다. 도서관 도서 조회는 기본 hosted proxy(`k-skill-proxy.nomadamas.org`)를 경유하므로 사용자 쪽 `DATA4LIBRARY_AUTH_KEY` 가 불필요하다. self-host proxy 운영자만 서버 환경변수 `DATA4LIBRARY_AUTH_KEY` 를 사용한다. 생활쓰레기 배출정보 조회는 `k-skill-proxy`의 `/v1/household-waste/info` 라우트를 호출하고, `serviceKey`(`DATA_GO_KR_API_KEY`)는 proxy 서버에서 주입/관리하므로 사용자 쪽 `DATA_GO_KR_API_KEY` 가 불필요하다. 학교 급식 식단 조회는 `k-skill-proxy`의 `/v1/neis/school-search`·`/v1/neis/school-meal`을 호출하고, `KEDU_INFO_KEY`는 프록시 서버에만 두므로 사용자 쪽에 둘 필요가 없다. 도서관 도서 조회는 `k-skill-proxy`의 `/v1/data4library/*` 라우트를 호출하고, `DATA4LIBRARY_AUTH_KEY`는 프록시 서버에만 두므로 사용자 쪽에 둘 필요가 없다. 근처 가장 싼 주유소 찾기는 기본 hosted proxy를 경유하므로 사용자 쪽 `OPINET_API_KEY` 가 불필요하다. 의약품 안전 체크는 `k-skill-proxy`의 `/v1/mfds/drug-safety/lookup` 라우트를 호출하고, `DATA_GO_KR_API_KEY` 는 프록시 서버에서만 주입/관리하므로 사용자 쪽에 둘 필요가 없다. 식품 안전 체크는 `k-skill-proxy`의 `/v1/mfds/food-safety/search` 라우트를 호출하고, `DATA_GO_KR_API_KEY` 및 선택적 `FOODSAFETYKOREA_API_KEY` 는 프록시 서버에서만 주입/관리하므로 사용자 쪽에 둘 필요가 없다. 창업진흥원 K-Startup 조회는 `k-skill-proxy`의 `/v1/kstartup/*` 라우트를 호출하고, `ServiceKey`(`DATA_GO_KR_API_KEY`)는 프록시 서버에서만 주입/관리하므로 일반 조회는 사용자 쪽에 키가 필요 없다. `--direct` 호출을 쓸 때만 `KSKILL_KSTARTUP_API_KEY` 를 채운다. 한국 특허 정보 검색은 KIPRIS Plus Open API 경로를 쓸 때 `KIPRIS_PLUS_API_KEY` 를 채운다. helper는 이 값을 읽어 실제 요청에서 `ServiceKey` 쿼리 파라미터로 보낸다. 공공데이터포털에서 복사한 percent-encoded key도 그대로 넣어도 된다. ### Missing secret response template 인증 스킬에서 값이 빠졌을 때는 credential resolution