@nomadamas/k-skill 0.1.0 → 0.2.1

package/skills/korean-patent-search/instruction.md

@@ -25,7 +25,7 @@ v1 범위:
 - KIPRIS Plus에서 발급받은 API 키
   - helper 환경변수: `KIPRIS_PLUS_API_KEY`
   - 실제 요청 쿼리 파라미터명: `ServiceKey`
-- 설치된 skill payload 안에 `scripts/patent_search.py` helper 포함
+- `@nomadamas/k-skill` CLI에 번들된 `scripts/patent_search.py` helper
 
 ## Inputs
 
@@ -51,9 +51,9 @@ v1 범위:
 
 ```bash
 export KIPRIS_PLUS_API_KEY=your-service-key
-python3 scripts/patent_search.py --query "배터리"
-python3 scripts/patent_search.py --query "배터리" --year 2024 --num-rows 5
-python3 scripts/patent_search.py --application-number 1020240001234
+npx -y @nomadamas/k-skill@0 exec korean-patent-search scripts/patent_search.py -- --query "배터리"
+npx -y @nomadamas/k-skill@0 exec korean-patent-search scripts/patent_search.py -- --query "배터리" --year 2024 --num-rows 5
+npx -y @nomadamas/k-skill@0 exec korean-patent-search scripts/patent_search.py -- --application-number 1020240001234
 ```
 
 ## Response policy

package/skills/korean-privacy-terms/instruction.md

@@ -40,7 +40,7 @@
 업스트림을 `~/.claude/skills/korean-privacy-terms/upstream/` 와 `~/.agents/skills/korean-privacy-terms/upstream/` 양쪽에 pinned SHA 로 체크아웃한다. 레포 내부에 업스트림 payload 를 커밋하지 않으므로 실사용 전 반드시 이 단계를 거친다.
 
 ```bash
-bash korean-privacy-terms/scripts/install.sh
+npx -y @nomadamas/k-skill@0 exec korean-privacy-terms scripts/install.sh --
 ```
 
 레포를 로컬에 clone 하지 않고 이미 홈 디렉토리 스킬 번들만 가진 상태에서도 설치할 수 있다 (installer 는 `${BASH_SOURCE[0]}` 로 절대경로를 해석하므로 cwd 에 구애받지 않는다):
@@ -77,7 +77,7 @@ bash ~/.agents/skills/korean-privacy-terms/scripts/install.sh
 ## Workflow
 
 1. 사용자가 트리거 문구를 말하면 먼저 위 인터뷰 게이트를 실행한다.
-2. `bash korean-privacy-terms/scripts/install.sh` 로 업스트림을 dual-install 한다 (이미 설치돼 있으면 pin 확인만 한다).
+2. `npx -y @nomadamas/k-skill@0 exec korean-privacy-terms scripts/install.sh --` 로 업스트림을 dual-install 한다 (이미 설치돼 있으면 pin 확인만 한다).
 3. 업스트림이 제공하는 순서를 따른다: `scripts/interview.md` → `scripts/render.md` → `scripts/install.md`.
 4. 업스트림은 Next.js 감지 → MDX/shadcn 의존성 설치 → 템플릿 치환 → `src/app/privacy/page.tsx` · `src/app/terms/page.tsx` · `src/components/legal/*` 등 파일 생성 → 법정 필수 11개 항목 검증 → 면책 주석 삽입 을 순차 실행한다.
 5. 생성이 끝나면 사용자에게 보고하되, 아래 **Response policy** 의 고정 블록을 반드시 포함한다.
@@ -85,9 +85,9 @@ bash ~/.agents/skills/korean-privacy-terms/scripts/install.sh
 ## CLI examples
 
 ```bash
-cat korean-privacy-terms/scripts/upstream.pin
+npx -y @nomadamas/k-skill@0 read korean-privacy-terms scripts/upstream.pin
 
-bash korean-privacy-terms/scripts/install.sh
+npx -y @nomadamas/k-skill@0 exec korean-privacy-terms scripts/install.sh --
 
 git -C ~/.claude/skills/korean-privacy-terms/upstream rev-parse HEAD
 git -C ~/.agents/skills/korean-privacy-terms/upstream rev-parse HEAD

package/skills/korean-scholarship-search/instruction.md

@@ -51,7 +51,7 @@
 4. 기업 공식 CSR/재단/채용·공지 페이지
 5. 비공식 모음글/블로그/커뮤니티는 **lead source** 로만 사용하고, 공식 공고로 교차검증되지 않으면 제외
 
-소스별 검색 패턴은 `references/source-patterns.md` 를 보고, 검색 누락을 줄이려면 `references/search-clues.md` 의 키워드와 제목 단서를 같이 쓴다.
+소스별 검색 패턴은 `npx -y @nomadamas/k-skill@0 read korean-scholarship-search references/source-patterns.md` 를 보고, 검색 누락을 줄이려면 `npx -y @nomadamas/k-skill@0 read korean-scholarship-search references/search-clues.md` 의 키워드와 제목 단서를 같이 쓴다.
 
 ## Inputs
 
@@ -114,12 +114,12 @@
 5. 첨부 PDF/HWP가 있으면 같이 열어 조건을 확인
 6. 교내 장학과 외부 추천 장학을 분리해서 정리
 
-학교 완전 탐색 체크리스트는 `references/school-discovery.md` 를 본다.
+학교 완전 탐색 체크리스트는 `npx -y @nomadamas/k-skill@0 read korean-scholarship-search references/school-discovery.md` 를 본다.
 
 학교별 search plan을 만들 때는:
 
 ```bash
-python3 scripts/university_search_plan.py \
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/university_search_plan.py -- \
   --school-name "부산대학교" \
   --department "컴퓨터공학과" \
   --year 2026
@@ -128,7 +128,7 @@ python3 scripts/university_search_plan.py \
 전국 대학 sweep query를 만들 때는:
 
 ```bash
-python3 scripts/university_search_plan.py --nationwide --year 2026
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/university_search_plan.py -- --nationwide --year 2026
 ```
 
 ### 3. 각 후보를 정규화한다
@@ -175,7 +175,7 @@ python3 scripts/university_search_plan.py --nationwide --year 2026
 여러 장학금 후보를 JSON으로 정리한 뒤:
 
 ```bash
-python3 scripts/scholarship_filter.py filter \
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/scholarship_filter.py -- filter \
   --input scholarships.json \
   --org-type foundation \
   --student-level undergraduate \
@@ -186,7 +186,7 @@ python3 scripts/scholarship_filter.py filter \
 지원 가능 여부 판정:
 
 ```bash
-python3 scripts/scholarship_filter.py eligibility \
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/scholarship_filter.py -- eligibility \
   --input scholarships.json \
   --school-name "서울대학교" \
   --student-level undergraduate \
@@ -198,7 +198,7 @@ python3 scripts/scholarship_filter.py eligibility \
 KST 기준 현재 날짜로 열린 공고만 readable 하게 보기:
 
 ```bash
-python3 scripts/scholarship_filter.py report \
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/scholarship_filter.py -- report \
   --input scholarships.json \
   --today 2026-04-14 \
   --only-open-now \
@@ -208,7 +208,7 @@ python3 scripts/scholarship_filter.py report \
 마감 임박 공고만 보기:
 
 ```bash
-python3 scripts/scholarship_filter.py report \
+npx -y @nomadamas/k-skill@0 exec korean-scholarship-search scripts/scholarship_filter.py -- report \
   --input scholarships.json \
   --today 2026-04-14 \
   --deadline-within-days 7
@@ -238,7 +238,7 @@ python3 scripts/scholarship_filter.py report \
 - 공식 공고 링크
 - 신청 링크
 
-더 자세한 form 규칙은 `references/report-format.md` 를 본다.
+더 자세한 form 규칙은 `npx -y @nomadamas/k-skill@0 read korean-scholarship-search references/report-format.md` 를 본다.
 
 ## Response policy
 
@@ -311,7 +311,7 @@ python3 scripts/scholarship_filter.py report \
 
 ## Notes
 
-- 한국장학재단 공식 장학·지원구간 표면은 `references/source-patterns.md` 참고
+- 한국장학재단 공식 장학·지원구간 표면은 `npx -y @nomadamas/k-skill@0 read korean-scholarship-search references/source-patterns.md` 참고
 - 학교별 장학 공지는 HTML 구조가 제각각이므로, 공고 제목/본문/첨부를 같이 읽어야 한다.
 - 장학금 "조건" 과 "우대사항" 을 섞지 않는다.
 - "등록금 전액" 같은 비정액 장학금은 `amount.text` 를 유지하고 수치가 없으면 `*_krw` 는 비워둔다.

package/skills/korean-slang-writing/instruction.md

@@ -36,7 +36,7 @@
 ## Prerequisites
 
 - `python3` 3.10+ (`argparse`, `urllib`, `unittest` 만 사용 — 추가 의존성 없음)
-- 스킬 디렉터리의 `scripts/*.py` helper (설치 시 자동 포함)
+- `@nomadamas/k-skill` CLI에 번들된 `scripts/*.py` helper
 - 나무위키 lookup 에는 인터넷 연결이 필요하지만, 실패해도 시드 인덱스만으로 안전하게 응답할 수 있다.
 
 ## Response contract
@@ -108,7 +108,7 @@
 ### 2. 시드 인덱스에서 후보 탐색
 
 ```bash
-python3 scripts/slang_search.py --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5 --format json
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_search.py -- --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5 --format json
 ```
 
 주요 옵션:
@@ -128,8 +128,8 @@ python3 scripts/slang_search.py --mood "긍정,유머" --context "SNS,마케팅"
 ### 3. (선택) 나무위키 원문 요약 확인
 
 ```bash
-python3 scripts/slang_lookup.py "중꺾마" --format json
-python3 scripts/slang_lookup.py "https://namu.wiki/w/%EC%A4%91%EA%BA%BE%EB%A7%88" --max-length 800
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_lookup.py -- "중꺾마" --format json
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_lookup.py -- "https://namu.wiki/w/%EC%A4%91%EA%BA%BE%EB%A7%88" --max-length 800
 ```
 
 - 성공 시 `title`, `summary` 를 돌려준다.
@@ -147,16 +147,16 @@ python3 scripts/slang_lookup.py "https://namu.wiki/w/%EC%A4%91%EA%BA%BE%EB%A7%88
 
 ```bash
 # 1) 특정 유행어 뜻/메타 바로 확인
-python3 scripts/slang_search.py --query "갓생" --format text
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_search.py -- --query "갓생" --format text
 
 # 2) 긍정 무드의 SNS 마케팅 후보 5개
-python3 scripts/slang_search.py --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_search.py -- --mood "긍정,유머" --context "SNS,마케팅" --safety safe --limit 5
 
 # 3) 이용자가 지정한 커스텀 인덱스로 전환
-python3 scripts/slang_search.py --query "중꺾마" --index-path ~/Downloads/my-slang.json
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_search.py -- --query "중꺾마" --index-path ~/Downloads/my-slang.json
 
 # 4) 나무위키 원문 요약 시도
-python3 scripts/slang_lookup.py "럭키비키" --timeout 10 --format text
+npx -y @nomadamas/k-skill@0 exec korean-slang-writing scripts/slang_lookup.py -- "럭키비키" --timeout 10 --format text
 ```
 
 ## Response policy

package/skills/korean-spell-check/instruction.md

@@ -33,7 +33,7 @@
 
 - 인터넷 연결
 - `python3` 3.10+
-- 이 스킬 디렉토리의 `scripts/korean_spell_check.py` (설치 시 자동 포함)
+- `@nomadamas/k-skill` CLI에 번들된 `scripts/korean_spell_check.py`
 
 ## Verified surface notes
 
@@ -58,7 +58,7 @@
 ### 3. Run the helper
 
 ```bash
-python3 scripts/korean_spell_check.py \
+npx -y @nomadamas/k-skill@0 exec korean-spell-check scripts/korean_spell_check.py -- \
   --file README.md \
   --format json
 ```
@@ -66,7 +66,7 @@ python3 scripts/korean_spell_check.py \
 짧은 문장은 `--text` 로 바로 넣을 수 있다.
 
 ```bash
-python3 scripts/korean_spell_check.py \
+npx -y @nomadamas/k-skill@0 exec korean-spell-check scripts/korean_spell_check.py -- \
   --text "아버지가방에들어가신다." \
   --format text
 ```

package/skills/korean-spell-check/skill.json

@@ -2,7 +2,6 @@
   "name": "korean-spell-check",
   "description": "Use Nara/PNU Korean spell-check surfaces conservatively to proofread Korean text, chunk long input, and return change-focused correction suggestions.",
   "profiles": [
-    "browser",
     "local"
   ],
   "frontmatter": "name: korean-spell-check\ndescription: Use Nara/PNU Korean spell-check surfaces conservatively to proofread Korean text, chunk long input, and return change-focused correction suggestions.\nlicense: MIT\nmetadata:\n  category: writing\n  locale: ko-KR\n  phase: v1"

package/skills/korean-stock-search/skill.json

@@ -3,7 +3,6 @@
   "description": "Use k-skill-proxy to search Korean listed stocks, inspect KRX base information, and fetch daily trade snapshots without asking the user to issue a KRX API key.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: korean-stock-search\ndescription: Use k-skill-proxy to search Korean listed stocks, inspect KRX base information, and fetch daily trade snapshots without asking the user to issue a KRX API key.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"

package/skills/korean-transit-route/skill.json

@@ -3,7 +3,6 @@
   "description": "Korean door-to-door public transit routing (subway + bus + walking) via ODsay LIVE API with Kakao geocoding for address-to-address queries. Use when the user asks for 지하철/버스/대중교통 길찾기, 환승 경로, 소요시간, or transit directions between two places in Korea.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: korean-transit-route\ndescription: Korean door-to-door public transit routing (subway + bus + walking) via ODsay LIVE API with Kakao geocoding for address-to-address queries. Use when the user asks for 지하철/버스/대중교통 길찾기, 환승 경로, 소요시간, or transit directions between two places in Korea.\nlicense: MIT\nmetadata:\n  category: transit\n  locale: ko-KR\n  phase: v1"

package/skills/kosis-stats/instruction.md

@@ -40,28 +40,15 @@
 - `bigdata` 또는 `--direct`: KOSIS Open API 인증키 (무료, https://kosis.kr/openapi/ 에서 회원가입 후 활용신청)
 
 ```bash
-python3 kosis-stats/scripts/run_kosis_stats.py --help
+npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- --help
 ```
 
-### Supporting files (단일 SKILL.md 설치 복구)
+### Bundled helper and reference
 
-이 스킬은 `SKILL.md` 외에 helper(`scripts/run_kosis_stats.py`)와 레퍼런스 문서(`references/kosis-openapi-guide.md`)에 의존하는 **디렉터리 패키지형 스킬**이다. raw `SKILL.md` URL만 받는 설치 도구(Hermes 등)로 설치하면 `scripts/`·`references/`가 누락되어 helper 실행이 실패한다.
-
-helper 실행 전에 파일 존재를 확인하고, 없으면 아래로 복구한다. `<skill-dir>`은 이 `SKILL.md`가 설치된 디렉터리다.
-
-```bash
-skill_dir="<skill-dir>"   # 예: ~/.hermes/skills/kosis-stats, ~/.claude/skills/kosis-stats
-if [ ! -f "$skill_dir/scripts/run_kosis_stats.py" ]; then
-  mkdir -p "$skill_dir/scripts" "$skill_dir/references"
-  curl -fsSL https://raw.githubusercontent.com/NomaDamas/k-skill/main/kosis-stats/scripts/run_kosis_stats.py \
-    -o "$skill_dir/scripts/run_kosis_stats.py"
-  curl -fsSL https://raw.githubusercontent.com/NomaDamas/k-skill/main/kosis-stats/references/kosis-openapi-guide.md \
-    -o "$skill_dir/references/kosis-openapi-guide.md"
-fi
-python3 "$skill_dir/scripts/run_kosis_stats.py" --help
-```
-
-근본적으로는 디렉터리 단위로 설치하는 방식(`npx --yes skills add NomaDamas/k-skill --skill kosis-stats -g` 또는 repo clone)을 권장한다.
+KOSIS helper와 OpenAPI guide reference는 `@nomadamas/k-skill` CLI 패키지에
+함께 번들된다. raw `SKILL.md`만 설치된 환경에서도 별도로 다운로드하거나
+복구하지 않는다. 조립된 instruction의 `k-skill exec`와 `k-skill read` 명령을
+사용한다.
 
 ## Required environment variables
 
@@ -69,7 +56,7 @@ python3 "$skill_dir/scripts/run_kosis_stats.py" --help
 - `KSKILL_PROXY_BASE_URL` — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted proxy를 사용한다.
 - `KSKILL_KOSIS_API_KEY` — `bigdata` 또는 `--direct`로 KOSIS를 직접 호출할 때만 필요하다.
 
-발급 절차와 호출 한도, 에러 코드 등 자세한 내용은 [`references/kosis-openapi-guide.md`](references/kosis-openapi-guide.md) 참고.
+발급 절차와 호출 한도, 에러 코드 등 자세한 내용은 `npx -y @nomadamas/k-skill@0 read kosis-stats references/kosis-openapi-guide.md` 참고.
 
 ### Credential resolution order (`bigdata` 또는 `--direct` 전용)
 
@@ -138,7 +125,7 @@ python3 "$skill_dir/scripts/run_kosis_stats.py" --help
 질문을 먼저 한국어 키워드로 좁히고 `search` 로 후보 통계표를 본다.
 
 ```bash
-python3 kosis-stats/scripts/run_kosis_stats.py search --query "1인 가구" --text
+npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- search --query "1인 가구" --text
 ```
 
 출력에서 `[ORG_ID/TBL_ID]`를 골라 다음 단계에 사용한다.
@@ -148,7 +135,7 @@ python3 kosis-stats/scripts/run_kosis_stats.py search --query "1인 가구" --te
 데이터를 받기 전에 분류/단위/주기를 확인한다.
 
 ```bash
-python3 kosis-stats/scripts/run_kosis_stats.py meta --table-id DT_1JC1501 --text
+npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- meta --table-id DT_1JC1501 --text
 ```
 
 ### 4. Fetch a small bounded slice first
@@ -156,7 +143,7 @@ python3 kosis-stats/scripts/run_kosis_stats.py meta --table-id DT_1JC1501 --text
 `--prd-se`, `--start`, `--end`, `--obj-l` 으로 범위를 좁혀 작은 슬라이스를 먼저 조회한다.
 
 ```bash
-python3 kosis-stats/scripts/run_kosis_stats.py data \
+npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- data \
   --table-id DT_1JC1501 --prd-se Y --start 2020 --end 2022 \
   --obj-l 1=ALL --json
 ```
@@ -172,7 +159,7 @@ python3 kosis-stats/scripts/run_kosis_stats.py data \
 `bigdata` 는 KOSIS 웹에서 미리 등록한 `userStatsId` 가 필요하다. 미등록 상태면 사용자에게 등록 안내만 하고 멈춘다.
 
 ```bash
-python3 kosis-stats/scripts/run_kosis_stats.py bigdata \
+npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- bigdata \
   --user-stats-id "openapisample/101/DT_1IN1502/2/1/20191106094026_1" \
   --format json --new-est-prd-cnt 5
 ```
@@ -217,8 +204,8 @@ python3 kosis-stats/scripts/run_kosis_stats.py bigdata \
 
 - `./scripts/validate-skills.sh`
 - `python3 -m py_compile kosis-stats/scripts/run_kosis_stats.py kosis-stats/tests/test_run_kosis_stats.py`
-- `python3 kosis-stats/scripts/run_kosis_stats.py --help`
-- `python3 kosis-stats/scripts/run_kosis_stats.py search --query 인구 --dry-run` (URL/파라미터 출력만)
+- `npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- --help`
+- `npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- search --query 인구 --dry-run` (URL/파라미터 출력만)
 - `PYTHONPATH=kosis-stats/scripts python3 -m unittest discover -s kosis-stats/tests -p 'test_*.py' -v`
 - `npm run ci`
 

package/skills/kr-whois-lookup/skill.json

@@ -3,8 +3,7 @@
   "description": "공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
     "proxy",
-    "vault",
-    "action:communication"
+    "lookup"
   ],
   "frontmatter": "name: kr-whois-lookup\ndescription: 공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: security\n  locale: ko-KR\n  phase: v1"
 }

package/skills/kstartup-search/instruction.md

@@ -101,7 +101,7 @@ API helper는 조회 전용이다. 돌쇠에서 사용자가 사업 신청을
 `--per-page 10` 정도로 먼저 한 페이지를 받아 응답 스키마를 확인한 뒤, 필터를 좁히거나 페이지를 넘긴다.
 
 ```bash
-python3 scripts/run_kstartup.py announcements \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- announcements \
   --supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text
 ```
 
@@ -122,23 +122,23 @@ API는 단순 필드 매칭만 지원하고, **그중 `supt_regin` 같은 일부
 
 ```bash
 # 서울 모집 중 공고 5건
-python3 scripts/run_kstartup.py announcements \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- announcements \
   --supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text
 
 # 2024년 사업화 분야 통합공고
-python3 scripts/run_kstartup.py business-info \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- business-info \
   --biz-yr 2024 --biz-category-cd cmrczn_Tab3 --json
 
 # 정책·공지 최신 콘텐츠
-python3 scripts/run_kstartup.py contents \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- contents \
   --clss-cd notice_matr --per-page 10 --text
 
 # 창업기업 실태조사 통계보고서
-python3 scripts/run_kstartup.py statistics \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- statistics \
   --titl-nm "창업기업 실태조사" --per-page 5 --json
 
 # 인증키 없이 dry-run 으로 요청 점검
-python3 scripts/run_kstartup.py announcements \
+npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- announcements \
   --supt-regin 부산광역시 --dry-run
 ```
 
@@ -171,8 +171,8 @@ K-Startup 인증키 없이도 다음 검증이 가능하다.
 
 - `./scripts/validate-skills.sh`
 - `python3 -m py_compile kstartup-search/scripts/run_kstartup.py kstartup-search/tests/test_run_kstartup.py`
-- `python3 kstartup-search/scripts/run_kstartup.py --help`
-- `python3 kstartup-search/scripts/run_kstartup.py announcements --supt-regin 서울특별시 --dry-run`
+- `npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- --help`
+- `npx -y @nomadamas/k-skill@0 exec kstartup-search scripts/run_kstartup.py -- announcements --supt-regin 서울특별시 --dry-run`
 - `PYTHONPATH=kstartup-search/scripts python3 -m unittest discover -s kstartup-search/tests -p 'test_*.py' -v`
 - `node --test packages/k-skill-proxy/test/server.test.js` (K-Startup 라우트 5개 신규 케이스 포함)
 - `npm run ci`

package/skills/ktx-booking/instruction.md

@@ -73,13 +73,13 @@ python3 -m pip install korail2-ncard pycryptodome
 항상 helper 를 통해 조회한다.
 
 ```bash
-python3 scripts/ktx_booking.py search 서울 부산 20260328 090000 --limit 5
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- search 서울 부산 20260328 090000 --limit 5
 ```
 
 기본 `--train-type` 은 `ktx` 다. ITX-청춘(예: 남춘천↔용산)·ITX-새마을·무궁화호처럼 KTX 외 노선을 잡으려면 `--train-type` 으로 지정한다.
 
 ```bash
-python3 scripts/ktx_booking.py search 남춘천 용산 20260503 150000 --train-type itx-cheongchun
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- search 남춘천 용산 20260503 150000 --train-type itx-cheongchun
 ```
 
 선택지: `ktx`, `itx-saemaeul`, `mugunghwa`, `nuriro`, `tonggeun`, `itx-cheongchun`, `airport`, `all`.
@@ -106,19 +106,19 @@ python3 scripts/ktx_booking.py search 남춘천 용산 20260503 150000 --train-t
 기본 상세 좌석 조회:
 
 ```bash
-python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <train_id>
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 서울 부산 20260328 090000 --train-id <train_id>
 ```
 
 일반실/특실은 `--room` 으로 나눈다.
 
 ```bash
-python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <train_id> --room special
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 서울 부산 20260328 090000 --train-id <train_id> --room special
 ```
 
 남은 좌석번호만 보고 싶으면 `--available-only` 를 쓴다.
 
 ```bash
-python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <train_id> --available-only
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 서울 부산 20260328 090000 --train-id <train_id> --available-only
 ```
 
 특정 호차를 지정하지 않으면 `seats` 는 **5호차를 최우선**으로 탐색한다. 5호차가 없으면 5호차와의 거리가 가까운 호차 순으로, 같은 거리에서는 낮은 호차 번호 순으로 탐색한다(예: 1~8호차 편성은 `5, 4, 6, 3, 7, 2, 8, 1`, 1~4호차 편성은 `4, 3, 2, 1`). 일반 KTX, KTX-산천(분류 코드 07·10), KTX-청룡 모두 같은 규칙을 적용한다. 각 호차 안의 좌석은 콘센트 힌트가 있는 좌석(`direct`, `adjacent`)을 먼저, 같은 조건에서는 순방향 좌석을 먼저 보여준다.
@@ -126,19 +126,19 @@ python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <t
 특정 호차만 확인하려면 `--car-no` 를 쓴다.
 
 ```bash
-python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <train_id> --car-no 5 --available-only
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 서울 부산 20260328 090000 --train-id <train_id> --car-no 5 --available-only
 ```
 
 콘센트 꿀팁 자리부터 확인하려면 `--power-only` 를 붙인다. 응답의 `power_outlet` 은 `direct`, `adjacent`, `none` 중 하나다.
 
 ```bash
-python3 scripts/ktx_booking.py seats 서울 부산 20260328 090000 --train-id <train_id> --available-only --power-only
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 서울 부산 20260328 090000 --train-id <train_id> --available-only --power-only
 ```
 
 `seats` 도 `search` 와 같은 `--train-type` 을 넘겨야 한다. ITX-청춘 등 KTX 외 열차를 조회했다면 상세 좌석 조회에도 같은 값을 사용한다.
 
 ```bash
-python3 scripts/ktx_booking.py seats 남춘천 용산 20260503 150000 \
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- seats 남춘천 용산 20260503 150000 \
   --train-id <train_id> \
   --train-type itx-cheongchun \
   --available-only
@@ -159,13 +159,13 @@ python3 scripts/ktx_booking.py seats 남춘천 용산 20260503 150000 \
 조회 결과의 `train_id` 를 고른 뒤에만 예약한다. 이 값은 helper 가 열차 번호/운행일/시각/역 코드를 묶어 만든 stable selector 이므로, 재조회 시 같은 열차가 아직 있으면 그대로 잡고 없으면 실패한다.
 
 ```bash
-python3 scripts/ktx_booking.py reserve 서울 부산 20260328 090000 --train-id <train_id> --seat-option general-first
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- reserve 서울 부산 20260328 090000 --train-id <train_id> --seat-option general-first
 ```
 
 ITX 등 KTX 외 노선을 search 단계에서 골랐다면 reserve 에도 똑같이 `--train-type` 을 넘긴다.
 
 ```bash
-python3 scripts/ktx_booking.py reserve 남춘천 용산 20260503 150000 --train-id <train_id> --train-type itx-cheongchun --seat-option general-first
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- reserve 남춘천 용산 20260503 150000 --train-id <train_id> --train-type itx-cheongchun --seat-option general-first
 ```
 
 응답에는 예약번호, 운임, 구입기한이 포함된다. 이 시점에 **좌석 확보는 완료되었다**고 안내한다. generic fallback에서는 결제를 handoff하고, 돌쇠에서는 아래 결제 단계로 계속 진행한다.
@@ -176,19 +176,19 @@ python3 scripts/ktx_booking.py reserve 남춘천 용산 20260503 150000 --train-
 N카드 할인을 적용하려면 먼저 보유 N카드 목록을 조회해 카드 번호를 확인한다.
 
 ```bash
-python3 scripts/ktx_booking.py ncard-list
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- ncard-list
 ```
 
 N카드로 할인 열차를 조회한다 (`--ncard-index` 는 `ncard-list` 결과의 순번). `ncard-list` 는 로그/셸 노출을 줄이기 위해 카드 번호를 마스킹해 출력한다.
 
 ```bash
-python3 scripts/ktx_booking.py ncard-search 대전 서울 20260512 100000 --ncard-index 1 --train-type ktx
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- ncard-search 대전 서울 20260512 100000 --ncard-index 1 --train-type ktx
 ```
 
 응답의 `train_id` 를 복사해 `reserve` 에 같은 `--ncard-index` 를 붙여 예약한다.
 
 ```bash
-python3 scripts/ktx_booking.py reserve 대전 서울 20260512 100000 \
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- reserve 대전 서울 20260512 100000 \
   --train-id <train_id> \
   --ncard-index 1
 ```
@@ -213,13 +213,13 @@ N카드 기능은 `korail2-ncard` 패키지가 필요하다. 없으면 해당
 취소는 대상 예약을 다시 조회해 식별한 뒤에만 진행한다.
 
 ```bash
-python3 scripts/ktx_booking.py reservations
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- reservations
 ```
 
 취소 실행 직전에 `clarify`로 예약번호, 열차, 날짜·시각, 승객, 환불/위약금 정보를 확인하고 승인받는다.
 
 ```bash
-python3 scripts/ktx_booking.py cancel <reservation_id>
+npx -y @nomadamas/k-skill@0 exec ktx-booking scripts/ktx_booking.py -- cancel <reservation_id>
 ```
 
 ## Done when