菜单
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 职业分类
대한민국 부모가 아이와 볼/들을 콘텐츠를 찾을 때 쓰는 스킬. YouTube Data API(packages/k-parent-source-youtube, safeSearch strict)로 교과 연계 영상·차 안 오디오형 콘텐츠·부모자녀 대화 주제를 추천한다. "차에서 들려줄 만한 거 추천해줘", "초3 과학 단원 연계 영상", "아이랑 대화할 주제 알려줘" 같은 요청에 사용.
대한민국 부모가 문화센터·도서관·지자체 강좌와 체험 프로그램을 찾을 때 쓰는 스킬. 서울 공공서비스예약·도서관정보나루·문화포털(packages/k-parent-source-seoul/library/culture)로 지역·연령·접수기간 기준으로 안내한다. "백화점 문화센터 강좌", "도서관 프로그램 신청", "주말 체험 강좌 찾아줘" 같은 요청에 사용. 접수기간이 있는 강좌·체험·예약형 전용이며, 야외 놀거리는 k-parent-play-finder, 축제는 k-parent-festival-finder. 예약·결제는 사용자 승인 전에는 실행하지 않습니다.
대한민국 부모 생활정보를 여러 소스에서 수집·정규화하는 내부 파이프라인 스킬. 출처·수집시각·freshness를 기록하며 학교·축제·행사·문화·트렌드 데이터를 모은다(packages/k-parent-source-naver runCollector). "여러 소스에서 부모 데이터 모아줘", "행사 수집 파이프라인 만들어줘" 같은 수집 작업에 사용. 최종 사용자용 단건 조회는 각 도메인 스킬(k-parent-school-info, k-parent-play-finder 등)을 쓴다.
대한민국 부모를 위한 가족 축제·행사 찾기 스킬. 한국관광공사 TourAPI searchFestival로 날짜·지역 기준 축제를 검색하고, 가족(아이) 동반 적합도를 정리해 추천한다. "이번 주말 가족 축제", "다음 달 우리 동네 행사", "아이랑 갈 만한 봄 축제" 같은 요청에 사용. 시작·종료일이 있는 명명된 축제·행사 전용이며, 상시 놀거리·실내 장소는 k-parent-play-finder, 여행 코스는 k-parent-travel-recommender.
대한민국 부모가 유치원·어린이집을 비교할 때 쓰는 스킬. 어린이집정보공개·유치원현황(packages/k-parent-source-childinfo)으로 운영시간·비용·교직원·급식/위생/안전·CCTV/차량·방과후를 비교한다. "근처 유치원 비교해줘", "국공립 유치원 모집 언제야", "어린이집 방과후 되는 곳 찾아줘" 같은 요청에 사용. 초·중·고 학교는 k-parent-school-info.
대한민국 부모의 일반 지식·생활 판단 질문에 출처 기반으로 답하는 스킬. 더 구체적인 k-parent 스킬이 다루지 않는 영역을 보조한다. "예방접종 일정 일반적으로 어떻게 돼", "초등 입학 전에 뭘 준비해야 해", 특정 스킬로 분류되지 않는 부모 생활 질문에 사용. 학교·유치원·신청·식단 등 구체 조회는 해당 전용 스킬로 라우팅한다.
| 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
LAW_OC=replace-me
KIPRIS_PLUS_API_KEY=replace-me
AIR_KOREA_OPEN_API_KEY=replace-me
KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
EOF
chmod 0600 ~/.config/k-skill/secrets.env
유저에게 물어서 실제 값을 채운다.
서울 지하철 도착정보와 한국 날씨 조회는 hosted public route rollout 이 끝나기 전까지 KSKILL_PROXY_BASE_URL 을 self-host 또는 배포 확인이 끝난 proxy URL 로 채운다. 미세먼지, 한강 수위, 주유소 가격, 생활쓰레기 배출정보 조회, 학교 급식 식단 조회, 의약품 안전 체크, 식품 안전 체크는 KSKILL_PROXY_BASE_URL 을 비워 두면 기본 hosted path(k-skill-proxy.nomadamas.org)를 그대로 쓴다.
한국 법령 검색은 로컬 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 는 프록시 서버에서만 주입/관리하므로 사용자 쪽에 둘 필요가 없다.
한국 특허 정보 검색은 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 + korean-law-mcpLAW_OC 없이 url만 등록, 장애 시 법망 fallbackKIPRIS_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 서버만)KSKILL_PROXY_BASE_URLKSKILL_PROXY_BASE_URLKSKILL_PROXY_BASE_URL 또는 AIR_KOREA_OPEN_API_KEY시크릿이 비어 있다는 이유로 다른 서비스나 비공식 우회 경로를 자동 선택하지 않는다.
bash scripts/check-setup.sh
setup이 끝나면 사용자에게 주기적인 업데이트 확인 자동화를 원하는지 먼저 묻는다. 원하지 않으면 건너뛴다.
기본 정책:
업데이트 확인 만 기본으로 제안한다crontab, launchd, schtasks)은 동의 없이 적용하지 않는다npx --yes skills check자동 업데이트 를 원할 때만 npx --yes skills update 기반 스케줄을 별도로 제안한다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 repo star 를 실행하지 않는다gh 가 없거나 인증되지 않았으면 설치/로그인 안내만 하고 자동 우회하지 않는다NomaDamas/k-skill 이다동의했고 gh auth status 가 정상이면:
gh repo star NomaDamas/k-skill
성공하면 짧게 완료만 알린다.
~/.config/k-skill/secrets.env exists with permission 0600 (또는 에이전트가 자체 vault로 credential을 관리 중)