@nomadamas/k-skill 0.1.0 → 0.2.0

package/bin/k-skill.js

@@ -1,7 +1,14 @@
 #!/usr/bin/env node
 "use strict";
 
-const { assemble, bundledFiles, listSkills } = require("../src/assemble");
+const {
+  assemble,
+  bundledFiles,
+  listSkills,
+  readBundledAsset,
+  resolveBundledAsset,
+} = require("../src/assemble");
+const { runBundledScript } = require("../src/execute");
 const { detectRuntime } = require("../src/detect");
 
 function usage() {
@@ -10,6 +17,10 @@ function usage() {
     "",
     "Commands:",
     "  instruct <skill>   Print runtime-aware assembled instructions for a skill",
+    "  exec <skill> <script> -- [args...]",
+    "                     Execute a bundled scripts/ helper with its declared shebang",
+    "  read <skill> <file> Read a bundled references/ or text scripts/ asset",
+    "  path <skill> <file> Print the absolute path of a bundled asset",
     "  files <skill>      Print local paths of the skill's bundled helper files",
     "  list               List bundled skills",
     "",
@@ -19,7 +30,7 @@ function usage() {
 }
 
 function main() {
-  const [command, skillName] = process.argv.slice(2);
+  const [command, skillName, assetPath, ...rawArgs] = process.argv.slice(2);
 
   if (!command || command === "--help" || command === "-h") {
     console.log(usage());
@@ -31,7 +42,7 @@ function main() {
     return 0;
   }
 
-  if (command === "instruct" || command === "files") {
+  if (["instruct", "files", "exec", "read", "path"].includes(command)) {
     if (!skillName) {
       console.error(`error: "${command}" requires a skill name\n\n${usage()}`);
       return 1;
@@ -40,12 +51,31 @@ function main() {
     try {
       if (command === "instruct") {
         process.stdout.write(assemble(skillName, detectRuntime()));
-      } else {
+      } else if (command === "files") {
         for (const filePath of bundledFiles(skillName)) console.log(filePath);
+      } else {
+        if (!assetPath) {
+          console.error(`error: "${command}" requires an asset path\n\n${usage()}`);
+          return 1;
+        }
+
+        if (command === "exec") {
+          const args = rawArgs[0] === "--" ? rawArgs.slice(1) : rawArgs;
+          return runBundledScript(skillName, assetPath, args).status;
+        }
+        if (command === "read") {
+          process.stdout.write(readBundledAsset(skillName, assetPath));
+          return 0;
+        }
+        console.log(resolveBundledAsset(skillName, assetPath));
       }
       return 0;
     } catch (error) {
-      if (error.code === "EUNKNOWNSKILL") {
+      if (
+        ["EUNKNOWNSKILL", "EASSETPATH", "EASSETNOTFOUND", "EUNSUPPORTEDSCRIPT"].includes(
+          error.code,
+        )
+      ) {
         console.error(`error: ${error.message}`);
         return 1;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nomadamas/k-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "k-skill unified CLI: assembles runtime-aware skill instructions and ships bundled helper files",
   "license": "MIT",
   "bin": {
@@ -31,7 +31,7 @@
     "cli"
   ],
   "scripts": {
-    "lint": "node --check bin/k-skill.js && node --check src/assemble.js && node --check src/detect.js && node --check test/cli.test.js",
+    "lint": "node --check bin/k-skill.js && node --check src/assemble.js && node --check src/detect.js && node --check src/execute.js && node --check test/cli.test.js",
     "test": "node --test"
   }
 }

package/skills/assembly-bill-vote-search/skill.json

@@ -3,7 +3,6 @@
   "description": "열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: assembly-bill-vote-search\ndescription: 열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.\nlicense: MIT\nmetadata:\n  category: civic\n  locale: ko-KR\n  phase: v1"

package/skills/biz-health-check/instruction.md

@@ -48,10 +48,10 @@
 ## CLI examples
 
 ```bash
-python3 biz-health-check/scripts/biz_health_check.py 124-81-00998 --name "삼성전자"
+npx -y @nomadamas/k-skill@0 exec biz-health-check scripts/biz_health_check.py -- 124-81-00998 --name "삼성전자"
 
 # 동네 사업장까지 포함
-python3 biz-health-check/scripts/biz_health_check.py --name "호텔샬롬" --region 제주제주시 --industry 숙박업
+npx -y @nomadamas/k-skill@0 exec biz-health-check scripts/biz_health_check.py -- --name "호텔샬롬" --region 제주제주시 --industry 숙박업
 ```
 
 ## Output

package/skills/biz-health-check/skill.json

@@ -3,7 +3,6 @@
   "description": "사업자등록번호 하나로 \"이 사업자, 실제 문제 없나\"를 확인한다 — 국세청 사업자등록 상태·국민연금 가입 사업장·국세 체납 명단·금융위 법인개요·조달청 부정당제재·지방행정 인허가 영업상태를 무료 공공 데이터로 교차 조회해 사실만 병렬하는 실사 리포트(점수·등급·위험 판정 없음).",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: biz-health-check\ndescription: 사업자등록번호 하나로 \"이 사업자, 실제 문제 없나\"를 확인한다 — 국세청 사업자등록 상태·국민연금 가입 사업장·국세 체납 명단·금융위 법인개요·조달청 부정당제재·지방행정 인허가 영업상태를 무료 공공 데이터로 교차 조회해 사실만 병렬하는 실사 리포트(점수·등급·위험 판정 없음).\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1"

package/skills/bok-ecos-stats/instruction.md

@@ -40,9 +40,9 @@
 ### 1. 자주 쓰는 지표는 alias로 바로 조회
 
 ```bash
-python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 기준금리 --start 20260101 --end 20260721 --text
-python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 원달러환율 --start 20260701 --end 20260721 --text
-python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 소비자물가지수 --start 202501 --end 202606 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- search --alias 기준금리 --start 20260101 --end 20260721 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- search --alias 원달러환율 --start 20260701 --end 20260721 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- search --alias 소비자물가지수 --start 202501 --end 202606 --text
 ```
 
 지원 alias: `기준금리`, `원달러환율`, `소비자물가지수`(=`cpi`), `M2`(=`통화량`), `국고채3년`.
@@ -52,22 +52,22 @@ python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 소비자물가지수
 ### 2. 최신 핵심지표 한 번에 보기
 
 ```bash
-python3 bok-ecos-stats/scripts/bok_ecos.py key --limit 10 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- key --limit 10 --text
 ```
 
 ### 3. 임의 통계표 탐색 → 항목 확인 → 시계열 조회
 
 ```bash
-python3 bok-ecos-stats/scripts/bok_ecos.py tables --text
-python3 bok-ecos-stats/scripts/bok_ecos.py items --stat-code 722Y001 --text
-python3 bok-ecos-stats/scripts/bok_ecos.py search --stat-code 722Y001 --cycle D \
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- tables --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- items --stat-code 722Y001 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- search --stat-code 722Y001 --cycle D \
   --start 20260101 --end 20260721 --item-code 0101000 --text
 ```
 
 ### 4. 용어가 낯설면 사전 검색
 
 ```bash
-python3 bok-ecos-stats/scripts/bok_ecos.py word --query 소비자물가지수 --text
+npx -y @nomadamas/k-skill@0 exec bok-ecos-stats scripts/bok_ecos.py -- word --query 소비자물가지수 --text
 ```
 
 `--text` 없이 실행하면 구조화 JSON(`result`, `rows`, `source`)을 출력한다.

package/skills/bok-ecos-stats/skill.json

@@ -3,7 +3,6 @@
   "description": "한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats).",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: bok-ecos-stats\ndescription: 한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats).\nlicense: MIT\nmetadata:\n  category: data\n  locale: ko-KR\n  phase: v1"

package/skills/building-register-search/instruction.md

@@ -18,10 +18,10 @@
 ## Commands
 
 ```bash
-python3 scripts/building_register.py title --address '서울 강남구 역삼동 123-4'
-python3 scripts/building_register.py title --pnu 1168010100101230004
-python3 scripts/building_register.py title --sigungu-cd 11680 --bjdong-cd 10100 --plat-gb-cd 0 --bun 123 --ji 4
-python3 scripts/building_register.py title --pnu 1168010100101230004 --json
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --address '서울 강남구 역삼동 123-4'
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --pnu 1168010100101230004
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --sigungu-cd 11680 --bjdong-cd 10100 --plat-gb-cd 0 --bun 123 --ji 4
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --pnu 1168010100101230004 --json
 ```
 
 PNU는 `sigunguCd(5) + bjdongCd(5) + 토지구분(1) + bun(4) + ji(4)`의 19자리다. PNU 토지구분 `1`(일반 토지)은 건축물대장 API `platGbCd=0`, `2`(산)는 `platGbCd=1`로 변환한다. 개별 필드나 주소 결과로 PNU를 구성할 때도 API 값 `0`은 PNU `1`, API 값 `1`은 PNU `2`로 역변환한다. `--plat-gb-cd`를 직접 입력할 때는 PNU 값이 아니라 건축물대장 API 값이며 공식 값 `0`, `1`, `2`를 허용한다. API 값 `2`는 그대로 조회에 전달하되 대응하는 표준 PNU 토지구분이 없으므로 PNU를 구성하지 않는다. 개별 입력의 `bun`, `ji`는 4자리로 왼쪽 zero-padding되며 `ji` 생략 시 `0000`이다. `pageNo` 기본값은 1, `numOfRows` 기본값은 10이고 최대 100이다.
@@ -31,8 +31,8 @@ PNU는 `sigunguCd(5) + bjdongCd(5) + 토지구분(1) + bun(4) + ji(4)`의 19자
 ## Direct mode
 
 ```bash
-python3 scripts/building_register.py title --pnu 1168010100101230004 --direct
-python3 scripts/building_register.py title --pnu 1168010100101230004 --direct --dry-run
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --pnu 1168010100101230004 --direct
+npx -y @nomadamas/k-skill@0 exec building-register-search scripts/building_register.py -- title --pnu 1168010100101230004 --direct --dry-run
 ```
 
 `--direct`는 주소를 받지 않는다. `KSKILL_BUILDING_REGISTER_API_KEY`, 그다음 `DATA_GO_KR_API_KEY`, 마지막으로 `~/.config/k-skill/secrets.env`의 같은 키 순서로 찾는다. Kakao direct credential은 사용하지 않는다. `--dry-run`은 실제 키를 `REDACTED`로 가린다.

package/skills/cheap-gas-nearby/skill.json

@@ -3,7 +3,6 @@
   "description": "Use when the user asks for nearby cheapest gas stations or 근처 가장 싼 주유소. Always ask the user's current location first, then use Kakao Map anchor resolution plus official Opinet fuel-price APIs.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: cheap-gas-nearby\ndescription: Use when the user asks for nearby cheapest gas stations or 근처 가장 싼 주유소. Always ask the user's current location first, then use Kakao Map anchor resolution plus official Opinet fuel-price APIs.\nlicense: MIT\nmetadata:\n  category: transport\n  locale: ko-KR\n  phase: v1"

package/skills/corporate-registration-consulting/skill.json

@@ -2,7 +2,9 @@
   "name": "corporate-registration-consulting",
   "description": "법인등기소/인터넷등기소 상업등기 신청을 처음 하는 사용자를 위해 일반 영리 주식회사 발기설립 절차, 정관·첨부서류 실제 HWP 양식 작성, 등록면허세·과밀억제권역 중과 체크, rhwp 기반 순차 검토 흐름을 참고용으로 안내한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
   "profiles": [
-    "hard-boundary"
+    "vault",
+    "browser",
+    "legal"
   ],
   "frontmatter": "name: corporate-registration-consulting\ndescription: 법인등기소/인터넷등기소 상업등기 신청을 처음 하는 사용자를 위해 일반 영리 주식회사 발기설립 절차, 정관·첨부서류 실제 HWP 양식 작성, 등록면허세·과밀억제권역 중과 체크, rhwp 기반 순차 검토 흐름을 참고용으로 안내한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: legal-documents\n  locale: ko-KR"
 }

package/skills/coupang-product-search/instruction.md

@@ -85,18 +85,18 @@ local://coupang-mcp
 래퍼는 기본적으로 `~/.cache/k-skill/coupang_partners`에 upstream 저장소를 clone한다. 이미 clone되어 있으면 그대로 사용하고, 최신화가 필요할 때만 `--update`를 붙인다.
 
 ```bash
-python3 coupang-product-search/scripts/coupang_partners_mcp.py tools
-python3 coupang-product-search/scripts/coupang_partners_mcp.py init
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- tools
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- init
 ```
 
 기존 checkout을 명시하거나 CI/검증에서 네트워크 clone을 막으려면:
 
 ```bash
-python3 coupang-product-search/scripts/coupang_partners_mcp.py \
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- \
   --repo-dir /path/to/coupang_partners \
   --no-clone \
   tools
-python3 coupang-product-search/scripts/coupang_partners_mcp.py \
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- \
   --repo-dir /path/to/coupang_partners \
   --no-clone \
   init
@@ -108,19 +108,19 @@ python3 coupang-product-search/scripts/coupang_partners_mcp.py \
 
 ```bash
 # 일반 검색 (키 없이도 hosted fallback으로 작동)
-python3 coupang-product-search/scripts/coupang_partners_mcp.py search "32인치 4K 모니터"
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- search "32인치 4K 모니터"
 
 # 로켓배송 필터
-python3 coupang-product-search/scripts/coupang_partners_mcp.py rocket "에어팟"
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- rocket "에어팟"
 
 # 가격대 검색
-python3 coupang-product-search/scripts/coupang_partners_mcp.py budget "키보드" --max-price 100000
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- budget "키보드" --max-price 100000
 
 # 비교
-python3 coupang-product-search/scripts/coupang_partners_mcp.py compare "아이패드 vs 갤럭시탭"
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- compare "아이패드 vs 갤럭시탭"
 
 # 골드박스 (운영자 키가 필요한 upstream 경로)
-python3 coupang-product-search/scripts/coupang_partners_mcp.py goldbox
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- goldbox
 ```
 
 ### 4. (optional) hosted fallback 강제
@@ -129,7 +129,7 @@ python3 coupang-product-search/scripts/coupang_partners_mcp.py goldbox
 
 ```bash
 export OPENCLAW_SHOPPING_FORCE_HOSTED=1
-python3 coupang-product-search/scripts/coupang_partners_mcp.py search "에어팟"
+npx -y @nomadamas/k-skill@0 exec coupang-product-search scripts/coupang_partners_mcp.py -- search "에어팟"
 ```
 
 ### 5. Continue from discovery to cart and checkout in Dolshoi

package/skills/court-auction-notice-search/skill.json

@@ -2,8 +2,9 @@
   "name": "court-auction-notice-search",
   "description": "Browse 대법원경매정보(courtauction.go.kr) 부동산 매각공고 by 매각기일·법원·기일/기간 입찰, expand each notice into 사건번호·용도·주소·감정평가액·최저매각가, search property items by free conditions(지역·용도·가격·면적·유찰횟수), and look up a case directly by 법원+사건번호. Read-only, slow-by-design (~2s/call) to avoid IP blocks. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
   "profiles": [
+    "vault",
     "browser",
-    "hard-boundary"
+    "legal"
   ],
   "frontmatter": "name: court-auction-notice-search\ndescription: Browse 대법원경매정보(courtauction.go.kr) 부동산 매각공고 by 매각기일·법원·기일/기간 입찰, expand each notice into 사건번호·용도·주소·감정평가액·최저매각가, search property items by free conditions(지역·용도·가격·면적·유찰횟수), and look up a case directly by 법원+사건번호. Read-only, slow-by-design (~2s/call) to avoid IP blocks. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: real-estate\n  locale: ko-KR\n  phase: v1"
 }

package/skills/court-payment-order-assistant/skill.json

@@ -4,7 +4,7 @@
   "profiles": [
     "vault",
     "browser",
-    "hard-boundary"
+    "legal"
   ],
   "frontmatter": "name: court-payment-order-assistant\ndescription: 법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: legal\n  locale: ko-KR\n  phase: v1"
 }

package/skills/d2b-notice-search/skill.json

@@ -3,8 +3,9 @@
   "description": "국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
   "profiles": [
     "proxy",
+    "vault",
     "browser",
-    "hard-boundary"
+    "legal"
   ],
   "frontmatter": "name: d2b-notice-search\ndescription: 국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: procurement\n  locale: ko-KR\n  phase: v1"
 }

package/skills/daangn-cars-search/instruction.md

@@ -41,9 +41,9 @@
 ## Commands
 
 ```bash
-python3 daangn-cars-search/scripts/daangn_cars.py search "레이" --region "합정동" --limit 5
-python3 daangn-cars-search/scripts/daangn_cars.py search --region "합정동" --price-max 10000000 --limit 5
-python3 daangn-cars-search/scripts/daangn_cars.py detail "https://www.daangn.com/kr/cars/.../"
+npx -y @nomadamas/k-skill@0 exec daangn-cars-search scripts/daangn_cars.py -- search "레이" --region "합정동" --limit 5
+npx -y @nomadamas/k-skill@0 exec daangn-cars-search scripts/daangn_cars.py -- search --region "합정동" --price-max 10000000 --limit 5
+npx -y @nomadamas/k-skill@0 exec daangn-cars-search scripts/daangn_cars.py -- detail "https://www.daangn.com/kr/cars/.../"
 ```
 
 ## Output fields

package/skills/daangn-jobs-search/instruction.md

@@ -41,8 +41,8 @@
 ## Commands
 
 ```bash
-python3 daangn-jobs-search/scripts/daangn_jobs.py search "카페" --region "합정동" --limit 5
-python3 daangn-jobs-search/scripts/daangn_jobs.py detail "https://www.daangn.com/kr/jobs/.../"
+npx -y @nomadamas/k-skill@0 exec daangn-jobs-search scripts/daangn_jobs.py -- search "카페" --region "합정동" --limit 5
+npx -y @nomadamas/k-skill@0 exec daangn-jobs-search scripts/daangn_jobs.py -- detail "https://www.daangn.com/kr/jobs/.../"
 ```
 
 ## Output fields

package/skills/daangn-jobs-search/skill.json

@@ -3,7 +3,9 @@
   "description": "당근알바 공개 웹 데이터로 공고를 검색하고, 돌쇠에서는 공식 계정 표면에서 지원서 작성·채팅·승인 기반 전송까지 진행한다.",
   "profiles": [
     "proxy",
-    "action:communication"
+    "vault",
+    "browser",
+    "action:submission"
   ],
   "frontmatter": "name: daangn-jobs-search\ndescription: 당근알바 공개 웹 데이터로 공고를 검색하고, 돌쇠에서는 공식 계정 표면에서 지원서 작성·채팅·승인 기반 전송까지 진행한다.\nlicense: MIT\nmetadata:\n  category: jobs\n  locale: ko-KR\n  phase: v1"
 }

package/skills/daangn-realty-search/instruction.md

@@ -63,7 +63,7 @@ ArticleFeedConnection.edges → ArticleFeedEdge.node → ArticleFeedCard.article
 
 ```bash
 # 기본 검색 (상위 5개 제목·층수 보강)
-python3 daangn-realty-search/scripts/daangn_realty.py search --region "매교동" --limit 20
+npx -y @nomadamas/k-skill@0 exec daangn-realty-search scripts/daangn_realty.py -- search --region "매교동" --limit 20
 
 # 거래/용도 필터
 python3 ... search --region "매교동" --trade-type BUY            # 매매만

package/skills/daangn-used-goods-search/instruction.md

@@ -41,8 +41,8 @@
 ## Commands
 
 ```bash
-python3 daangn-used-goods-search/scripts/daangn_used_goods.py search "맥북" --region "합정동" --limit 5
-python3 daangn-used-goods-search/scripts/daangn_used_goods.py detail "https://www.daangn.com/kr/buy-sell/.../"
+npx -y @nomadamas/k-skill@0 exec daangn-used-goods-search scripts/daangn_used_goods.py -- search "맥북" --region "합정동" --limit 5
+npx -y @nomadamas/k-skill@0 exec daangn-used-goods-search scripts/daangn_used_goods.py -- detail "https://www.daangn.com/kr/buy-sell/.../"
 ```
 
 ## Output fields

package/skills/daishin-report-search/skill.json

@@ -3,7 +3,6 @@
   "description": "대신증권 리포트 GitHub Pages 미러에서 최신 HTML 리포트 목록과 원문/설명 페이지를 조회한다.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: daishin-report-search\ndescription: 대신증권 리포트 GitHub Pages 미러에서 최신 HTML 리포트 목록과 원문/설명 페이지를 조회한다.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"

package/skills/danawa-price-search/instruction.md

@@ -46,9 +46,9 @@ AJAX endpoint는 HTML fragment를 반환한다. helper는 `.diff_item`, 쇼핑
 스킬 디렉터리에서 실행한다.
 
 ```bash
-python scripts/danawa_search.py search "에어팟 프로 2세대" --limit 8
-python scripts/danawa_search.py offers 28208783 --limit 10
-python scripts/danawa_search.py compare "에어팟 프로 2세대" --limit 5 --offers 5
+npx -y @nomadamas/k-skill@0 exec danawa-price-search scripts/danawa_search.py -- search "에어팟 프로 2세대" --limit 8
+npx -y @nomadamas/k-skill@0 exec danawa-price-search scripts/danawa_search.py -- offers 28208783 --limit 10
+npx -y @nomadamas/k-skill@0 exec danawa-price-search scripts/danawa_search.py -- compare "에어팟 프로 2세대" --limit 5 --offers 5
 ```
 
 helper는 JSON만 출력한다. 결과를 확인한 뒤 사용자에게는 한국어 표와 짧은 결론으로 정리한다.
@@ -157,7 +157,7 @@ Discord/Telegram/chat 응답에서는 표 형식을 우선한다.
 ## Workflow
 
 1. 검색어를 확인한다.
-2. `python scripts/danawa_search.py search "<검색어>" --limit 5`로 후보를 확인한다.
+2. `npx -y @nomadamas/k-skill@0 exec danawa-price-search scripts/danawa_search.py -- search "<검색어>" --limit 5`로 후보를 확인한다.
 3. 후보가 명확하면 해당 `pcode`로 `offers`를 실행한다.
 4. 후보가 애매하면 상위 3~5개 상품명/가격/`pcode`를 보여주고 선택을 요청한다.
 5. 오퍼는 **`total_price` 오름차순 단일 기준으로 정렬한다 (결제조건 분리 그룹화하지 않음).** 결제조건은 표의 "결제조건" 컬럼과 row 단위 플래그로만 표기하고, 1위가 현금/쿠폰가여도 그대로 1위로 노출한다.

package/skills/ev-charger-nearby/instruction.md

@@ -19,9 +19,9 @@
 설치된 skill 디렉터리에서 실행한다.
 
 ```bash
-python3 scripts/ev_charger.py info --location '서울 강남구' --num-of-rows 10
-python3 scripts/ev_charger.py status --stat-id ME000001 --num-of-rows 10
-python3 scripts/ev_charger.py status --zcode 11 --limit-yn Y --period 10 --json
+npx -y @nomadamas/k-skill@0 exec ev-charger-nearby scripts/ev_charger.py -- info --location '서울 강남구' --num-of-rows 10
+npx -y @nomadamas/k-skill@0 exec ev-charger-nearby scripts/ev_charger.py -- status --stat-id ME000001 --num-of-rows 10
+npx -y @nomadamas/k-skill@0 exec ev-charger-nearby scripts/ev_charger.py -- status --zcode 11 --limit-yn Y --period 10 --json
 ```
 
 공통 필터는 `zcode`, `zscode`, `statId`, `chgerId`다. hosted proxy의 `info`는 고유하게 식별되는 `location`을 행정구역 코드로 변환하며, 모호하거나 찾을 수 없는 위치와 충돌하는 명시적 코드는 거부한다. `status`는 `limitYn`과 `period`를 추가로 허용한다. 페이지 기본값은 `pageNo=1`, `numOfRows=10`이며 `numOfRows` 범위는 10~9999다.
@@ -29,8 +29,8 @@ python3 scripts/ev_charger.py status --zcode 11 --limit-yn Y --period 10 --json
 직접 호출:
 
 ```bash
-python3 scripts/ev_charger.py info --zcode 11 --zscode 11680 --direct
-python3 scripts/ev_charger.py status --stat-id ME000001 --direct --dry-run
+npx -y @nomadamas/k-skill@0 exec ev-charger-nearby scripts/ev_charger.py -- info --zcode 11 --zscode 11680 --direct
+npx -y @nomadamas/k-skill@0 exec ev-charger-nearby scripts/ev_charger.py -- status --stat-id ME000001 --direct --dry-run
 ```
 
 직접 호출은 위치 텍스트를 행정구역 코드로 변환하지 않으므로 `--location` 대신 `--zcode`/`--zscode`를 사용한다. `--dry-run`은 URL을 보여주되 키를 `REDACTED`로 가린다.

package/skills/ev-charger-nearby/skill.json

@@ -3,8 +3,7 @@
   "description": "Use when the user asks for Korean EV charging-station locations, charger types, or current charger status by region, station, or location text. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
     "proxy",
-    "vault",
-    "action:booking"
+    "lookup"
   ],
   "frontmatter": "name: ev-charger-nearby\ndescription: Use when the user asks for Korean EV charging-station locations, charger types, or current charger status by region, station, or location text. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: transit\n  locale: ko-KR\n  phase: v1"
 }

package/skills/express-bus-booking/instruction.md

@@ -28,7 +28,7 @@ Do **not** use this for:
 
 ## Known HTTP Flow
 
-See `references/kobus-http-flow.md` for session-proven endpoint details and parameter examples.
+See `npx -y @nomadamas/k-skill@0 read express-bus-booking references/kobus-http-flow.md` for session-proven endpoint details and parameter examples.
 
 ### 1. Start a Session
 
@@ -126,7 +126,7 @@ Use the same relevant form fields plus the returned `pcpyNoAll` and `satsNoAll`.
 Use the bundled helper for KOBUS lookup and optional temporary holds:
 
 ```bash
-python3 express-bus-booking/scripts/kobus_express_booking.py \
+npx -y @nomadamas/k-skill@0 exec express-bus-booking scripts/kobus_express_booking.py -- \
   --depart-code 021 \
   --arrive-code 500 \
   --date 20260520 \

package/skills/express-bus-booking/skill.json

@@ -2,6 +2,8 @@
   "name": "express-bus-booking",
   "description": "Search and assist Korean 고속버스/KOBUS bookings using official HTTP/API-first flows; use for 고속버스 예매, 시간표, 좌석 조회, 임시 선점, and official checkout-entry handoff. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
+    "vault",
+    "browser",
     "action:booking"
   ],
   "frontmatter": "name: express-bus-booking\ndescription: Search and assist Korean 고속버스/KOBUS bookings using official HTTP/API-first flows; use for 고속버스 예매, 시간표, 좌석 조회, 임시 선점, and official checkout-entry handoff. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: travel\n  locale: ko-KR\n  phase: v1"

package/skills/flight-ticket-search/instruction.md

@@ -57,7 +57,7 @@
 이 skill은 저장소 내 helper를 직접 실행한다.
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py --help
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- --help
 ```
 
 최초 실행 시 `~/.cache/k-skill/flight-ticket-search/venv`에 `fast-flights==2.2`를 설치하고 그 venv로 재실행한다. 저장소에는 의존성 vendoring이나 API key를 넣지 않는다.
@@ -67,7 +67,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py --help
 편도:
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py search \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- search \
   --from ICN \
   --to NRT \
   --date 2026-06-01 \
@@ -80,7 +80,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py search \
 왕복:
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py search \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- search \
   --from ICN \
   --to NRT \
   --date 2026-06-01 \
@@ -105,7 +105,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py search \
 빠른 기본값은 주 1회 샘플링이다.
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py compare-month \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- compare-month \
   --from ICN \
   --to NRT \
   --month 2026-06 \
@@ -116,7 +116,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py compare-month \
 일별 전체 조회가 필요하면 `--sample daily`를 쓴다. 다만 28~31회 요청이 발생하므로 rate limit을 위해 `--sleep`을 1.5초 이상 유지한다.
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py compare-month \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- compare-month \
   --from ICN \
   --to NRT \
   --month 2026-06 \
@@ -138,7 +138,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py compare-month \
 사용자가 "다음주부터 2주간", "6월 1일부터 20일까지"처럼 범위를 주면 날짜 범위 비교를 사용한다.
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py compare-range \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- compare-range \
   --from ICN \
   --to BKK \
   --start-date 2026-06-01 \
@@ -154,7 +154,7 @@ python3 flight-ticket-search/scripts/flight_ticket_search.py compare-range \
 연도 비교는 같은 월일을 여러 연도에 대해 조회한다.
 
 ```bash
-python3 flight-ticket-search/scripts/flight_ticket_search.py compare-years \
+npx -y @nomadamas/k-skill@0 exec flight-ticket-search scripts/flight_ticket_search.py -- compare-years \
   --from ICN \
   --to NRT \
   --years 2026,2027 \

package/skills/foresttrip-vacancy/instruction.md

@@ -28,7 +28,7 @@ generic runtime에서 helper는 조회 전용이다. 돌쇠에서는 조회 결
 ```bash
 python3 -m pip install playwright
 python3 -m playwright install chromium
-python3 scripts/run_foresttrip_vacancy.py --check-deps
+npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --check-deps
 ```
 
 ## Required environment variables
@@ -91,25 +91,25 @@ API는 `srchDate` 단일 일자만 요청해도 응답에 5일 윈도우를 포
 전체 자연휴양림에서 특정 날짜 조회:
 
 ```bash
-python3 scripts/run_foresttrip_vacancy.py --all --text --dates 20260504
+npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --all --text --dates 20260504
 ```
 
 JSON 출력:
 
 ```bash
-python3 scripts/run_foresttrip_vacancy.py --all --json --dates 20260504
+npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --all --json --dates 20260504
 ```
 
 캠핑/야영만 조회:
 
 ```bash
-python3 scripts/run_foresttrip_vacancy.py --all --text --dates 20260504 --categories 02
+npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --all --text --dates 20260504 --categories 02
 ```
 
 특정 휴양림명으로 조회:
 
 ```bash
-python3 scripts/run_foresttrip_vacancy.py --forest-name 유명산 --text --dates 20260504
+npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --forest-name 유명산 --text --dates 20260504
 ```
 
 ### 4. Summarize results conservatively
@@ -154,8 +154,8 @@ python3 scripts/run_foresttrip_vacancy.py --forest-name 유명산 --text --dates
 
 - `./scripts/validate-skills.sh`
 - `python3 -m py_compile foresttrip-vacancy/scripts/run_foresttrip_vacancy.py`
-- `python3 foresttrip-vacancy/scripts/run_foresttrip_vacancy.py --help`
-- `python3 foresttrip-vacancy/scripts/run_foresttrip_vacancy.py --check-deps`
+- `npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --help`
+- `npx -y @nomadamas/k-skill@0 exec foresttrip-vacancy scripts/run_foresttrip_vacancy.py -- --check-deps`
 - `npm run ci`
 
 실제 live smoke는 기여자 또는 이미 숲나들e 계정을 가진 사용자가 선택적으로 수행한다. PR에는 `forests_scanned`, `fetch_failures`, `filter_hits` 같은 비민감 요약만 남기고 계정 정보, 세션 쿠키, 개인 조회 세부 내역은 공유하지 않는다.