feat: add Korean housing subscription score and deposit reference skill (#696)

.changeset/housing-subscription-reference-710.md

@@ -0,0 +1,5 @@
+---
+"@nomadamas/k-skill": patch
+---
+
+민영주택 청약가점·예치금 참고 스킬(`housing-subscription-reference`)을 번들 참고 CSV 기반으로 정리한다. 런타임 외부 GitHub/개인 저장소 CSV URL과 GitHub `/blob/` fallback을 제거하고, 「주택공급에 관한 규칙」 별표 1·별표 2 값을 2026-10-30 검토일로 스킬에 번들한다. 지역 등급(서울·부산 / 인천·대구·광주·대전·울산 / 그 외), 신청자 주민등록상 거주지역 기준, 반개구간 점수·면적 경계, 배우자 가입기간 50%·최대 3점·합산 상한 17점, 미성년자 최대 5년 규칙을 명시하고, 설명·문서·소스·감사 표·스킬 목록·플러그인 매니페스트를 갱신한다 (#710)

.claude-plugin/plugin.json

@@ -55,6 +55,7 @@
     "./hola-poke-yeoksam",
     "./household-waste-info",
     "./housing-official-price",
+    "./housing-subscription-reference",
     "./hwp",
     "./intercity-bus-booking",
     "./iros-registry-automation",

README.md

@@ -73,6 +73,7 @@ npx -y @nomadamas/k-skill@0 update
 | --- | --- | --- |
 | [한국 부동산 실거래가 조회](docs/features/real-estate-search.md) | `real-estate-search` | 아파트/오피스텔/빌라/단독주택 실거래가·전월세·지역코드 조회 |
 | [한국 주택 공시가격 조회](docs/features/housing-official-price.md) | `housing-official-price` | realtyprice.kr 공개 웹 데이터 표면에서 공동주택·개별주택 정부 공시가격 이력을 직접 조회 (공식 문서화된 OpenAPI 아님) |
+| [민영주택 청약가점·예치금 기준 조회](docs/features/housing-subscription-reference.md) | `housing-subscription-reference` | 「주택공급에 관한 규칙」 별표 1·별표 2 기준 청약가점(무주택기간·부양가족·가입기간 84점)과 지역·면적별 청약 예치금 조회 (외부 CSV 의존 없이 번들 참고값) |
 | [개별공시지가 조회](docs/features/gongsijiga-search.md) | `gongsijiga-search` | realtyprice.kr 공개 API에서 지번 단위 개별공시지가(원/㎡) 다년도 추이·전년 대비 변동률 조회 |
 | [건축물대장 표제부 조회](docs/features/building-register-search.md) | `building-register-search` | 주소·PNU·법정동 코드와 필지로 주용도·연면적·층수·사용승인일 조회 (공공데이터포털 15134735, 프록시 경유) |
 | [LH 청약 공고문 조회](docs/features/lh-notice-search.md) | `lh-notice-search` | 한국토지주택공사(LH) 임대/분양/주거복지(신혼희망타운)/토지/상가 공고를 지역·상태·공고유형·키워드로 조회하고 마감 여부를 KST 기준으로 표시 |

docs/features/housing-subscription-reference.md

@@ -0,0 +1,43 @@
+# 민영주택 청약가점·예치금 참고 (housing-subscription-reference)
+
+민영주택 일반공급의 청약가점 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회하는 read-only 참고 스킬이다. 이슈 [#696](https://github.com/NomaDamas/k-skill/issues/696)에서 제안됐다.
+
+## 값의 출처
+
+값은 「주택공급에 관한 규칙」(국토교통부령, 시행 2026-06-15) 별표 1(가점제 적용기준, 개정 2024-12-18)과 별표 2(민영주택 청약 예치기준금액, 개정 2023-05-10)를 옮긴 정적 참고값이다. 1차 권위는 법제처 국가법령정보센터(law.go.kr)이며, 검토일은 2026-10-30이다. 최신 법령과 입주자모집공고가 항상 우선한다.
+
+스킬에 함께 번들된 참고 파일을 CLI `read`로 읽는다(런타임에 외부 GitHub·개인 저장소·CSV URL에 의존하지 않는다).
+
+- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv`
+- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv`
+- 지역·면적 규칙: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md`
+
+## 입력
+
+- score: `category`(`homeless_period`·`dependents`·`subscription_account_period`)와 `condition`(정확한 키). 키 전체 목록은 스킬 지침에 열거돼 있다.
+- deposit: `region`(`seoul_busan`·`other_metropolitan`·`other_city_county`)과 `housing_area`(`85sqm_or_less`·`102sqm_or_less`·`135sqm_or_less`·`all_areas`).
+
+## 지역 구분
+
+- `seoul_busan`: 서울특별시, 부산광역시.
+- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개).
+- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등.
+
+구분 기준은 **입주자모집공고일 현재 신청자의 주민등록표상 거주지역**이며, 공급(분양) 사업지 소재지가 아니다.
+
+## 면적 구간과 점수 구간
+
+- 면적: `(0, 85]`, `(85, 102]`, `(102, 135]`, `(135, ∞)`의 반개구간으로 해석한다. 예: 84.9㎡는 85㎡ 이하, 85.01㎡는 102㎡ 이하.
+- 점수: 모든 구간이 반개구간 `[이상, 미만)`이다. 무주택기간 10년 = 22점, 청약통장 가입기간 1년 = 3점.
+
+## 계산 예시
+
+- 서울, 85㎡ 이하: 300만원 (`seoul_busan` + `85sqm_or_less`).
+- 세종, 84.9㎡: 200만원 (`other_city_county` + `85sqm_or_less`).
+- 서울, 85.01㎡: 600만원 (`seoul_busan` + `102sqm_or_less`).
+- 무주택 10년 + 부양가족 2명 + 가입 1년: 22 + 15 + 3 = 40점.
+- 만 30세 미만 미혼 무주택자(및 유주택자): 무주택기간 0점. 최대 합계: 32 + 35 + 17 = 84점.
+
+## 범위와 주의
+
+정적 참고자료이며, 현재 청약Home 공고·개인 자격 판정·법률 자문이 아니다. 특정 단지의 당첨 커트라인·경쟁률·당첨 확률과 국민주택(공공주택) 청약은 이 스킬의 범위가 아니다. 실제 청약은 항상 최신 입주자모집공고문과 청약Home, 최신 「주택공급에 관한 규칙」을 확인한다.

docs/runtime-action-audit.md

@@ -64,6 +64,7 @@ top-level `SKILL.md` 전체를 돌쇠 우선 실행 계약으로 전수 검토
 | `heyyumi` | `booking` | 예약 가능한 매장 검색 → `clarify` 후 `reserve` 전송 → `cli.next`로 매장 수락/거절 확인 |
 | `household-waste-info` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 |
 | `housing-official-price` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 |
+| `housing-subscription-reference` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 |
 | `hwp` | `local` | 요청 산출물을 로컬에서 실제 생성·변환·정리 |
 | `intercity-bus-booking` | `booking` | 공식 일정/좌석 선택 → 예약·선점 → `clarify` 후 필요한 결제 |
 | `iros-registry-automation` | `legal` | 공식 등기 표면에서 로그인·서류 준비를 진행하고 `clarify` 후 허용된 신청·수수료 결제 |

docs/sources.md

@@ -91,6 +91,7 @@
 - real-estate-mcp: https://github.com/tae0y/real-estate-mcp/tree/main
 - realtyprice.kr 개별주택가격 검색 화면: https://www.realtyprice.kr/notice/hpindividual/search.htm — `housing-official-price`가 공개 read-only web data surface로 관측한 개별주택가격 진입점. 가격 목록 JSON은 browser-visible `https://www.realtyprice.kr/notice/search/hpiSearchListApi.search` 형태를 직접 호출하며, 공식 문서화된 OpenAPI 계약으로 취급하지 않는다.
 - realtyprice.kr 공동주택가격 모바일 검색 화면: https://www.realtyprice.kr/notice/m/town/search.do — `housing-official-price`가 공개 read-only web data surface로 관측한 공동주택가격 진입점. 후보/상세/동/호/가격 이력은 `/notice/m/town/getApt.do`, `/notice/m/town/detail.do`, `/notice/m/town/getHo.do`, `/notice/m/town/getPriceYear.do` 흐름으로 직접 호출하며, 응답은 `model.list` 또는 `modelMap.list` 형태가 모두 가능하다.
+- 「주택공급에 관한 규칙」(국토교통부령 제1592호, 시행 2026-06-15) 별표 1·별표 2: https://www.law.go.kr/법령/주택공급에관한규칙 — `housing-subscription-reference`의 1차 권위. 별표 1(가점제 적용기준, 개정 2024-12-18)은 무주택기간·부양가족수·주택청약종합저축 가입기간 점수표, 별표 2(민영주택 청약 예치기준금액, 개정 2023-05-10)는 지역 3등급 × 전용면적 4구간 예치금(단위 만원)이다. 별표 2 비고는 “지역”을 입주자모집공고일 현재 신청자의 주민등록표상 거주지역으로 정의한다. 법제처 국가법령정보센터에서 2026-10-30 검토한 값을 스킬에 번들 CSV(`housing-subscription-reference/references/housing_subscription_score.csv`, `housing-subscription-reference/references/private_housing_deposit.csv`)로 고정해 런타임에 외부 GitHub/개인 저장소 CSV URL에 의존하지 않는다. 질문의 ‘지역’은 광역시 등급에 따라 `seoul_busan`(서울·부산), `other_metropolitan`(인천·대구·광주·대전·울산 5곳), `other_city_county`(세종특별자치시·제주특별자치도·강원특별자치도·전북특별자치도 및 도 관할 시·군 등)로 나뉜다.
 - 한국장학재단 학자금 지원구간 산정절차: https://www.kosaf.go.kr/ko/tuition.do?pg=tuition04_09_01&type=tuition
 - 한국장학재단 학자금 지원구간 경곗값 확인: https://www.kosaf.go.kr/ko/tuition.do?naviParam=JH%2C01%2C01%2C03&pg=tuition04_09_07
 - 한국장학재단 푸른등대 기부장학금: https://www.kosaf.go.kr/ko/scholar.do?pg=scholarship05_11_01

housing-subscription-reference/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: housing-subscription-reference
+description: 민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다.
+license: MIT
+metadata:
+  category: real-estate
+  locale: ko-KR
+  phase: v1
+---
+
+# housing-subscription-reference
+
+<!-- k-skill:cli-stub — generated by scripts/generate-skill-stubs.js; edit skill.json / instruction.md instead -->
+
+## Get the full instructions (required first step)
+
+Run this and follow its output as the primary instructions for this skill:
+
+```bash
+npx -y @nomadamas/k-skill@0 instruct housing-subscription-reference
+```
+
+The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:
+
+```bash
+npx -y @nomadamas/k-skill@0 files housing-subscription-reference
+```
+
+Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with:
+
+```bash
+npx -y @nomadamas/k-skill@0 update
+```
+
+If `npx` is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/housing-subscription-reference/instruction.md.
+
+## Hard rules even without the CLI
+
+- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
+- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
+- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.