Merge pull request #42 from NomaDamas/feature/#41

Feature/#41
2026-06-24 02:04:11 +00:00 · 2026-04-01 10:08:09 +09:00 · 2026-04-01 10:08:09 +09:00 · 7cbe2b58ed
commit 7cbe2b58ed
parent 40224b8d03 a5c9232b3f
11 changed files with 368 additions and 3 deletions
--- a/README.md
+++ b/README.md
@ -23,6 +23,7 @@ Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 각종 코딩 에이전트
 | 카카오톡 Mac CLI | macOS에서 kakaocli로 대화 조회, 검색, 테스트 전송, 확인 후 실제 전송 | 불필요 | [카카오톡 Mac CLI 가이드](docs/features/kakaotalk-mac.md) |
 | 서울 지하철 도착정보 조회 | self-host 또는 배포 확인이 끝난 `k-skill-proxy` 경유로 역 기준 실시간 도착 예정 열차 확인 | 프록시 URL 필요 | [서울 지하철 도착정보 가이드](docs/features/seoul-subway-arrival.md) |
 | 사용자 위치 미세먼지 조회 | `k-skill-proxy` 로 현재 위치 또는 지역 fallback 기준 PM10/PM2.5 확인 | 불필요 | [사용자 위치 미세먼지 조회 가이드](docs/features/fine-dust-location.md) |
+| 한국 법령 검색 | `korean-law-mcp` 기반 법령/조문/판례/유권해석 조회 | 로컬 CLI/MCP면 `LAW_OC` 필요, remote endpoint면 불필요 | [한국 법령 검색 가이드](docs/features/korean-law-search.md) |
 | KBO 경기 결과 조회 | 날짜별 경기 일정, 결과, 팀별 필터링 | 불필요 | [KBO 결과 가이드](docs/features/kbo-results.md) |
 | K리그 경기 결과 조회 | 날짜별 K리그1/K리그2 경기 결과, 팀별 필터링, 현재 순위 확인 | 불필요 | [K리그 결과 가이드](docs/features/kleague-results.md) |
 | 토스증권 조회 | `tossctl` 기반 계좌 요약, 포트폴리오, 시세, 주문내역, 관심종목 조회 | 필요 | [토스증권 조회 가이드](docs/features/toss-securities.md) |
@ -63,6 +64,7 @@ Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 각종 코딩 에이전트
 - [카카오톡 Mac CLI](docs/features/kakaotalk-mac.md)
 - [서울 지하철 도착정보 조회](docs/features/seoul-subway-arrival.md)
 - [사용자 위치 미세먼지 조회](docs/features/fine-dust-location.md)
+- [한국 법령 검색 가이드](docs/features/korean-law-search.md)
 - [KBO 경기 결과 조회](docs/features/kbo-results.md)
 - [K리그 경기 결과 조회](docs/features/kleague-results.md)
 - [토스증권 조회 가이드](docs/features/toss-securities.md)
--- a/docs/features/korean-law-search.md
+++ b/docs/features/korean-law-search.md
@ -0,0 +1,98 @@
+# 한국 법령 검색 가이드
+
+## 이 기능으로 할 수 있는 일
+
+- `korean-law-mcp` 로 법령명 검색
+- 특정 법령의 조문 본문 조회
+- 판례 / 유권해석 / 자치법규 검색
+- MCP 또는 CLI 경로 중 현재 환경에 맞는 방식 선택
+
+## 가장 중요한 규칙
+
+한국 법령 관련 검색/조회가 필요할 때는 **반드시 `korean-law-mcp`를 사용**합니다.
+별도 repo package, 별도 python package, 임의 크롤러를 새로 만들지 않습니다.
+
+## 먼저 필요한 것
+
+- 인터넷 연결
+- `node` 18+
+- `npm install -g korean-law-mcp` (로컬 CLI/로컬 MCP server 경로일 때)
+- remote MCP endpoint를 쓸 MCP 클라이언트
+
+무료 API key 발급처: `https://open.law.go.kr`
+
+로컬 CLI 또는 로컬 MCP server 경로는 `LAW_OC` 가 필요하다.
+remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결한다.
+
+```bash
+npm install -g korean-law-mcp
+export LAW_OC=your-api-key
+
+korean-law list
+korean-law help search_law
+```
+
+로컬 설치가 막히면 `https://korean-law-mcp.fly.dev/mcp` remote endpoint를 사용해도 된다. 다만 이 경우에도 **`korean-law-mcp` 경로만** 사용한다.
+
+## MCP 연결 예시
+
+```json
+{
+  "mcpServers": {
+    "korean-law": {
+      "command": "korean-law-mcp",
+      "env": {
+        "LAW_OC": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+remote endpoint 예시:
+
+```json
+{
+  "mcpServers": {
+    "korean-law": {
+      "url": "https://korean-law-mcp.fly.dev/mcp"
+    }
+  }
+}
+```
+
+위 remote 예시는 upstream 문서 기준으로 사용자 `LAW_OC` 를 따로 넣지 않는다. 사용자 쪽에서 준비할 것은 `url` 등록뿐이다.
+
+## 기본 흐름
+
+1. 질의가 법령/판례/행정해석/자치법규 중 어디에 가까운지 분류한다.
+2. 법령명만 찾으면 `search_law` 를 먼저 쓴다.
+3. 특정 조문이 필요하면 `search_law` 또는 `search_all` 로 식별자(`mst`)를 확인한 뒤 `get_law_text` 를 호출한다.
+4. 판례는 `search_precedents`, 유권해석은 `search_interpretations`, 자치법규는 `search_ordinance` 를 우선 사용한다.
+5. 범주가 애매하면 `search_all` 로 시작한다.
+6. 한국 법령 검색은 항상 `korean-law-mcp` 로 끝까지 처리한다.
+
+## CLI 예시
+
+```bash
+korean-law search_law --query "관세법"
+korean-law get_law_text --mst 160001 --jo "제38조"
+korean-law search_precedents --query "부당해고"
+```
+
+## 운영 팁
+
+- `화관법` 같은 약칭은 `search_law` / `search_all` 로 정식 법령명을 먼저 확인한다.
+- 조문 번호가 헷갈리면 `get_law_text` 전에 법령 식별자부터 다시 확인한다.
+- 로컬 CLI/MCP 경로를 쓰는데 `LAW_OC` 가 없으면 credential resolution order에 따라 확보를 안내하고, 다른 검색 경로로 우회하지 않는다.
+- remote MCP endpoint를 쓰면 사용자 `LAW_OC` 없이 `url` 등록 상태만 확인한다.
+- 요약은 할 수 있지만 법률 자문처럼 단정적으로 결론을 내리지는 않는다.
+
+## 라이브 확인 메모
+
+2026-04-01 기준 smoke test 에서 아래 명령은 실제로 정상 동작했다.
+
+- `korean-law list`
+- `korean-law help search_law`
+
+즉, `korean-law-mcp` CLI 설치와 기본 명령 진입은 검증했다. 실제 법령 검색은 로컬 CLI/MCP 경로라면 `LAW_OC` 가 준비된 환경에서 바로 이어서 사용할 수 있고, remote MCP endpoint는 사용자 `LAW_OC` 없이 URL 등록만으로 붙일 수 있다.
--- a/docs/install.md
+++ b/docs/install.md
@ -50,6 +50,7 @@ npx --yes skills add <owner/repo> \
  --skill toss-securities \
  --skill lotto-results \
  --skill kakaotalk-mac \
+  --skill korean-law-search \
  --skill fine-dust-location \
  --skill daiso-product-search \
  --skill blue-ribbon-nearby \
@ -66,10 +67,24 @@ npx --yes skills add <owner/repo> \
  --skill k-skill-setup \
  --skill srt-booking \
  --skill ktx-booking \
+  --skill korean-law-search \
  --skill seoul-subway-arrival \
  --skill fine-dust-location
 ```

+`korean-law-search` 는 skill 설치 후 upstream CLI/MCP도 준비해야 한다.
+
+- 로컬 CLI/MCP 경로는 `LAW_OC` 를 채운다.
+- remote endpoint는 `LAW_OC` 없이 `url`만 등록한다.
+
+```bash
+npm install -g korean-law-mcp
+export LAW_OC=your-api-key
+korean-law list
+```
+
+로컬 설치가 막히면 `https://korean-law-mcp.fly.dev/mcp` remote endpoint를 MCP 클라이언트에 등록한다. 이 경우에도 한국 법령 조회는 `korean-law-mcp`만 사용한다.
+
 로컬 저장소에서 바로 전체 설치 테스트:

 ```bash
@ -104,7 +119,7 @@ npm run ci
 ### Node 패키지

 ```bash
-npm install -g @ohah/hwpjs kbo-game kleague-results toss-securities k-lotto coupang-product-search
+npm install -g @ohah/hwpjs kbo-game kleague-results toss-securities k-lotto coupang-product-search korean-law-mcp
 export NODE_PATH="$(npm root -g)"
 ```

@ -142,6 +157,7 @@ python3 -m pip install SRTrain korail2 pycryptodome
 - `ktx-booking`
 - `seoul-subway-arrival`
 - `fine-dust-location`
+- `korean-law-search`

 관련 문서:

--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@ -12,6 +12,7 @@
 - 로또 당첨번호
 - 서울 지하철 도착 정보
 - 사용자 위치 미세먼지 조회 스킬 출시
+- 한국 법령 검색 스킬 출시
 - 우편번호 검색
 - 근처 블루리본 맛집 스킬 출시
 - 근처 술집 조회 스킬 출시
--- a/docs/security-and-secrets.md
+++ b/docs/security-and-secrets.md
@ -24,6 +24,7 @@ KSKILL_SRT_ID=replace-me
 KSKILL_SRT_PASSWORD=replace-me
 KSKILL_KTX_ID=replace-me
 KSKILL_KTX_PASSWORD=replace-me
+LAW_OC=replace-me
 AIR_KOREA_OPEN_API_KEY=replace-me
 KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
 ```
@ -59,9 +60,10 @@ KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
 - `KSKILL_SRT_PASSWORD`
 - `KSKILL_KTX_ID`
 - `KSKILL_KTX_PASSWORD`
+- `LAW_OC`
 - `AIR_KOREA_OPEN_API_KEY`
 - `KSKILL_PROXY_BASE_URL`

-프록시 운영자 문맥에서는 upstream 환경변수 `SEOUL_OPEN_API_KEY` 도 사용할 수 있다. 다만 일반 사용자/client 쪽 기본 secrets 파일에는 넣지 않는다. `KSKILL_PROXY_BASE_URL` 도 서울 지하철 route가 실제 배포된 proxy URL 로만 넣는다.
+`LAW_OC` 는 `korean-law-mcp` 가 법제처 Open API 를 호출할 때 쓰는 표준 변수명이다. 이 값은 로컬 CLI/로컬 MCP server 경로에서만 사용자 쪽에 필요하고, upstream remote MCP endpoint 예시는 사용자 `LAW_OC` 없이 `url`만 등록한다. 프록시 운영자 문맥에서는 upstream 환경변수 `SEOUL_OPEN_API_KEY` 도 사용할 수 있다. 다만 일반 사용자/client 쪽 기본 secrets 파일에는 넣지 않는다. `KSKILL_PROXY_BASE_URL` 도 서울 지하철 route가 실제 배포된 proxy URL 로만 넣는다.

 이 레포의 credential-bearing skill은 전부 이 정책을 전제로 작성한다. 자세한 공통 설치 절차는 [공통 설정 가이드](setup.md)를 본다.
--- a/docs/setup.md
+++ b/docs/setup.md
@ -1,6 +1,6 @@
 # 공통 설정 가이드

-`k-skill` 전체 스킬을 설치한 뒤, 인증 정보가 필요한 기능(SRT 예매, KTX 예매, self-host 프록시 운영용 서울 지하철/미세먼지 upstream key, 또는 배포 확인이 끝난 proxy URL 공유)이 있으면 이 절차를 진행하면 된다.
+`k-skill` 전체 스킬을 설치한 뒤, 인증 정보가 필요한 기능(SRT 예매, KTX 예매, 한국 법령 검색의 로컬 CLI/MCP 경로용 `LAW_OC`, self-host 프록시 운영용 서울 지하철/미세먼지 upstream key, 또는 배포 확인이 끝난 proxy URL 공유)이 있으면 이 절차를 진행하면 된다.

 ## Credential resolution order

@ -24,6 +24,7 @@ KSKILL_SRT_ID=replace-me
 KSKILL_SRT_PASSWORD=replace-me
 KSKILL_KTX_ID=replace-me
 KSKILL_KTX_PASSWORD=replace-me
+LAW_OC=replace-me
 AIR_KOREA_OPEN_API_KEY=replace-me
 KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
 EOF
@ -34,6 +35,10 @@ chmod 0600 ~/.config/k-skill/secrets.env

 서울 지하철 도착정보는 hosted public route rollout 이 끝나기 전까지 `KSKILL_PROXY_BASE_URL` 을 self-host 또는 배포 확인이 끝난 proxy URL 로 채워야 한다. 미세먼지만 쓴다면 이 값을 비워 두고 skill 기본 hosted path를 그대로 써도 된다.

+한국 법령 검색의 로컬 CLI/MCP 경로용 `LAW_OC` 는 `korean-law-mcp` 로컬 실행에 쓴다. 로컬 CLI/MCP 경로는 `LAW_OC` 를 채운 뒤 `npm install -g korean-law-mcp` 와 `korean-law list` 로 설치 상태를 확인한다.
+
+remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결한다. 이 경우에도 다른 구현으로 우회하지 않고 `korean-law-mcp` endpoint만 사용한다.
+
 ## 확인

 ```bash
@ -53,6 +58,8 @@ bash scripts/check-setup.sh
 | --- | --- |
 | SRT 예매 | `KSKILL_SRT_ID`, `KSKILL_SRT_PASSWORD` |
 | KTX 예매 | `KSKILL_KTX_ID`, `KSKILL_KTX_PASSWORD` |
+| 한국 법령 검색 (로컬 CLI/MCP) | `LAW_OC` |
+| 한국 법령 검색 (remote MCP endpoint) | 사용자 시크릿 불필요 (`url`만 등록) |
 | 서울 지하철 도착정보 조회 | self-host 또는 배포 확인이 끝난 `KSKILL_PROXY_BASE_URL` |
 | 사용자 위치 미세먼지 조회 | `KSKILL_PROXY_BASE_URL` 또는 `AIR_KOREA_OPEN_API_KEY` |

@ -62,6 +69,7 @@ bash scripts/check-setup.sh
 - [KTX 예매 가이드](features/ktx-booking.md)
 - [서울 지하철 도착정보 가이드](features/seoul-subway-arrival.md)
 - [사용자 위치 미세먼지 조회 가이드](features/fine-dust-location.md)
+- [한국 법령 검색 가이드](features/korean-law-search.md)
 - [보안/시크릿 정책](security-and-secrets.md)

 설치 기본 흐름은 "전체 스킬 설치 → 개별 기능 사용" 이다.
--- a/docs/sources.md
+++ b/docs/sources.md
@ -12,6 +12,7 @@
 - K League 팀 순위 JSON: https://www.kleague.com/record/teamRank.do
 - `@ohah/hwpjs`: https://github.com/ohah/hwpjs
 - `hwp-mcp`: https://github.com/jkf87/hwp-mcp
+- korean-law-mcp: https://github.com/chrisryugj/korean-law-mcp
 - `silver-flight-group/kakaocli`: https://github.com/silver-flight-group/kakaocli
 - KakaoTalk Mac 설치 참고(`mas`): https://velog.io/@bonjugi/%EB%A7%A5%EB%B6%81-M1%EC%97%90-homebrew%EB%A1%9C-node-vscode-%EC%B9%B4%EC%B9%B4%EC%98%A4%ED%86%A1-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0
 - 동행복권 로또 결과 페이지: https://www.dhlottery.co.kr/lt645/result
--- a/examples/secrets.env.example
+++ b/examples/secrets.env.example
@ -2,5 +2,6 @@ KSKILL_SRT_ID=replace-me
 KSKILL_SRT_PASSWORD=replace-me
 KSKILL_KTX_ID=replace-me
 KSKILL_KTX_PASSWORD=replace-me
+LAW_OC=replace-me
 AIR_KOREA_OPEN_API_KEY=replace-me
 KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
--- a/k-skill-setup/SKILL.md
+++ b/k-skill-setup/SKILL.md
@ -67,6 +67,7 @@ KSKILL_SRT_ID=replace-me
 KSKILL_SRT_PASSWORD=replace-me
 KSKILL_KTX_ID=replace-me
 KSKILL_KTX_PASSWORD=replace-me
+LAW_OC=replace-me
 AIR_KOREA_OPEN_API_KEY=replace-me
 KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
 EOF
@ -77,6 +78,8 @@ chmod 0600 ~/.config/k-skill/secrets.env

 서울 지하철 도착정보는 hosted public route rollout 이 끝나기 전까지 `KSKILL_PROXY_BASE_URL` 을 self-host 또는 배포 확인이 끝난 proxy URL 로 채운다. 미세먼지만 hosted proxy 로 쓸 때는 이 값을 비워 둘 수 있다.

+한국 법령 검색은 로컬 `korean-law-mcp` 경로를 쓸 때만 `LAW_OC` 를 채운다. remote endpoint는 사용자 `LAW_OC` 없이 `url`만 등록하면 된다.
+
 ### Missing secret response template

 인증 스킬에서 값이 빠졌을 때는 credential resolution order에 따라 확보한다.
@ -85,6 +88,8 @@ chmod 0600 ~/.config/k-skill/secrets.env

 - SRT: `KSKILL_SRT_ID`, `KSKILL_SRT_PASSWORD`
 - KTX: `KSKILL_KTX_ID`, `KSKILL_KTX_PASSWORD`
+- 로컬 한국 법령 검색: `LAW_OC` + `korean-law-mcp`
+- 한국 법령 검색 remote endpoint: 사용자 `LAW_OC` 없이 `url`만 등록
 - 서울 지하철: self-host 또는 배포 확인이 끝난 `KSKILL_PROXY_BASE_URL`
 - 사용자 위치 미세먼지 조회: `KSKILL_PROXY_BASE_URL` 또는 `AIR_KOREA_OPEN_API_KEY`

--- a/korean-law-search/SKILL.md
+++ b/korean-law-search/SKILL.md
@ -0,0 +1,146 @@
+---
+name: korean-law-search
+description: Use korean-law-mcp for Korean law, precedent, ordinance, and interpretation lookups. Always use korean-law-mcp when the user needs Korean legal search or retrieval.
+license: MIT
+metadata:
+  category: legal
+  locale: ko-KR
+  phase: v1
+---
+
+# Korean Law Search
+
+## What this skill does
+
+한국 법령/조문/판례/유권해석/자치법규 조회가 필요할 때 **반드시 `korean-law-mcp`를 사용**한다.
+
+- 법령명 검색: `search_law`
+- 조문 본문 조회: `get_law_text`
+- 판례 검색: `search_precedents`
+- 유권해석 검색: `search_interpretations`
+- 자치법규 검색: `search_ordinance`
+- 여러 카테고리가 섞인 검색: `search_all`
+
+이 스킬은 자체 npm/python 패키지를 만들지 않는다. 한국 법령 관련 조회는 로컬 설치든 remote endpoint든 **항상 `korean-law-mcp` 경로로만 처리**한다.
+
+## When to use
+
+- "산업안전보건법 찾아줘"
+- "관세법 제38조 보여줘"
+- "부당해고 판례 찾아줘"
+- "개인정보보호법 시행령 조문 확인해줘"
+- "한국 법령/판례/자치법규 검색해줘"
+
+## When not to use
+
+- 미국/일본/EU 등 비한국 법령 검색
+- 실제 법률 자문·소송 전략을 단정적으로 제공해야 하는 경우
+- 법령 원문이 아니라 일반 상식 설명만 필요한 경우
+
+## Prerequisites
+
+- 인터넷 연결
+- `node` 18+
+- `npm install -g korean-law-mcp` (로컬 CLI/로컬 MCP server 경로일 때)
+- MCP 클라이언트에 remote endpoint를 등록할 수 있는 환경
+
+무료 API key: `https://open.law.go.kr`
+
+로컬 CLI 또는 로컬 MCP server 경로는 `LAW_OC` 가 필요하다.
+remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결한다.
+
+```bash
+npm install -g korean-law-mcp
+export LAW_OC=your-api-key
+
+korean-law list
+korean-law help search_law
+```
+
+로컬 설치가 운영체제 정책이나 권한 때문에 막히면, 대체 구현을 만들지 말고 `korean-law-mcp` 의 remote MCP endpoint(`https://korean-law-mcp.fly.dev/mcp`)를 사용한다. 이 경우에도 **반드시 `korean-law-mcp`를 사용한 것**으로 취급한다.
+
+## MCP client setup
+
+Claude Desktop / Cursor / Windsurf 같은 MCP 클라이언트에는 아래처럼 연결한다.
+
+```json
+{
+  "mcpServers": {
+    "korean-law": {
+      "command": "korean-law-mcp",
+      "env": {
+        "LAW_OC": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+설치가 막힌 환경에서는 remote endpoint를 사용한다. 이 upstream 예시는 사용자 `LAW_OC` 없이 `url`만 등록한다.
+
+```json
+{
+  "mcpServers": {
+    "korean-law": {
+      "url": "https://korean-law-mcp.fly.dev/mcp"
+    }
+  }
+}
+```
+
+## CLI workflow
+
+### 1. 법령명부터 찾기
+
+```bash
+korean-law search_law --query "관세법"
+```
+
+### 2. 특정 조문 본문 조회
+
+```bash
+korean-law get_law_text --mst 160001 --jo "제38조"
+```
+
+### 3. 판례 검색
+
+```bash
+korean-law search_precedents --query "부당해고"
+```
+
+### 4. 자치법규 검색
+
+```bash
+korean-law search_ordinance --query "서울특별시 청년 기본 조례"
+```
+
+### 5. 애매하면 통합 검색
+
+```bash
+korean-law search_all --query "개인정보 처리방침 행정해석"
+```
+
+## Response policy
+
+- 한국 법령 관련 요청은 **항상 `korean-law-mcp`를 먼저 사용**한다.
+- 약칭(`화관법`)이면 `search_law` / `search_all` 로 정식 법령명을 먼저 확인한다.
+- 조문 요청이면 검색 결과의 식별자(`mst`)를 확인한 뒤 `get_law_text` 로 본문을 가져온다.
+- 판례는 `search_precedents`, 유권해석은 `search_interpretations`, 자치법규는 `search_ordinance` 를 우선 사용한다.
+- 로컬 CLI/MCP 경로를 쓰는데 `LAW_OC` 가 없으면 credential resolution order에 따라 확보 방법을 짧게 안내하고, 임의의 크롤링/검색엔진 우회로 넘어가지 않는다.
+- remote MCP endpoint를 쓰면 사용자 `LAW_OC` 없이 `url` 등록 상태만 확인한다.
+- 법적 판단이 필요한 경우 `검색 결과 요약`과 `원문 출처`까지만 제공하고 법률 자문처럼 단정하지 않는다.
+
+## Done when
+
+- 한국 법령 관련 질의에 대해 `korean-law-mcp` 사용 경로가 선택되었다.
+- 필요한 검색/조회 명령이 정해졌다.
+- 법령/조문/판례/유권해석/자치법규 중 맞는 도구로 결과를 조회했다.
+- 유권해석이면 `search_interpretations`, 자치법규면 `search_ordinance` 까지 명시적으로 연결했다.
+- 로컬 경로라면 `LAW_OC` 확보 방법을 정확한 변수 이름으로 안내했다.
+- remote endpoint라면 사용자 `LAW_OC` 없이 `url` 등록 상태를 확인했다.
+
+## Notes
+
+- upstream: `https://github.com/chrisryugj/korean-law-mcp`
+- official data source: 법제처 Open API (`https://open.law.go.kr`)
+- 이 저장소 안에는 한국 법령 전용 npm package나 python package를 추가하지 않는다.
--- a/scripts/skill-docs.test.js
+++ b/scripts/skill-docs.test.js
@ -998,3 +998,88 @@ test("package-lock captures the toss-securities workspace metadata for npm ci",
  assert.equal(packageLock.packages["packages/toss-securities"].license, "MIT");
  assert.equal(packageLock.packages["packages/toss-securities"].engines.node, ">=18");
 });
+
+test("repository docs advertise the korean-law-search skill with mode-specific korean-law-mcp setup guidance", () => {
+  const readme = read("README.md");
+  const install = read(path.join("docs", "install.md"));
+  const setup = read(path.join("docs", "setup.md"));
+  const security = read(path.join("docs", "security-and-secrets.md"));
+  const sources = read(path.join("docs", "sources.md"));
+  const roadmap = read(path.join("docs", "roadmap.md"));
+  const setupSkill = read(path.join("k-skill-setup", "SKILL.md"));
+  const featureDoc = read(path.join("docs", "features", "korean-law-search.md"));
+  const featureDocPath = path.join(repoRoot, "docs", "features", "korean-law-search.md");
+
+  assert.ok(fs.existsSync(featureDocPath), "expected docs/features/korean-law-search.md to exist");
+  assert.match(readme, /\| 한국 법령 검색 \|/);
+  assert.match(readme, /\[한국 법령 검색 가이드\]\(docs\/features\/korean-law-search\.md\)/);
+  assert.match(readme, /로컬 CLI\/MCP면 `LAW_OC` 필요, remote endpoint면 불필요/);
+  assert.match(install, /--skill korean-law-search/);
+  assert.match(install, /로컬 CLI\/MCP 경로는 `LAW_OC`/);
+  assert.match(install, /remote endpoint는 `LAW_OC` 없이 `url`만/);
+  assert.match(setup, /한국 법령 검색의 로컬 CLI\/MCP 경로용 `LAW_OC`/);
+  assert.match(setup, /remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결/);
+  assert.match(featureDoc, /로컬 CLI 또는 로컬 MCP server 경로는 `LAW_OC`/);
+  assert.match(featureDoc, /remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결/);
+  assert.match(setupSkill, /로컬 한국 법령 검색: `LAW_OC` \+ `korean-law-mcp`/);
+  assert.match(setupSkill, /remote endpoint: 사용자 `LAW_OC` 없이 `url`만 등록/);
+
+  for (const doc of [setup, security, setupSkill]) {
+    assert.match(doc, /LAW_OC/);
+    assert.match(doc, /korean-law-mcp/);
+  }
+
+  assert.match(sources, /korean-law-mcp: https:\/\/github\.com\/chrisryugj\/korean-law-mcp/);
+  assert.match(roadmap, /한국 법령 검색 스킬 출시/);
+});
+
+test("korean-law-search skill keeps korean-law-mcp-only lookups while separating local LAW_OC setup from remote MCP fallback", () => {
+  const skillPath = path.join(repoRoot, "korean-law-search", "SKILL.md");
+  const featureDoc = read(path.join("docs", "features", "korean-law-search.md"));
+  const examplesSecrets = read(path.join("examples", "secrets.env.example"));
+  const packageJson = readJson("package.json");
+
+  assert.ok(fs.existsSync(skillPath), "expected korean-law-search/SKILL.md to exist");
+
+  const skill = read(path.join("korean-law-search", "SKILL.md"));
+  const doneSectionMatch = skill.match(/## Done when([\s\S]*?)## Notes/);
+
+  assert.match(skill, /^name: korean-law-search$/m);
+  assert.ok(doneSectionMatch, "expected korean-law-search skill to include a Done when section");
+
+  const doneSection = doneSectionMatch[1];
+
+  for (const doc of [skill, featureDoc]) {
+    assert.match(doc, /반드시 .*korean-law-mcp|korean-law-mcp.*반드시/u);
+    assert.match(doc, /npm install -g korean-law-mcp/);
+    assert.match(doc, /로컬 CLI 또는 로컬 MCP server 경로는 `LAW_OC`/);
+    assert.match(doc, /remote MCP endpoint는 사용자 `LAW_OC` 없이 `url`만으로 연결/);
+    assert.match(doc, /open\.law\.go\.kr/);
+    assert.match(doc, /search_law/);
+    assert.match(doc, /get_law_text/);
+    assert.match(doc, /search_precedents/);
+    assert.match(doc, /search_interpretations/);
+    assert.match(doc, /search_ordinance/);
+    assert.match(doc, /https:\/\/korean-law-mcp\.fly\.dev\/mcp/);
+    assert.match(doc, /MCP/i);
+    assert.match(doc, /CLI/i);
+    assert.doesNotMatch(doc, /packages\/korean-law-search/);
+    assert.doesNotMatch(doc, /python-packages\/korean-law-search/);
+  }
+
+  assert.match(doneSection, /search_interpretations/);
+  assert.match(doneSection, /search_ordinance/);
+
+  assert.doesNotMatch(
+    featureDoc,
+    /[ \t]+$/m,
+    "expected docs/features/korean-law-search.md to avoid trailing whitespace so git diff --check stays clean",
+  );
+
+  assert.match(examplesSecrets, /^LAW_OC=replace-me$/m);
+  assert.ok(
+    !packageJson.workspaces.some((workspace) => workspace.includes("korean-law")),
+    "expected no repo workspace to be added for korean-law-search",
+  );
+  assert.equal(fs.existsSync(path.join(repoRoot, "packages", "korean-law-search")), false);
+});