메뉴
After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | k-skill-setup |
| description | After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent. |
| license | MIT |
| metadata | {"category":"setup","locale":"ko-KR","phase":"v1"} |
전체 k-skill 설치가 끝난 뒤, 공통 후속 작업을 처리한다.
이 스킬의 기본 정책:
cron, launchd, schtasks, gh 같은 지속성/외부 상태 변경은 자동으로 하지 말고 먼저 사용자 동의를 받는다모든 credential-bearing 스킬은 아래 우선순위를 따른다.
~/.config/k-skill/secrets.env (기본 fallback) — plain dotenv 파일, 퍼미션 0600.기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다.
~/.config/k-skill/secrets.env이 스킬은 k-skill 전체 스킬 설치가 끝난 뒤 실행하는 것을 기본으로 한다.
예:
npx --yes skills add <owner/repo> --all -g
설치가 끝나면 이 스킬을 호출해 아래 setup 단계를 이어간다.
에이전트가 자체 vault를 쓰지 않는 경우, 기본 fallback 파일을 만든다.
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
KSKILL_EV_CHARGER_API_KEY=replace-me
KSKILL_BUILDING_REGISTER_API_KEY=replace-me
KSKILL_RISS_API_KEY=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)를 그대로 쓴다. 전기차 충전소와 건축물대장 표제부 조회도 같은 기본 hosted path를 쓴다. 별도 self-host proxy를 쓸 때만 KSKILL_PROXY_BASE_URL 을 채운다.
한국 법령 검색은 기본 hosted proxy(k-skill-proxy.nomadamas.org)의 /v1/korean-law/... endpoint를 경유하므로 사용자 쪽 LAW_OC 가 불필요하다. self-host proxy 운영자만 서버 환경변수 LAW_OC 를 채운다(무료 발급: https://open.law.go.kr).
한국 부동산 실거래가 조회는 기본 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 를 채운다.
전기차 충전소 조회는 k-skill-proxy의 /v1/ev-charger/info·/v1/ev-charger/status를 호출하므로 일반 사용자는 키가 필요 없다. --direct에서만 KSKILL_EV_CHARGER_API_KEY 또는 DATA_GO_KR_API_KEY를 사용하고, 데이터셋 15076352 활용신청은 별도로 해야 한다(자동승인).
건축물대장 표제부 조회는 k-skill-proxy의 /v1/building-register/title을 호출하므로 일반 사용자는 키가 필요 없다. 주소 입력은 같은 proxy의 Kakao geocode를 먼저 사용한다. --direct에서만 KSKILL_BUILDING_REGISTER_API_KEY 또는 DATA_GO_KR_API_KEY를 사용하고 데이터셋 15134735 활용신청을 별도로 해야 한다(자동승인).
KERIS/RISS 학술자료 검색은 RISS 검색 API가 기관 전용 키를 요구해 k-skill-proxy를 거치지 않는다. 사용자가 직접 발급받은 KSKILL_RISS_API_KEY(호환 RISS_API_KEY)를 설정해 상류를 호출한다. RISS 키는 비영리 기관/대학에만 발급되며 RISS 검색에는 DATA_GO_KR_API_KEY를 사용하지 않는다.
한국 특허 정보 검색은 KIPRIS Plus Open API 경로를 쓸 때 KIPRIS_PLUS_API_KEY 를 채운다. helper는 이 값을 읽어 실제 요청에서 ServiceKey 쿼리 파라미터로 보낸다. 공공데이터포털에서 복사한 percent-encoded key도 그대로 넣어도 된다.
인증 스킬에서 값이 빠졌을 때는 credential resolution order에 따라 확보한다.
필요한 값 예:
KSKILL_SRT_ID, KSKILL_SRT_PASSWORDKSKILL_KTX_ID, KSKILL_KTX_PASSWORDKSKILL_FORESTTRIP_ID, KSKILL_FORESTTRIP_PASSWORDLAW_OC)KIPRIS_PLUS_API_KEYKRX_API_KEY)serviceKey는 proxy 서버 주입, 호출 시 pageNo=1·numOfRows=100 필수)KEDU_INFO_KEY는 proxy 서버만)DATA4LIBRARY_AUTH_KEY는 proxy 서버만)DATA_GO_KR_API_KEY는 proxy 서버만)DATA_GO_KR_API_KEY와 선택적 FOODSAFETYKOREA_API_KEY는 proxy 서버만)DATA_GO_KR_API_KEY는 proxy 서버만; --direct 호출 때만 KSKILL_KSTARTUP_API_KEY)--direct 때만 KSKILL_EV_CHARGER_API_KEY 또는 DATA_GO_KR_API_KEY)--direct 때만 KSKILL_BUILDING_REGISTER_API_KEY 또는 DATA_GO_KR_API_KEY)KSKILL_RISS_API_KEY(호환 RISS_API_KEY) 필요 (RISS 검색 API는 비영리 기관/대학 전용 키로 직접 호출, proxy 미사용)SEOUL_OPEN_API_KEY)SEOUL_OPEN_API_KEY)KMA_OPEN_API_KEY)KSKILL_PROXY_BASE_URL 또는 AIR_KOREA_OPEN_API_KEY시크릿이 비어 있다는 이유로 다른 서비스나 비공식 우회 경로를 자동 선택하지 않는다.
이 스킬은 SKILL.md 단일 파일로 설치될 수 있으므로 별도 스크립트 파일에 의존하지 않고 아래 검증을 직접 실행한다.
secrets_file="$HOME/.config/k-skill/secrets.env"
if [ ! -f "$secrets_file" ]; then
echo "missing secrets file: $secrets_file"
echo "next steps:"
echo " 1. create ~/.config/k-skill/secrets.env with your credentials"
echo " 2. chmod 0600 ~/.config/k-skill/secrets.env"
else
perms=$(stat -f '%Lp' "$secrets_file" 2>/dev/null || stat -c '%a' "$secrets_file" 2>/dev/null)
if [ "$perms" != "600" ]; then
echo "insecure permissions on $secrets_file: $perms (expected 600)"
echo "run: chmod 0600 $secrets_file"
else
echo "k-skill setup looks usable"
fi
fi
repo 전체를 clone받은 경우에는 같은 검증을 bash scripts/check-setup.sh 로 실행해도 된다.
setup이 끝나면 사용자에게 주기적인 업데이트 확인 자동화를 원하는지 먼저 묻는다. 원하지 않으면 건너뛴다.
기본 정책:
업데이트 확인 만 기본으로 제안한다crontab, launchd, schtasks)은 동의 없이 적용하지 않는다npx --yes skills check자동 업데이트 를 원할 때만 npx --yes skills update 기반 스케줄을 별도로 제안한다skills CLI 버전에 따라 check에 -g 같은 옵션을 붙이면 확인을 넘어 설치본을 덮어쓸 수 있다. 자동화 스크립트에는 옵션 없는 npx --yes skills check 만 사용하고, 실제 업데이트 적용은 사용자가 검토 후 직접 실행하도록 안내한다macOS / Linux 예시:
mkdir -p ~/.config/k-skill/bin ~/.config/k-skill/logs
cat > ~/.config/k-skill/bin/check-skill-updates.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
mkdir -p "$HOME/.config/k-skill/logs"
{
date '+[%Y-%m-%d %H:%M:%S]'
npx --yes skills check
printf '\n'
} >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
EOF
chmod +x ~/.config/k-skill/bin/check-skill-updates.sh
(crontab -l 2>/dev/null; echo "0 9 * * * $HOME/.config/k-skill/bin/check-skill-updates.sh") | crontab -
Windows 예시:
New-Item -ItemType Directory -Force "$HOME/.config/k-skill/bin" | Out-Null
New-Item -ItemType Directory -Force "$HOME/.config/k-skill/logs" | Out-Null
@'
npx --yes skills check >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
'@ | Set-Content "$HOME/.config/k-skill/bin/check-skill-updates.cmd"
schtasks /Create /SC DAILY /TN "k-skill-update-check" /TR "\"$HOME/.config/k-skill/bin/check-skill-updates.cmd\"" /ST 09:00 /F
설정 후에는 로그 위치를 짧게 알려준다:
~/.config/k-skill/logs/skills-check.logsetup 마지막에는 다음처럼 짧게 묻는다.
k-skill 저장소(NomaDamas/k-skill)에 GitHub star를 눌러드릴까요?
원하시면 `gh` 로 바로 처리하고, 원하지 않으면 건너뜁니다.
규칙:
gh 가 없거나 인증되지 않았으면 설치/로그인 안내만 하고 자동 우회하지 않는다NomaDamas/k-skill 이다동의했고 gh auth status 가 정상이면 GitHub API로 star를 실행한다. (gh CLI에는 repo star 서브커맨드가 없다.)
# 이미 star 여부 확인: 204 = 이미 star, 404 = 아직
gh api user/starred/NomaDamas/k-skill >/dev/null 2>&1 && echo "already starred" || echo "not starred yet"
# star 실행
gh api -X PUT user/starred/NomaDamas/k-skill
성공하면 짧게 완료만 알린다.
~/.config/k-skill/secrets.env exists with permission 0600 (또는 에이전트가 자체 vault로 credential을 관리 중)Korean apartment and individual-house official price lookup through the public realtyprice.kr web data surface. Use when the user asks for 공동주택가격, 개별주택가격, 아파트 공시가격, 단독주택 공시가격, or housing official price history. This is not land official price, transaction price, or building register metadata.
한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats).
한국도로공사·국가교통정보센터 공개 API로 고속도로 실시간 소통(구간별 속도/교통량/정체 등급)과 CCTV 스트림 메타데이터를 조회한다. Use when the user asks 고속도로 정체, 교통 상황, 노선/구간 소통, 고속도로 CCTV. Not for 대중교통 길찾기 or 자동차 경로 안내.
국가데이터처가 운영하는 KOSIS(국가통계포털, kosis.kr) Open API로 한국 공식 통계표를 검색하고 메타데이터·데이터·대용량 자료를 조회한다. Use when the user asks for 한국 공식 통계 (인구, 가구, 물가, 고용 등) 수치 조회, not for analysis or visualization.
Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips.
Use when the user asks to search Korean theses, academic articles, research reports, journals, or university-library catalog metadata through KERIS RISS.