@nomadamas/k-skill 0.1.0 → 0.2.1

package/skills/fsc-corporate-info/skill.json

@@ -3,7 +3,6 @@
   "description": "금융위원회 기업기본정보(법인 개요)를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 법인명으로 대표자·설립일·업종 등 법인 개요를 확인하고, 응답에 사업자번호가 있으면 입력 번호와 교차검증한다.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: fsc-corporate-info\ndescription: 금융위원회 기업기본정보(법인 개요)를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 법인명으로 대표자·설립일·업종 등 법인 개요를 확인하고, 응답에 사업자번호가 있으면 입력 번호와 교차검증한다.\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1"

package/skills/g2b-order-plan-search/instruction.md

@@ -68,7 +68,7 @@ CLI flags:
 ### 1. Search order plans
 
 ```bash
-python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
+npx -y @nomadamas/k-skill@0 exec g2b-order-plan-search scripts/g2b_order_plan.py -- \
   --kind service \
   --keyword 청소 \
   --order-from 2025-01 \
@@ -81,7 +81,7 @@ python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
 ### 2. Narrow by institution or location
 
 ```bash
-python3 g2b-order-plan-search/scripts/g2b_order_plan.py \
+npx -y @nomadamas/k-skill@0 exec g2b-order-plan-search scripts/g2b_order_plan.py -- \
   --kind goods \
   --institution 조달청 \
   --region 대전 \

package/skills/g2b-order-plan-search/skill.json

@@ -4,7 +4,8 @@
   "profiles": [
     "proxy",
     "vault",
-    "hard-boundary"
+    "browser",
+    "legal"
   ],
   "frontmatter": "name: g2b-order-plan-search\ndescription: 조달청 나라장터 발주계획현황서비스로 물품·공사·용역·외자 발주계획 목록을 검색한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1"
 }

package/skills/g2b-sanctioned-supplier/instruction.md

@@ -43,7 +43,7 @@ upstream 명세상 다음은 **제공되지 않는다** — 과거 이력 조회
 ## CLI examples
 
 ```bash
-python3 g2b-sanctioned-supplier/scripts/g2b_sanctioned_supplier.py --bizno 124-81-00998
+npx -y @nomadamas/k-skill@0 exec g2b-sanctioned-supplier scripts/g2b_sanctioned_supplier.py -- --bizno 124-81-00998
 ```
 
 ## Failure modes

package/skills/g2b-sanctioned-supplier/skill.json

@@ -3,7 +3,6 @@
   "description": "조달청 나라장터 부정당제재업체정보를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업자등록번호 정확 일치로 조회시점 현재 유효한 입찰참가자격 제한(부정당제재)의 기간·제재기관·근거법률을 확인한다.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: g2b-sanctioned-supplier\ndescription: 조달청 나라장터 부정당제재업체정보를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업자등록번호 정확 일치로 조회시점 현재 유효한 입찰참가자격 제한(부정당제재)의 기간·제재기관·근거법률을 확인한다.\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1"

package/skills/geeknews-search/instruction.md

@@ -31,13 +31,13 @@ GeekNews 공개 RSS/Atom 피드(`https://feeds.feedburner.com/geeknews-feed`)를
 ### 1) List recent entries
 
 ```bash
-python3 scripts/geeknews_search.py list --limit 10
+npx -y @nomadamas/k-skill@0 exec geeknews-search scripts/geeknews_search.py -- list --limit 10
 ```
 
 ### 2) Search the feed conservatively
 
 ```bash
-python3 scripts/geeknews_search.py search --query Claude --limit 5
+npx -y @nomadamas/k-skill@0 exec geeknews-search scripts/geeknews_search.py -- search --query Claude --limit 5
 ```
 
 검색은 제목, 요약, 작성자, 링크/id 기준으로만 동작한다.
@@ -45,7 +45,7 @@ python3 scripts/geeknews_search.py search --query Claude --limit 5
 ### 3) Inspect a specific item
 
 ```bash
-python3 scripts/geeknews_search.py detail --id 28439
+npx -y @nomadamas/k-skill@0 exec geeknews-search scripts/geeknews_search.py -- detail --id 28439
 ```
 
 상세 조회는 RSS 피드에 포함된 `content`/요약과 원문 링크를 함께 돌려준다.

package/skills/gov-overseas-trip-report/instruction.md

@@ -36,18 +36,18 @@
 우선 저장소 helper를 사용한다.
 
 ```bash
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py providers
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider nec --max-pages 5
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider acrc --max-pages 2
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider open_portal --keyword 국외출장
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider daegu_council
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider daejeon_council
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider gyeonggi_council
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py list --provider gyeongbuk_council --keyword 국외출장
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py detail --provider nec --id 303199
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py search --keyword 몰디브 --providers nec,acrc,open_portal,daejeon_council
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py discover --keyword 국외출장
-python3 gov-overseas-trip-report/scripts/gov_overseas_trip_report.py discover --keyword 공무국외출장 --urls https://www.ptcouncil.go.kr/,https://council.chungnam.go.kr/
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- providers
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider nec --max-pages 5
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider acrc --max-pages 2
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider open_portal --keyword 국외출장
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider daegu_council
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider daejeon_council
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider gyeonggi_council
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- list --provider gyeongbuk_council --keyword 국외출장
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- detail --provider nec --id 303199
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- search --keyword 몰디브 --providers nec,acrc,open_portal,daejeon_council
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- discover --keyword 국외출장
+npx -y @nomadamas/k-skill@0 exec gov-overseas-trip-report scripts/gov_overseas_trip_report.py -- discover --keyword 공무국외출장 --urls https://www.ptcouncil.go.kr/,https://council.chungnam.go.kr/
 ```
 
 ## Official access path

package/skills/han-river-water-level/skill.json

@@ -3,7 +3,6 @@
   "description": "한강홍수통제소 기반 현재 수위/유량을 관측소명 또는 관측소코드로 조회한다. 기본 경로는 k-skill-proxy의 han-river water-level endpoint다.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: han-river-water-level\ndescription: 한강홍수통제소 기반 현재 수위/유량을 관측소명 또는 관측소코드로 조회한다. 기본 경로는 k-skill-proxy의 han-river water-level endpoint다.\nlicense: MIT\nmetadata:\n  category: utility\n  locale: ko-KR\n  phase: v1"

package/skills/highway-traffic-status/instruction.md

@@ -37,7 +37,7 @@
 ### 1. 실시간 소통/교통량 조회
 
 ```bash
-python3 highway-traffic-status/scripts/highway_traffic.py traffic --route 경부 --text
+npx -y @nomadamas/k-skill@0 exec highway-traffic-status scripts/highway_traffic.py -- traffic --route 경부 --text
 ```
 
 - `--route`: 노선명 일부(`경부`, `서해안`) 또는 노선번호(`0010`)
@@ -52,7 +52,7 @@ JSON 출력 필드: `route_name`, `route_no`, `conzone_name`, `direction`(상행
 좌표 범위(경도 `--min-x`/`--max-x`, 위도 `--min-y`/`--max-y`)가 필수다. 사용자가 지명을 말하면 대략적인 bounding box로 변환해 호출한다.
 
 ```bash
-python3 highway-traffic-status/scripts/highway_traffic.py cctv \
+npx -y @nomadamas/k-skill@0 exec highway-traffic-status scripts/highway_traffic.py -- cctv \
   --min-x 126.9 --max-x 127.2 --min-y 37.3 --max-y 37.6 --text
 ```
 

package/skills/highway-traffic-status/skill.json

@@ -3,7 +3,6 @@
   "description": "한국도로공사·국가교통정보센터 공개 API로 고속도로 실시간 소통(구간별 속도/교통량/정체 등급)과 CCTV 스트림 메타데이터를 조회한다. Use when the user asks 고속도로 정체, 교통 상황, 노선/구간 소통, 고속도로 CCTV. Not for 대중교통 길찾기 or 자동차 경로 안내.",
   "profiles": [
     "proxy",
-    "vault",
     "browser",
     "lookup"
   ],

package/skills/household-waste-info/skill.json

@@ -3,7 +3,6 @@
   "description": "Use when the user asks for 생활쓰레기 배출 요일/시간/장소 정보 by 지역명(시군구) and wants official data.go.kr household waste guidance.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: household-waste-info\ndescription: Use when the user asks for 생활쓰레기 배출 요일/시간/장소 정보 by 지역명(시군구) and wants official data.go.kr household waste guidance.\nlicense: MIT\nmetadata:\n  category: utility\n  locale: ko-KR\n  phase: v1"

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

@@ -28,7 +28,7 @@ Do **not** use this for:
 
 ## Known HTTP Flow
 
-See `references/tmoney-intercity-http-flow.md` for session-proven endpoint details and parameter examples.
+See `npx -y @nomadamas/k-skill@0 read intercity-bus-booking references/tmoney-intercity-http-flow.md` for session-proven endpoint details and parameter examples.
 
 ### 1. Start a Session
 
@@ -110,7 +110,7 @@ A successful response lands on the official `카드정보 입력` page and inclu
 For read-only timetable lookup, use the bundled helper before attempting browser automation:
 
 ```bash
-python3 intercity-bus-booking/scripts/intercity_bus_search.py \
+npx -y @nomadamas/k-skill@0 exec intercity-bus-booking scripts/intercity_bus_search.py -- \
   --depart-code 0511601 \
   --arrive-code 2482701 \
   --depart-name 동서울 \
@@ -125,7 +125,7 @@ The helper starts a cookie-backed session, posts the browser-required timetable
 To create a temporary hold and save the official card-information page:
 
 ```bash
-python3 intercity-bus-booking/scripts/intercity_bus_search.py \
+npx -y @nomadamas/k-skill@0 exec intercity-bus-booking scripts/intercity_bus_search.py -- \
   --depart-code 0511601 \
   --arrive-code 2482701 \
   --depart-name 동서울 \

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

@@ -2,6 +2,8 @@
   "name": "intercity-bus-booking",
   "description": "Search and assist Korean 시외버스/Tmoney bookings using official HTTP/API-first flows; use for 시외버스 예매, 시간표, 좌석/요금 조회, and official checkout-entry handoff. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
+    "vault",
+    "browser",
     "action:booking"
   ],
   "frontmatter": "name: intercity-bus-booking\ndescription: Search and assist Korean 시외버스/Tmoney 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/iros-registry-automation/instruction.md

@@ -182,12 +182,12 @@ python iros_wizard.py
 ```bash
 # 텍스트 레이어가 있는 일반 등기 PDF (기본) — pypdf 또는 pdfplumber 필요
 pip install pypdf   # 또는 pip install pdfplumber (표 추출에 유리)
-python iros-registry-automation/scripts/iros_pdf_summary.py \
+npx -y @nomadamas/k-skill@0 exec iros-registry-automation scripts/iros_pdf_summary.py -- \
   "$workdir/downloads/등기.pdf" --out "$workdir/output"
 
 # 스캔(이미지) PDF인 경우: 사용자가 로컬에 self-host한 변환기(예: marker)로 먼저
 # 텍스트/마크다운으로 바꾼 뒤 그 결과를 요약한다 (원격 전송 없이 로컬 파일만).
-python iros-registry-automation/scripts/iros_pdf_summary.py 변환결과.md --from-text --out "$workdir/output"
+npx -y @nomadamas/k-skill@0 exec iros-registry-automation scripts/iros_pdf_summary.py -- 변환결과.md --from-text --out "$workdir/output"
 ```
 
 출력(모두 사실 나열, 판단 없음): 등기 종류(부동산/법인), 열람·발급 일시, 소유권 변동 건수, 근저당권 목록(채권최고액·설정일·말소여부), 가압류/가처분/압류 건수. 추출 텍스트 구조에 따라 부정확할 수 있으니 **원문 대조를 권한다.**

package/skills/iros-registry-automation/skill.json

@@ -2,8 +2,9 @@
   "name": "iros-registry-automation",
   "description": "인터넷등기소(IROS)에서 법인/부동산 등기부등본(등기사항증명서) 발급을 준비하고, 사용자가 직접 로그인·결제한 브라우저 흐름 안에서 장바구니·열람·저장을 안전하게 보조한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
   "profiles": [
+    "vault",
     "browser",
-    "hard-boundary"
+    "legal"
   ],
   "frontmatter": "name: iros-registry-automation\ndescription: 인터넷등기소(IROS)에서 법인/부동산 등기부등본(등기사항증명서) 발급을 준비하고, 사용자가 직접 로그인·결제한 브라우저 흐름 안에서 장바구니·열람·저장을 안전하게 보조한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: legal-documents\n  locale: ko-KR\n  phase: v1"
 }

package/skills/job-posting-match/instruction.md

@@ -69,13 +69,13 @@ Do not block on missing fields when a reasonable first search is possible. If th
 3. Run both public sources by default:
 
 ```bash
-python3 job-posting-match/scripts/job_posting_match.py   --resume-text "퍼포먼스 마케터 5년. GA4, Google Ads, Meta Ads, SQL, 커머스 경험. 서울 희망."   --location 서울   --negative 보험영업   --limit 10
+npx -y @nomadamas/k-skill@0 exec job-posting-match scripts/job_posting_match.py --   --resume-text "퍼포먼스 마케터 5년. GA4, Google Ads, Meta Ads, SQL, 커머스 경험. 서울 희망."   --location 서울   --negative 보험영업   --limit 10
 ```
 
 Use explicit keywords when the user already knows target roles:
 
 ```bash
-python3 job-posting-match/scripts/job_posting_match.py   --resume-file /path/to/resume.txt   --keyword "CRM 마케터 Braze"   --keyword "그로스 마케터 SQL"   --location 서울   --json
+npx -y @nomadamas/k-skill@0 exec job-posting-match scripts/job_posting_match.py --   --resume-file /path/to/resume.txt   --keyword "CRM 마케터 Braze"   --keyword "그로스 마케터 SQL"   --location 서울   --json
 ```
 
 4. Score postings conservatively.

package/skills/job-posting-match/skill.json

@@ -2,7 +2,7 @@
   "name": "job-posting-match",
   "description": "한국 구직자의 이력서·경력요약과 희망조건을 바탕으로 잡코리아·사람인 공개 채용공고를 검색하고 적합도와 지원 전략을 정리합니다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
-    "action:communication"
+    "lookup"
   ],
   "frontmatter": "name: job-posting-match\ndescription: 한국 구직자의 이력서·경력요약과 희망조건을 바탕으로 잡코리아·사람인 공개 채용공고를 검색하고 적합도와 지원 전략을 정리합니다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: recruiting\n  locale: ko-KR\n  phase: v1"
 }

package/skills/jobkorea-talent-search/instruction.md

@@ -73,7 +73,7 @@ If detail pages are inaccessible or paid-walled, label results as `목록 기반
 Use only when the user cannot or will not log in. It is low-confidence because it cannot inspect resume details.
 
 ```bash
-python3 jobkorea-talent-search/scripts/jobkorea_talent_search.py   --keyword "퍼포먼스 마케터 GA4"   --work-area "서울"   --career-min 3   --career-max 7   --limit 20
+npx -y @nomadamas/k-skill@0 exec jobkorea-talent-search scripts/jobkorea_talent_search.py --   --keyword "퍼포먼스 마케터 GA4"   --work-area "서울"   --career-min 3   --career-max 7   --limit 20
 ```
 
 ## URL extraction guidance

package/skills/jobkorea-talent-search/skill.json

@@ -2,8 +2,9 @@
   "name": "jobkorea-talent-search",
   "description": "잡코리아 기업회원 로그인 세션으로 유료 열람 전 마스킹된 인재 이력서를 검색·비교해 채용 검토용 shortlist를 만듭니다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
+    "vault",
     "browser",
-    "action:communication"
+    "action:recruiting"
   ],
   "frontmatter": "name: jobkorea-talent-search\ndescription: 잡코리아 기업회원 로그인 세션으로 유료 열람 전 마스킹된 인재 이력서를 검색·비교해 채용 검토용 shortlist를 만듭니다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: recruiting\n  locale: ko-KR\n  phase: v1"
 }

package/skills/joseon-sillok-search/instruction.md

@@ -24,7 +24,7 @@ v1 범위는 단순 스크래핑이다.
 - 인터넷 연결
 - `python3`
 - 별도 API 키 없음
-- 설치된 skill payload 안에 `scripts/sillok_search.py` helper가 함께 들어 있다.
+- `@nomadamas/k-skill` CLI에 `scripts/sillok_search.py` helper가 함께 번들되어 있다.
 
 ## Inputs
 
@@ -38,7 +38,7 @@ v1 범위는 단순 스크래핑이다.
 
 ## Workflow
 
-1. `python3 scripts/sillok_search.py --query "..."` 로 공식 검색 endpoint를 호출한다.
+1. `npx -y @nomadamas/k-skill@0 exec joseon-sillok-search scripts/sillok_search.py -- --query "..."` 로 공식 검색 endpoint를 호출한다.
 2. 검색 결과 HTML에서 결과 수, 왕별 분류, 기사 링크, 요약을 파싱한다.
 3. 필요하면 `--king`, `--year` 로 결과를 추가로 좁힌다.
 4. 선택된 기사마다 `/id/<article_id>` 상세 페이지를 열어 국역/원문 excerpt를 가져온다.
@@ -47,10 +47,10 @@ v1 범위는 단순 스크래핑이다.
 ## CLI examples
 
 ```bash
-python3 scripts/sillok_search.py --query "훈민정음"
-python3 scripts/sillok_search.py --query "훈민정음" --king "세종" --year 1443 --limit 3
-python3 scripts/sillok_search.py --query "측우기" --king "세종실록" --limit 5
-python3 scripts/sillok_search.py --query "임진왜란" --type w --limit 5
+npx -y @nomadamas/k-skill@0 exec joseon-sillok-search scripts/sillok_search.py -- --query "훈민정음"
+npx -y @nomadamas/k-skill@0 exec joseon-sillok-search scripts/sillok_search.py -- --query "훈민정음" --king "세종" --year 1443 --limit 3
+npx -y @nomadamas/k-skill@0 exec joseon-sillok-search scripts/sillok_search.py -- --query "측우기" --king "세종실록" --limit 5
+npx -y @nomadamas/k-skill@0 exec joseon-sillok-search scripts/sillok_search.py -- --query "임진왜란" --type w --limit 5
 ```
 
 ## Response policy

package/skills/k-skill-cleaner/instruction.md

@@ -32,7 +32,7 @@ Ask a compact interview before scanning or recommending deletion:
 From an installed standalone skill, run the deterministic helper from the `k-skill-cleaner` skill directory. In a full repository checkout, the compatibility wrapper at `scripts/k_skill_cleaner.py` accepts the same options.
 
 ```bash
-python3 scripts/k_skill_cleaner.py \
+npx -y @nomadamas/k-skill@0 exec k-skill-cleaner scripts/k_skill_cleaner.py -- \
   --skills-root . \
   --scan-default-logs \
   --days 90 \
@@ -43,7 +43,7 @@ python3 scripts/k_skill_cleaner.py \
 For agent exports or hand-curated counts, pass a JSON object mapping skill name to trigger count:
 
 ```bash
-python3 scripts/k_skill_cleaner.py --skills-root . --usage-json usage-counts.json --days 90
+npx -y @nomadamas/k-skill@0 exec k-skill-cleaner scripts/k_skill_cleaner.py -- --skills-root . --usage-json usage-counts.json --days 90
 ```
 
 `--days` and `--since` filter scanned log records only. `--usage-json` values are already-aggregated counts, so prepare/export that JSON for the same time window before passing it to the helper.

package/skills/k-skill-setup/instruction.md

@@ -167,7 +167,7 @@ else
 fi
 ```
 
-repo 전체를 clone받은 경우에는 같은 검증을 `bash scripts/check-setup.sh` 로 실행해도 된다.
+repo 전체를 clone받은 경우에는 같은 검증을 `npx -y @nomadamas/k-skill@0 exec k-skill-setup scripts/check-setup.sh --` 로 실행해도 된다.
 
 ### 3. Offer scheduled update checks
 

package/skills/k-skill-setup/scripts/check-setup.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+secrets_file="${1:-$HOME/.config/k-skill/secrets.env}"
+
+missing=0
+
+if [[ ! -f "$secrets_file" ]]; then
+  echo "missing secrets file: $secrets_file"
+  missing=1
+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)"
+    missing=1
+  fi
+fi
+
+if [[ "$missing" -ne 0 ]]; then
+  cat <<EOF
+next steps:
+  1. create ~/.config/k-skill/secrets.env with your credentials
+  2. chmod 0600 ~/.config/k-skill/secrets.env
+  3. run this check again
+EOF
+  exit 1
+fi
+
+echo "k-skill setup looks usable"

package/skills/k-skill-setup/skill.json

@@ -5,7 +5,13 @@
     "proxy",
     "vault",
     "browser",
-    "local"
+    "operations"
   ],
-  "frontmatter": "name: k-skill-setup\ndescription: 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.\nlicense: MIT\nmetadata:\n  category: setup\n  locale: ko-KR\n  phase: v1"
+  "frontmatter": "name: k-skill-setup\ndescription: 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.\nlicense: MIT\nmetadata:\n  category: setup\n  locale: ko-KR\n  phase: v1",
+  "bundle": [
+    {
+      "from": "scripts/check-setup.sh",
+      "to": "scripts/check-setup.sh"
+    }
+  ]
 }

package/skills/kakaotalk-mac/skill.json

@@ -2,7 +2,7 @@
   "name": "kakaotalk-mac",
   "description": "Search local KakaoTalk archives on Apple Silicon macOS through the katok CLI. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
   "profiles": [
-    "action:communication"
+    "lookup"
   ],
   "frontmatter": "name: kakaotalk-mac\ndescription: Search local KakaoTalk archives on Apple Silicon macOS through the katok CLI. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: messaging\n  locale: ko-KR\n  phase: v2"
 }

package/skills/keris-academic-search/instruction.md

@@ -26,9 +26,9 @@ RISS 검색 Open API 키는 **공익 목적의 비영리 기관/대학에만**
 ## Commands
 
 ```bash
-python3 scripts/keris_academic.py search --keyword '인공지능 교육'
-python3 scripts/keris_academic.py search --title '대학도서관' --author '김연구' --resource-type T
-python3 scripts/keris_academic.py search --keyword '한국어 교육' --resource-type D --page 2 --page-size 20 --json
+npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --keyword '인공지능 교육'
+npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --title '대학도서관' --author '김연구' --resource-type T
+npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --keyword '한국어 교육' --resource-type D --page 2 --page-size 20 --json
 ```
 
 검색 필드는 `keyword`, `title`, `author`, `subject`, `publisher`이며 하나 이상 필요하다. `page`는 1 이상, `pageSize`는 1~100이다. RISS의 `rsnum`은 `(page-1)*pageSize+1`로 계산한다. 실제 호출에는 사용자 RISS 키가 필요하다.
@@ -48,7 +48,7 @@ python3 scripts/keris_academic.py search --keyword '한국어 교육' --resource
 ## Credentials
 
 ```bash
-python3 scripts/keris_academic.py search --keyword '교육 데이터' --resource-type ALL --dry-run
+npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --keyword '교육 데이터' --resource-type ALL --dry-run
 ```
 
 - RISS 키: `KSKILL_RISS_API_KEY`, 없으면 compatibility `RISS_API_KEY`, 이후 `~/.config/k-skill/secrets.env`

package/skills/korea-weather/skill.json

@@ -3,7 +3,6 @@
   "description": "한국 날씨를 기상청 단기예보 조회서비스와 프록시 경유로 조회해 요약한다.",
   "profiles": [
     "proxy",
-    "vault",
     "lookup"
   ],
   "frontmatter": "name: korea-weather\ndescription: 한국 날씨를 기상청 단기예보 조회서비스와 프록시 경유로 조회해 요약한다.\nlicense: MIT\nmetadata:\n  category: weather\n  locale: ko-KR\n  phase: v1"

package/skills/korean-character-count/instruction.md

@@ -46,24 +46,24 @@
 ## Prerequisites
 
 - `node` 18+
-- 설치된 skill payload 안에 `scripts/korean_character_count.js` helper 포함
+- `@nomadamas/k-skill` CLI에 번들된 `scripts/korean_character_count.js` helper
 - 별도 API 키 없음
 
 ## Workflow
 
 1. 텍스트를 직접 받거나 파일/STDIN으로 읽는다.
-2. `node scripts/korean_character_count.js` 로 결정론적 카운트를 실행한다.
+2. `npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js --` 로 결정론적 카운트를 실행한다.
 3. 필요한 프로필(`default`/`neis`)과 출력 형식(`json`/`text`)을 고른다.
 4. 결과를 그대로 반환하고, 어떤 계약으로 셌는지 함께 알려준다.
 
 ## CLI examples
 
 ```bash
-node scripts/korean_character_count.js --text "가나다"
-node scripts/korean_character_count.js --text $'첫 줄\r\n둘째 줄🙂'
-node scripts/korean_character_count.js --text $'첫 줄\n둘째 줄🙂' --profile neis --format text
-node scripts/korean_character_count.js --file ./essay.txt --profile default
-cat essay.txt | node scripts/korean_character_count.js --stdin --profile neis
+npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --text "가나다"
+npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --text $'첫 줄\r\n둘째 줄🙂'
+npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --text $'첫 줄\n둘째 줄🙂' --profile neis --format text
+npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --file ./essay.txt --profile default
+cat essay.txt | npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --stdin --profile neis
 ```
 
 ## Response policy
@@ -77,7 +77,7 @@ cat essay.txt | node scripts/korean_character_count.js --stdin --profile neis
 
 - 글자 수, 줄 수, byte 수가 함께 반환된다.
 - `default` 와 `neis` 계약 차이가 문서에 명시된다.
-- `node scripts/korean_character_count.js --help` 가 동작한다.
+- `npx -y @nomadamas/k-skill@0 exec korean-character-count scripts/korean_character_count.js -- --help` 가 동작한다.
 - 혼합 한국어/영문/공백/개행/emoji 입력에 대한 테스트가 있다.
 
 ## Notes

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

@@ -28,7 +28,7 @@ v1은 공식 XML API를 직접 호출하며, 별도 API key·로그인·프록
 
 - 인터넷 연결
 - Python 3.10+
-- 설치된 skill payload 안에 `scripts/korean_heritage_search.py` helper가 포함되어 있다.
+- `@nomadamas/k-skill` CLI에 `scripts/korean_heritage_search.py` helper가 번들되어 있다.
 - 별도 API key나 로그인은 필요 없다.
 
 ## Inputs
@@ -68,10 +68,10 @@ v1은 공식 XML API를 직접 호출하며, 별도 API key·로그인·프록
 ## CLI examples
 
 ```bash
-python3 scripts/korean_heritage_search.py search --query "경복궁" --region 서울 --limit 5
-python3 scripts/korean_heritage_search.py search --region 전북 --limit 10
-python3 scripts/korean_heritage_search.py detail --ccba-kdcd 11 --ccba-asno 0000010000000 --ccba-ctcd 11
-python3 scripts/korean_heritage_search.py events --year 2026 --month 7 --region 서울 --limit 10
+npx -y @nomadamas/k-skill@0 exec korean-heritage-search scripts/korean_heritage_search.py -- search --query "경복궁" --region 서울 --limit 5
+npx -y @nomadamas/k-skill@0 exec korean-heritage-search scripts/korean_heritage_search.py -- search --region 전북 --limit 10
+npx -y @nomadamas/k-skill@0 exec korean-heritage-search scripts/korean_heritage_search.py -- detail --ccba-kdcd 11 --ccba-asno 0000010000000 --ccba-ctcd 11
+npx -y @nomadamas/k-skill@0 exec korean-heritage-search scripts/korean_heritage_search.py -- events --year 2026 --month 7 --region 서울 --limit 10
 ```
 
 ## Response policy

package/skills/korean-humanizer/instruction.md

@@ -95,7 +95,7 @@ AI 패턴을 지우는 건 절반이다. 영혼 없는 글은 슬롭(slop)만큼
 
 # 패턴 카탈로그 (A ~ J)
 
-각 패턴은 `분류 ID · 심각도`로 표시한다. 전체 60+ 서브 패턴 표는 [`references/ai-tell-taxonomy.md`](references/ai-tell-taxonomy.md)에 있다. 아래는 한국어 AI 글에서 가장 자주, 가장 강하게 드러나는 핵심만 추렸다.
+각 패턴은 `분류 ID · 심각도`로 표시한다. 전체 60+ 서브 패턴 표는 `npx -y @nomadamas/k-skill@0 read korean-humanizer references/ai-tell-taxonomy.md`에 있다. 아래는 한국어 AI 글에서 가장 자주, 가장 강하게 드러나는 핵심만 추렸다.
 
 ## A. 번역체 (한국어 AI 글의 1순위 정체)
 

package/skills/korean-jangbu-for/instruction.md

@@ -41,7 +41,7 @@
 홈 디렉터리 wrapper 에는 `SKILL.md`, `scripts/install.sh`, `scripts/upstream.pin`, `LICENSE.upstream`, `DISCLAIMER.md`, `NOTICE` 를 함께 설치한다. Promoted `jangbu-*` top-level 경로에 사용자가 만든 다른 스킬이 이미 있으면 installer 는 덮어쓰지 않고 중단한다. wrapper 가 이전에 설치한 managed 스킬만 자동 갱신하며, 의도적으로 교체해야 할 때만 `KOREAN_JANGBU_FOR_OVERWRITE_SKILLS=1` 을 설정한다.
 
 ```bash
-bash korean-jangbu-for/scripts/install.sh
+npx -y @nomadamas/k-skill@0 exec korean-jangbu-for scripts/install.sh --
 ```
 
 레포를 로컬에 clone 하지 않고 이미 홈 디렉토리 스킬 번들만 가진 상태에서도 설치할 수 있다:
@@ -55,7 +55,7 @@ bash ~/.agents/skills/korean-jangbu-for/scripts/install.sh
 설치 확인:
 
 ```bash
-cat korean-jangbu-for/scripts/upstream.pin
+npx -y @nomadamas/k-skill@0 read korean-jangbu-for scripts/upstream.pin
 git -C ~/.claude/skills/korean-jangbu-for/upstream rev-parse HEAD
 git -C ~/.agents/skills/korean-jangbu-for/upstream rev-parse HEAD
 ```
@@ -84,7 +84,7 @@ bash ~/.claude/skills/korean-jangbu-for/upstream/scripts/verify.sh
 ## Workflow
 
 1. 위 intake 로 목표와 입력 자료를 확정한다.
-2. `bash korean-jangbu-for/scripts/install.sh` 로 업스트림을 dual-install 한다.
+2. `npx -y @nomadamas/k-skill@0 exec korean-jangbu-for scripts/install.sh --` 로 업스트림을 dual-install 한다.
 3. 사용 목적에 맞게 업스트림 스킬을 선택한다:
    - `/korean-jangbu-for` — 전체 메뉴 라우팅
    - `/jangbu-connect` — CODEF API 자격증명 설정(BYOK, 홈택스·은행·카드 자동 수집)

package/skills/korean-middle-korean/instruction.md

@@ -36,7 +36,7 @@
 ## Workflow
 
 1. 변환할 한국어 텍스트를 받는다.
-2. 설치된 `korean-middle-korean` skill 디렉터리를 기준으로 `node scripts/korean_middle_korean.js` 를 실행한다.
+2. CLI에 번들된 `scripts/korean_middle_korean.js`를 `k-skill exec` 표면으로 실행한다.
    - URL, 이메일, Markdown 링크, inline/fenced code span은 보호되어 원문 그대로 복원된다.
 3. 기본 JSON 출력에서 `output`을 사용자에게 반환한다.
 4. 사용자가 근거를 원하면 `replacements` 배열의 규칙 적용 내역을 요약한다.
@@ -45,10 +45,10 @@
 ## CLI examples
 
 ```bash
-node scripts/korean_middle_korean.js --text "민수는 3월 5일 학교에서 공부했다."
-node scripts/korean_middle_korean.js --text "열애설을 인정했다." --format text
-cat input.txt | node scripts/korean_middle_korean.js --stdin --format json
-node scripts/korean_middle_korean.js --file ./input.txt --format text
+npx -y @nomadamas/k-skill@0 exec korean-middle-korean scripts/korean_middle_korean.js -- --text "민수는 3월 5일 학교에서 공부했다."
+npx -y @nomadamas/k-skill@0 exec korean-middle-korean scripts/korean_middle_korean.js -- --text "열애설을 인정했다." --format text
+cat input.txt | npx -y @nomadamas/k-skill@0 exec korean-middle-korean scripts/korean_middle_korean.js -- --stdin --format json
+npx -y @nomadamas/k-skill@0 exec korean-middle-korean scripts/korean_middle_korean.js -- --file ./input.txt --format text
 ```
 
 ## Response policy
@@ -73,7 +73,7 @@ node scripts/korean_middle_korean.js --file ./input.txt --format text
 
 ## Done when
 
-- `node scripts/korean_middle_korean.js --help` 가 동작한다.
+- `npx -y @nomadamas/k-skill@0 exec korean-middle-korean scripts/korean_middle_korean.js -- --help` 가 동작한다.
 - `--text`, `--file`, `--stdin` 입력이 모두 동작한다.
 - JSON과 text 출력이 모두 동작한다.
 - 이슈 #270의 예시처럼 날짜/Hanja/중세국어풍 조사·어미·성조점이 나타난다.