영화관 검색 스킬 추가 (#260)

* Add korean cinema search skill * Document playDate for cinema skill
2026-06-24 02:04:11 +00:00 · 2026-05-18 11:42:40 +09:00 · 2026-05-18 11:42:40 +09:00 · e5b4465630
commit e5b4465630
parent 0721252fb6
7 changed files with 395 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -84,6 +84,7 @@ Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 각종 코딩 에이전트
 | 강남언니 병원 조회 | `gangnamunni-clinic-search` | 강남언니 공개 검색 페이지에서 성형외과·피부과 병원 후보, 평점, 리뷰 수, 지원 언어, 공개 링크 조회 | 불필요 | [강남언니 병원 조회 가이드](docs/features/gangnamunni-clinic-search.md) |
 | 마켓컬리 상품 조회 | `market-kurly-search` | 마켓컬리 상품 검색, 현재 가격, 할인 여부, 품절 여부 조회 | 불필요 | [마켓컬리 상품 조회 가이드](docs/features/market-kurly-search.md) |
 | 올리브영 검색 | `olive-young-search` | 올리브영 매장·상품·재고 조회 | 불필요 | [올리브영 검색 가이드](docs/features/olive-young-search.md) |
+| 영화관 검색 | `korean-cinema-search` | CGV·메가박스·롯데시네마 영화관, 상영작, 시간표, 잔여석 조회 | 불필요 | [영화관 검색 가이드](docs/features/korean-cinema-search.md) |
 | 올라포케 역삼 포케 | `hola-poke-yeoksam` | 올라포케 역삼점 메뉴, 매장 정보, 이벤트 참여 흐름 안내 | 불필요 | [올라포케 역삼 포케 가이드](docs/features/hola-poke-yeoksam.md) |
 | 마이리얼트립 MCP 검색 | `myrealtrip-search` | 공식 MCP 서버로 항공권, 숙소, 투어·티켓·액티비티 검색과 상세·옵션 확인 | 불필요 | [마이리얼트립 MCP 검색 가이드](docs/features/myrealtrip-search.md) |
 | 항공권 가격 조회 | `flight-ticket-search` | `fast-flights` 기반 Google Flights 공개 검색으로 항공권 후보, 예약 검색 링크, 날짜/월/연도별 최저가·평균가 비교 (조회 전용, 예매·결제 없음) | 불필요 | [항공권 가격 조회 가이드](docs/features/flight-ticket-search.md) |
@ -197,6 +198,7 @@ Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 각종 코딩 에이전트
 - [강남언니 병원 조회 가이드](docs/features/gangnamunni-clinic-search.md)
 - [마켓컬리 상품 조회 가이드](docs/features/market-kurly-search.md)
 - [올리브영 검색 가이드](docs/features/olive-young-search.md)
+- [영화관 검색 가이드](docs/features/korean-cinema-search.md)
 - [올라포케 역삼 포케 가이드](docs/features/hola-poke-yeoksam.md)
 - [마이리얼트립 MCP 검색 가이드](docs/features/myrealtrip-search.md)
 - [항공권 가격 조회 가이드](docs/features/flight-ticket-search.md)
--- a/docs/features/korean-cinema-search.md
+++ b/docs/features/korean-cinema-search.md
@ -0,0 +1,95 @@
+# 영화관 검색 가이드
+
+원본 [`hmmhmmhm/daiso-mcp`](https://github.com/hmmhmmhm/daiso-mcp) 와 npm package [`daiso`](https://www.npmjs.com/package/daiso) 를 사용해 CGV, 메가박스, 롯데시네마의 영화관 검색, 상영작, 시간표, 잔여석 조회를 한다.
+
+## 가장 중요한 규칙
+
+`k-skill` 안에 별도 영화관 수집기를 추가하지 않는다.
+
+기본 경로는 **MCP 서버를 직접 설치하지 않고 CLI로 먼저 확인하는 방식**이다.
+
+1. `npx --yes daiso ...`
+2. 필요하면 `git clone https://github.com/hmmhmmhm/daiso-mcp.git && cd daiso-mcp && npm install && npm run build`
+3. clone fallback에서는 `node dist/bin.js ...`
+
+## 빠른 확인
+
+날짜가 있는 요청은 Asia/Seoul 기준 `YYYYMMDD` 로 정규화하고 `--playDate <YYYYMMDD>` 를 항상 붙인다. 예를 들어 오늘을 물으면 KST 오늘 날짜를 계산해서 넣는다.
+
+```bash
+npx --yes daiso health
+npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json
+npx --yes daiso get /api/cgv/movies --keyword 강남 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/megabox/theaters --keyword 코엑스 --limit 5 --json
+npx --yes daiso get /api/megabox/movies --keyword 코엑스 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+npx --yes daiso get /api/lottecinema/theaters --keyword 월드타워 --limit 5 --json
+npx --yes daiso get /api/lottecinema/movies --keyword 월드타워 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+## 원본 저장소 clone fallback
+
+```bash
+git clone https://github.com/hmmhmmhm/daiso-mcp.git
+cd daiso-mcp
+npm install
+npm run build
+node dist/bin.js health
+node dist/bin.js get /api/cgv/theaters --keyword 강남 --limit 5 --json
+node dist/bin.js get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+node dist/bin.js get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+node dist/bin.js get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+## 입력값
+
+- 체인: CGV, 메가박스, 롯데시네마
+- 지역 또는 지점: 강남, 코엑스, 월드타워 등
+- 영화명: 잔여석이나 시간표를 특정 영화로 좁힐 때 사용
+- 날짜: 사용자가 날짜를 말하면 그 날짜를 우선하고, 없으면 Asia/Seoul 기준 오늘을 `YYYYMMDD` 로 계산한다.
+
+| 체인 | 후보 조회 | 상영작 | 시간표 또는 잔여석 | 날짜 |
+| --- | --- | --- | --- | --- |
+| CGV | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+| 메가박스 | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+| 롯데시네마 | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+
+## 사용 흐름
+
+1. `npx --yes daiso health` 로 endpoint 상태를 확인한다.
+2. `/api/cgv/theaters`, `/api/megabox/theaters`, `/api/lottecinema/theaters` 로 영화관 후보를 찾는다.
+3. 날짜 표현은 Asia/Seoul 기준 `YYYYMMDD` 로 바꾼다.
+4. `/api/cgv/movies`, `/api/megabox/movies`, `/api/lottecinema/movies` 로 상영작을 확인한다.
+5. CGV는 `/api/cgv/timetable` 로 시간표를 본다.
+6. 메가박스와 롯데시네마는 `/api/megabox/seats`, `/api/lottecinema/seats` 로 잔여석을 본다.
+7. 예매와 결제는 자동화하지 않는다.
+
+## 응답 원칙
+
+- 기준 체인과 지점을 먼저 쓴다.
+- 상영작과 시간표는 필요한 만큼만 보여준다.
+- 잔여석은 조회 시점의 참고값으로 말한다.
+- 영화관 공식 앱이나 웹에서 예매 직전 다시 확인하라고 안내한다.
+
+## 실패 모드
+
+- public endpoint가 일시적으로 5xx를 줄 수 있다.
+- 넓은 지역 키워드는 여러 지점을 섞을 수 있다.
+- 시간표와 잔여석은 빠르게 바뀔 수 있다.
+- theaterId, movieId가 있으면 keyword보다 그 값을 우선한다.
+
+## 출처
+
+- 원본 repo: `https://github.com/hmmhmmhm/daiso-mcp`
+- npm package: `https://www.npmjs.com/package/daiso`
+- CGV theaters API: `https://mcp.aka.page/api/cgv/theaters`
+- CGV movies API: `https://mcp.aka.page/api/cgv/movies`
+- CGV timetable API: `https://mcp.aka.page/api/cgv/timetable`
+- Megabox theaters API: `https://mcp.aka.page/api/megabox/theaters`
+- Megabox movies API: `https://mcp.aka.page/api/megabox/movies`
+- Megabox seats API: `https://mcp.aka.page/api/megabox/seats`
+- Lotte Cinema theaters API: `https://mcp.aka.page/api/lottecinema/theaters`
+- Lotte Cinema movies API: `https://mcp.aka.page/api/lottecinema/movies`
+- Lotte Cinema seats API: `https://mcp.aka.page/api/lottecinema/seats`
--- a/docs/install.md
+++ b/docs/install.md
@ -84,6 +84,7 @@ npx --yes skills add <owner/repo> \
  --skill market-kurly-search \
  --skill gangnamunni-clinic-search \
  --skill olive-young-search \
+  --skill korean-cinema-search \
  --skill hola-poke-yeoksam \
  --skill blue-ribbon-nearby \
  --skill kakao-bar-nearby \
@ -205,6 +206,40 @@ node dist/bin.js get /api/oliveyoung/products --keyword 선크림 --size 5 --jso
 node dist/bin.js get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json
 ```

+### `korean-cinema-search` upstream CLI quickstart
+
+`korean-cinema-search` 는 upstream 원본 [`hmmhmmhm/daiso-mcp`](https://github.com/hmmhmmhm/daiso-mcp) / npm package [`daiso`](https://www.npmjs.com/package/daiso) 를 그대로 사용한다.
+
+- 기본 경로는 **MCP 서버 직접 설치가 아니라 CLI first** 다.
+- 가장 빠른 smoke test 는 `npx --yes daiso health`
+- CGV, 메가박스, 롯데시네마의 영화관, 상영작, 시간표, 잔여석 조회를 다룬다.
+- 날짜가 있는 요청은 Asia/Seoul 기준 `YYYYMMDD` 로 바꿔 `--playDate <YYYYMMDD>` 를 명시한다.
+- 예매와 결제는 자동화하지 않는다.
+- 반복 사용이면 `npm install -g daiso`
+- public endpoint는 upstream 상태에 따라 간헐적인 `5xx/503` 이 날 수 있으니 먼저 한두 번 재시도한다.
+- 재시도 후에도 불안정하거나 버전 고정/원본 확인이 필요하면 `git clone https://github.com/hmmhmmhm/daiso-mcp.git && cd daiso-mcp && npm install && npm run build` clone fallback으로 전환한 뒤 `node dist/bin.js ...` 로 실행한다.
+
+```bash
+npx --yes daiso health
+npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json
+npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/megabox/theaters --keyword 코엑스 --limit 5 --json
+npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+npx --yes daiso get /api/lottecinema/theaters --keyword 월드타워 --limit 5 --json
+npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+clone fallback 예시:
+
+```bash
+git clone https://github.com/hmmhmmhm/daiso-mcp.git
+cd daiso-mcp
+npm install
+npm run build
+node dist/bin.js health
+node dist/bin.js get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+```
+
 ### `bunjang-search` upstream CLI quickstart

 `bunjang-search` 는 upstream 원본 [`pinion05/bunjangcli`](https://github.com/pinion05/bunjangcli) / npm package [`bunjang-cli`](https://www.npmjs.com/package/bunjang-cli) 를 그대로 사용한다.
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@ -38,6 +38,7 @@
 - 다이소 상품 조회 스킬 출시
 - 마켓컬리 상품 조회 스킬 출시
 - 올리브영 검색 스킬 출시
+- 영화관 검색 스킬 출시
 - 올라포케 역삼 포케 스킬 출시
 - 쿠팡 상품 검색 스킬 출시 (retention-corp/coupang_partners 로컬 MCP 호환 레이어 기반)
 - 번개장터 검색 스킬 출시
--- a/docs/sources.md
+++ b/docs/sources.md
@ -125,6 +125,17 @@
 - olive-young products API: https://mcp.aka.page/api/oliveyoung/products
 - olive-young inventory API: https://mcp.aka.page/api/oliveyoung/inventory
 - daiso/olive-young public MCP endpoint: https://mcp.aka.page/mcp
+- korean-cinema upstream repo (`hmmhmmhm/daiso-mcp`): https://github.com/hmmhmmhm/daiso-mcp
+- korean-cinema CLI package (`daiso`): https://www.npmjs.com/package/daiso
+- CGV theaters API: https://mcp.aka.page/api/cgv/theaters
+- CGV movies API: https://mcp.aka.page/api/cgv/movies
+- CGV timetable API: https://mcp.aka.page/api/cgv/timetable
+- Megabox theaters API: https://mcp.aka.page/api/megabox/theaters
+- Megabox movies API: https://mcp.aka.page/api/megabox/movies
+- Megabox seats API: https://mcp.aka.page/api/megabox/seats
+- Lotte Cinema theaters API: https://mcp.aka.page/api/lottecinema/theaters
+- Lotte Cinema movies API: https://mcp.aka.page/api/lottecinema/movies
+- Lotte Cinema seats API: https://mcp.aka.page/api/lottecinema/seats
 - hola-poke-yeoksam reference repo: https://github.com/mnspkm/hola-poke-yeoksam-skill
 - hola-poke-yeoksam remote MCP endpoint: https://hola-poke-yeoksam-skill.onrender.com/mcp
 - retention-corp/coupang_partners (Coupang Partners client and local MCP-compatible layer): https://github.com/retention-corp/coupang_partners
--- a/korean-cinema-search/SKILL.md
+++ b/korean-cinema-search/SKILL.md
@ -0,0 +1,187 @@
+---
+name: korean-cinema-search
+description: CGV, 메가박스, 롯데시네마 영화관 검색, 상영작, 시간표, 잔여석 조회가 필요할 때 사용한다.
+license: MIT
+metadata:
+  category: entertainment
+  locale: ko-KR
+  phase: v1
+---
+
+# Korean Cinema Search
+
+## What this skill does
+
+upstream 원본 [`hmmhmmhm/daiso-mcp`](https://github.com/hmmhmmhm/daiso-mcp) 와 npm package [`daiso`](https://www.npmjs.com/package/daiso) 를 사용해 **CGV, 메가박스, 롯데시네마 영화관 검색, 상영작, 시간표, 잔여석 조회**를 안내한다.
+
+이 저장소는 upstream 코드를 vendoring 하지 않는다. 기본 경로는 **MCP 서버를 직접 설치하지 않고 CLI로 먼저 확인하는 방식**이다.
+
+핵심 조회 경로:
+
+- CGV: `/api/cgv/theaters`, `/api/cgv/movies`, `/api/cgv/timetable`
+- 메가박스: `/api/megabox/theaters`, `/api/megabox/movies`, `/api/megabox/seats`
+- 롯데시네마: `/api/lottecinema/theaters`, `/api/lottecinema/movies`, `/api/lottecinema/seats`
+- health check: `npx --yes daiso health`
+
+## When to use
+
+- "강남 근처 CGV 찾아줘"
+- "오늘 메가박스 코엑스 상영작 알려줘"
+- "롯데시네마 월드타워 잔여석 확인해줘"
+- "주변 영화관 시간표 비교해줘"
+
+## When not to use
+
+- 예매, 결제, 좌석 선점, 로그인 자동화
+- 영화관 계정이나 멤버십 권한이 필요한 기능
+- upstream 서버 코드를 이 저장소에 복사해서 유지하려는 경우
+
+## Prerequisites
+
+- 인터넷 연결
+- `node` 20 권장
+- `npx` 또는 `npm`
+- 필요하면 `git`
+
+## Preferred setup: CLI first
+
+먼저 MCP 연결이 아니라 upstream CLI로 공개 endpoint를 확인한다.
+
+날짜가 있는 요청은 Asia/Seoul 기준 `YYYYMMDD` 로 정규화하고 `--playDate <YYYYMMDD>` 를 항상 붙인다. 사용자가 오늘이라고 말하거나 날짜를 생략하면 KST 오늘 날짜를 계산한다.
+
+```bash
+npx --yes daiso health
+npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json
+npx --yes daiso get /api/cgv/movies --keyword 강남 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/megabox/theaters --keyword 코엑스 --limit 5 --json
+npx --yes daiso get /api/megabox/movies --keyword 코엑스 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+npx --yes daiso get /api/lottecinema/theaters --keyword 월드타워 --limit 5 --json
+npx --yes daiso get /api/lottecinema/movies --keyword 월드타워 --playDate <YYYYMMDD> --json
+npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+반복 사용이면 전역 설치도 가능하다.
+
+```bash
+npm install -g daiso
+export NODE_PATH="$(npm root -g)"
+daiso health
+```
+
+## Fallback: clone the original repository
+
+public endpoint 재시도나 버전 고정이 필요하면 원본 저장소를 clone 해서 build 결과물 `dist/bin.js` 를 직접 실행한다.
+
+```bash
+git clone https://github.com/hmmhmmhm/daiso-mcp.git
+cd daiso-mcp
+npm install
+npm run build
+node dist/bin.js health
+node dist/bin.js get /api/cgv/theaters --keyword 강남 --limit 5 --json
+node dist/bin.js get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+node dist/bin.js get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+node dist/bin.js get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+## Required inputs
+
+### 1. Cinema chain
+
+체인이 없으면 먼저 묻는다.
+
+- 권장 질문: `어느 영화관을 볼까요? CGV, 메가박스, 롯데시네마 중 하나를 알려주세요.`
+
+### 2. Theater or area keyword
+
+지역이나 지점명이 없으면 바로 조회하지 말고 기준 위치를 받는다.
+
+- 권장 질문: `어느 지역이나 지점을 기준으로 볼까요? 예: 강남, 코엑스, 월드타워`
+
+### 3. Movie title when seats are requested
+
+잔여석 질문인데 영화명이 없으면 먼저 영화 후보를 조회하거나 영화명을 물어본다.
+
+### 4. Date
+
+사용자가 날짜를 말하면 그 날짜를 우선한다. 날짜가 없으면 Asia/Seoul 기준 오늘을 `YYYYMMDD` 로 계산해 `--playDate <YYYYMMDD>` 로 넘긴다.
+
+| 체인 | 후보 조회 | 상영작 | 시간표 또는 잔여석 | 날짜 |
+| --- | --- | --- | --- | --- |
+| CGV | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+| 메가박스 | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+| 롯데시네마 | `keyword`, 선택 `limit` | `keyword` 또는 `theaterId`, `playDate` | `keyword` 또는 `theaterId`, `movieId`, `playDate` | 필수로 명시 |
+
+## Workflow
+
+### 1. Check server health
+
+```bash
+npx --yes daiso health
+```
+
+### 2. Resolve theater candidates
+
+```bash
+npx --yes daiso get /api/cgv/theaters --keyword 강남 --limit 5 --json
+```
+
+후보가 여러 개면 상위 2개에서 3개만 요약하고 다시 확인받는다.
+
+### 3. Resolve movie candidates
+
+```bash
+npx --yes daiso get /api/cgv/movies --keyword 강남 --playDate <YYYYMMDD> --json
+```
+
+영화 후보가 많으면 제목과 등급만 짧게 정리한다.
+
+### 4. Check timetable or seats
+
+CGV는 시간표 중심으로 본다.
+
+```bash
+npx --yes daiso get /api/cgv/timetable --keyword 강남 --playDate <YYYYMMDD> --json
+```
+
+메가박스와 롯데시네마는 잔여석 endpoint를 사용할 수 있다.
+
+```bash
+npx --yes daiso get /api/megabox/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json
+npx --yes daiso get /api/lottecinema/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json
+```
+
+### 5. Respond conservatively
+
+최종 응답은 짧게 정리한다.
+
+- 영화관 체인
+- 기준 지역이나 지점
+- 상영작 또는 선택 영화
+- 시간표와 잔여석
+- 조회 시각과 공개 endpoint 특성상 변동 가능하다는 점
+
+예매와 결제는 자동화하지 않는다.
+
+## Done when
+
+- `hmmhmmhm/daiso-mcp` 원본 repo와 `daiso` CLI 사용 경로를 명시했다.
+- MCP 서버를 직접 설치하는 대신 CLI first 흐름을 제시했다.
+- CGV, 메가박스, 롯데시네마 조회 범위를 구분했다.
+- 영화관 검색, 상영작, 시간표, 잔여석 중 필요한 호출을 실제로 안내했다.
+- 예매와 결제 자동화가 범위 밖임을 명시했다.
+
+## Failure modes
+
+- public endpoint는 upstream 상태에 따라 간헐적인 5xx를 줄 수 있다.
+- 지역 키워드가 넓으면 다른 지점이 섞일 수 있다.
+- 시간표와 잔여석은 시점에 따라 달라진다.
+- 일부 체인은 상영작, 시간표, 잔여석 endpoint의 입력값이 다르므로 theaterId, movieId가 있으면 그 값을 우선 사용한다.
+
+## Notes
+
+- 원본 프로젝트: `https://github.com/hmmhmmhm/daiso-mcp`
+- npm package: `https://www.npmjs.com/package/daiso`
+- 이 저장소는 upstream 코드를 vendoring 하지 않고 skill/docs만 유지한다.
--- a/scripts/skill-docs.test.js
+++ b/scripts/skill-docs.test.js
@ -1210,6 +1210,69 @@ test("olive-young-search skill documents the upstream daiso CLI flow for stores,
  }
 });

+test("repository docs advertise the korean-cinema-search skill across the documented surfaces", () => {
+  const readme = read("README.md");
+  const install = read(path.join("docs", "install.md"));
+  const roadmap = read(path.join("docs", "roadmap.md"));
+  const sources = read(path.join("docs", "sources.md"));
+  const featureDocPath = path.join(repoRoot, "docs", "features", "korean-cinema-search.md");
+  const skillPath = path.join(repoRoot, "korean-cinema-search", "SKILL.md");
+
+  assert.ok(fs.existsSync(featureDocPath), "expected docs/features/korean-cinema-search.md to exist");
+  assert.ok(fs.existsSync(skillPath), "expected korean-cinema-search/SKILL.md to exist");
+  assert.match(readme, /\| 영화관 검색 \|/);
+  assert.match(readme, /\[영화관 검색 가이드\]\(docs\/features\/korean-cinema-search\.md\)/);
+  assert.match(install, /--skill korean-cinema-search/);
+  assert.match(install, /--playDate <YYYYMMDD>/);
+  assert.match(install, /5xx|retry|재시도/);
+  assert.match(install, /git clone https:\/\/github\.com\/hmmhmmhm\/daiso-mcp\.git && cd daiso-mcp && npm install && npm run build/);
+  assert.match(install, /node dist\/bin\.js get \/api\/cgv\/timetable --keyword 강남 --playDate <YYYYMMDD> --json/);
+  assert.match(roadmap, /영화관 검색 스킬 출시/);
+  assert.match(sources, /https:\/\/github\.com\/hmmhmmhm\/daiso-mcp/);
+  assert.match(sources, /https:\/\/www\.npmjs\.com\/package\/daiso/);
+  assert.match(sources, /https:\/\/mcp\.aka\.page\/api\/cgv\/theaters/);
+  assert.match(sources, /https:\/\/mcp\.aka\.page\/api\/megabox\/theaters/);
+  assert.match(sources, /https:\/\/mcp\.aka\.page\/api\/lottecinema\/theaters/);
+});
+
+test("korean-cinema-search skill documents the upstream daiso CLI flow for Korean cinemas", () => {
+  const skillPath = path.join(repoRoot, "korean-cinema-search", "SKILL.md");
+  const featureDoc = read(path.join("docs", "features", "korean-cinema-search.md"));
+
+  assert.ok(fs.existsSync(skillPath), "expected korean-cinema-search/SKILL.md to exist");
+
+  const skill = read(path.join("korean-cinema-search", "SKILL.md"));
+
+  assert.match(skill, /^name: korean-cinema-search$/m);
+  assert.match(skill, /^description: .*CGV.*메가박스.*롯데시네마.*$/m);
+
+  for (const doc of [skill, featureDoc]) {
+    assert.match(doc, /hmmhmmhm\/daiso-mcp/);
+    assert.match(doc, /npm install -g daiso|npx --yes daiso|npx daiso/);
+    assert.match(doc, /MCP 서버를 .*직접 설치.*않고.*CLI/u);
+    assert.match(doc, /Asia\/Seoul|KST/);
+    assert.match(doc, /YYYYMMDD/);
+    assert.match(doc, /--playDate <YYYYMMDD>/);
+    assert.match(doc, /\/api\/cgv\/movies --keyword 강남 --playDate <YYYYMMDD> --json/);
+    assert.match(doc, /\/api\/cgv\/timetable --keyword 강남 --playDate <YYYYMMDD> --json/);
+    assert.match(doc, /\/api\/megabox\/seats --keyword 코엑스 --playDate <YYYYMMDD> --limit 10 --json/);
+    assert.match(doc, /\/api\/lottecinema\/seats --keyword 월드타워 --playDate <YYYYMMDD> --limit 10 --json/);
+    assert.match(doc, /CGV/);
+    assert.match(doc, /메가박스/);
+    assert.match(doc, /롯데시네마/);
+    assert.match(doc, /\/api\/cgv\/theaters/);
+    assert.match(doc, /\/api\/cgv\/movies/);
+    assert.match(doc, /\/api\/cgv\/timetable/);
+    assert.match(doc, /\/api\/megabox\/theaters/);
+    assert.match(doc, /\/api\/megabox\/movies/);
+    assert.match(doc, /\/api\/megabox\/seats/);
+    assert.match(doc, /\/api\/lottecinema\/theaters/);
+    assert.match(doc, /\/api\/lottecinema\/movies/);
+    assert.match(doc, /\/api\/lottecinema\/seats/);
+    assert.match(doc, /예매|결제/);
+  }
+});
+
 test("repository docs advertise the bunjang-search skill across the documented surfaces", () => {
  const readme = read("README.md");
  const install = read(path.join("docs", "install.md"));
@ -3882,6 +3945,7 @@ const README_SKILL_NAME_COLUMN_MAPPING = [
  ["다이소 상품 조회", "daiso-product-search"],
  ["마켓컬리 상품 조회", "market-kurly-search"],
  ["올리브영 검색", "olive-young-search"],
+  ["영화관 검색", "korean-cinema-search"],
  ["올라포케 역삼 포케", "hola-poke-yeoksam"],
  ["택배 배송조회", "delivery-tracking"],
  ["쿠팡 상품 검색", "coupang-product-search"],