القائمة
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을 관리 중)