@nomadamas/k-skill 0.1.0

package/skills/ktx-booking/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "ktx-booking",
+  "description": "Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "vault",
+    "browser",
+    "action:booking"
+  ],
+  "frontmatter": "name: ktx-booking\ndescription: Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: travel\n  locale: ko-KR\n  phase: v1"
+}

package/skills/lck-analytics/instruction.md

@@ -0,0 +1,192 @@
+# LCK Results + Advanced Analysis
+
+## What this skill does
+
+이 스킬은 LCK 조회/분석 전용이다.
+
+- 특정 날짜 LCK 경기 결과 조회
+- 특정 팀 alias 정규화 후 필터링
+- 현재 스플릿 순위 조회
+- 진행 중 경기 live stats 조회
+- live timeline 기반 turning point 분석
+- Oracle's Elixir 스타일 historical row / CSV 기반
+  - 팀 파워 레이팅
+  - 챔피언 matchup / synergy 분석
+  - patch meta 요약
+- 날짜별 match analysis 생성
+
+## Origin / attribution
+
+이 스킬은 `jerjangmin` 님이 만든 원본 [`lck-analytics` skill pack](https://github.com/jerjangmin/share/tree/main/SKILL/lck-analytics)을 k-skill 저장소 안으로 옮기고, 이 저장소의 npm workspace / Changesets 배포 방식에 맞게 정리한 버전이다.
+
+## When to use
+
+- "오늘 LCK 경기 결과 알려줘"
+- "2026-04-01 한화 경기 결과랑 순위 보여줘"
+- "지금 T1 경기 킬/골드/오브젝트 요약해줘"
+- "이 경기 turning point가 뭐였어?"
+- "이 밴픽에서 어느 쪽 조합이 더 좋았는지 설명해줘"
+- "현재 패치에서 어떤 챔피언이 메타 픽인지 보여줘"
+- "LCK 팀 파워 레이팅 보여줘"
+
+## Prerequisites
+
+- Node.js 18+
+- `npm install -g lck-analytics`
+
+패키지가 없으면 다른 방법으로 우회하지 말고 먼저 전역 설치를 시도한다.
+
+```bash
+npm install -g lck-analytics
+```
+
+## Inputs
+
+### 기본 입력
+
+- 날짜: `YYYY-MM-DD`
+- 선택 사항: 팀명, 과거 팀명, 한글/영문 약칭 alias
+
+### 고급 분석 입력
+
+- Oracle's Elixir 스타일 CSV 문자열 또는 row 배열
+- game id / match id
+- live window/details payload 또는 실시간 fetch 권한
+- patch version
+
+## Team alias normalization
+
+다음 이름들은 같은 canonical team 으로 인식한다.
+
+- `DN SOOPers`
+- `DN FREECS`
+- `광동 프릭스`
+- `Afreeca Freecs`
+
+추가로 `T1`, `SKT T1`, `담원`, `Dplus KIA`, `브리온`, `한화`, `젠지`, `피어엑스` 등도 alias 정규화를 지원한다.
+
+## Official surfaces
+
+이 스킬은 Riot 공식 / 공식 웹앱 표면을 우선 사용한다.
+
+- 일정/결과: `getSchedule`
+- 토너먼트 목록: `getTournamentsForLeague`
+- 순위: `getStandings`
+- 이벤트 상세: `getEventDetails`
+- 라이브 window: `https://feed.lolesports.com/livestats/v1/window/{gameId}`
+- 라이브 details: `https://feed.lolesports.com/livestats/v1/details/{gameId}`
+
+historical 고급 분석은 Oracle's Elixir 스타일 데이터 입력을 사용한다.
+
+## Workflow
+
+### Included lightweight local pipeline
+
+이 k-skill 팩에는 경량 로컬 파일 기반 파이프라인 스크립트가 포함된다.
+
+- `scripts/sync-oracle.js`: Oracle-style CSV → historical cache JSON
+- `scripts/build-match-report.js`: 날짜별 match analysis 생성
+- `scripts/analyze-live-game.js`: game analysis 생성
+- 기본 cache 위치: `.openclaw-lck-cache/`
+
+### 1. Basic scoreboard / standings query
+
+```bash
+GLOBAL_NPM_ROOT="$(npm root -g)" node --input-type=module - <<'JS'
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const entry = pathToFileURL(
+  path.join(process.env.GLOBAL_NPM_ROOT, "lck-analytics", "src", "index.js"),
+).href;
+const { getLckSummary } = await import(entry);
+
+const summary = await getLckSummary("2026-04-01", {
+  team: "한화",
+  includeStandings: true,
+});
+
+console.log(JSON.stringify(summary, null, 2));
+JS
+```
+
+### 2. Historical analytics from Oracle-style CSV
+
+직접 API를 호출해도 되지만, local skill pipeline에서는 아래 스크립트 사용을 우선 권장한다.
+
+```bash
+node ./lck-analytics/scripts/sync-oracle.js \
+  --csv ./lck-analytics/samples/oracle-lck-sample.csv
+```
+
+### 3. Match analysis via local pipeline script
+
+```bash
+node ./lck-analytics/scripts/build-match-report.js \
+  --date 2026-04-01
+```
+
+필요하면 팀 필터도 같이 준다.
+
+```bash
+node ./lck-analytics/scripts/build-match-report.js \
+  --date 2026-04-01 \
+  --team 한화
+```
+
+### 4. Game analysis with turning points via local pipeline script
+
+```bash
+node ./lck-analytics/scripts/analyze-live-game.js \
+  --game game-id
+```
+
+fixture 기반으로 분석할 때는 `--window`, `--details` 를 같이 줄 수 있다.
+
+## Output guidelines
+
+사용자에게는 원본 JSON을 길게 그대로 던지지 말고 먼저 아래 순서로 정리한다.
+
+### 경기 결과 요청
+
+- 경기 시각
+- 팀1 vs 팀2
+- 상태
+- 세트 스코어
+- 요청 팀 경기만 있으면 해당 경기 우선
+- standings 요청이 있으면 현재 순위 같이 표시
+
+### 진행 중 경기 요청
+
+- 현재 게임 번호
+- 킬 차이
+- 골드 차이
+- 드래곤/바론/타워 차이
+- turning point 1~3개
+
+### historical / meta 요청
+
+- sample 수를 먼저 표시
+- 팀 파워 레이팅은 상위 팀부터 정렬
+- champion matchup / synergy는 표본 수가 적으면 낮은 확신도로 표시
+- patch meta는 top picks / risers 위주로 짧게 요약
+
+## Done when
+
+- 날짜 기준 경기 요약이 있다
+- 요청 팀 필터가 적용된다
+- standings 요청이면 현재 순위가 같이 정리된다
+- live 요청이면 현재 게임 요약과 turning point가 있다
+- historical 입력이 있으면 patch meta 또는 power rating까지 설명할 수 있다
+
+## Failure modes
+
+- Riot 웹앱 API 구조/헤더가 바뀌면 패키지 수정이 필요할 수 있다
+- `LOLESPORTS_API_KEY` public fallback이 회전되면 환경변수 override가 필요할 수 있다
+- historical CSV 컬럼명이 너무 다르면 Oracle-style 정규화 전에 전처리가 필요할 수 있다
+
+## Notes
+
+- 이 스킬은 조회/분석 전용이다
+- 사용자의 "오늘/어제" 요청은 항상 절대 날짜(`YYYY-MM-DD`)로 변환해서 실행한다
+- 이 저장소에서 `main` 으로 머지되면 Changesets가 Version Packages PR을 만들고, 그 PR이 merge된 뒤 npm publish가 실행된다

package/skills/lck-analytics/scripts/_lib.js

@@ -0,0 +1,103 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { pathToFileURL } = require("node:url");
+
+async function loadLckResults() {
+  const candidates = [];
+  const packageNames = ["lck-analytics", "lck-results"];
+
+  if (process.env.GLOBAL_NPM_ROOT) {
+    for (const packageName of packageNames) {
+      candidates.push(path.join(process.env.GLOBAL_NPM_ROOT, packageName, "src", "index.js"));
+    }
+  }
+
+  try {
+    const globalRoot = await detectGlobalNpmRoot();
+    for (const packageName of packageNames) {
+      candidates.push(path.join(globalRoot, packageName, "src", "index.js"));
+    }
+  } catch {
+    // ignore detection failure and continue to local fallback
+  }
+
+  candidates.push(path.resolve(__dirname, "..", "..", "packages", "lck-analytics", "src", "index.js"));
+
+  const entryPath = candidates.find((candidate) => fs.existsSync(candidate));
+  if (!entryPath) {
+    throw new Error("Could not find lck-analytics package. Install it globally with `npm install -g lck-analytics` or run from the k-skill repo.");
+  }
+
+  return import(pathToFileURL(entryPath).href);
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function readJson(filePath, fallback = null) {
+  if (!fs.existsSync(filePath)) {
+    return fallback;
+  }
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function writeJson(filePath, value) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+function readText(filePath, fallback = "") {
+  if (!fs.existsSync(filePath)) {
+    return fallback;
+  }
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) {
+      continue;
+    }
+    const key = token.slice(2);
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) {
+      args[key] = true;
+      continue;
+    }
+    args[key] = next;
+    index += 1;
+  }
+  return args;
+}
+
+function formatOutput(value) {
+  return `${JSON.stringify(value, null, 2)}\n`;
+}
+
+function resolveCachePaths(baseDir) {
+  return {
+    root: baseDir,
+    historical: path.join(baseDir, "historical-analysis.json"),
+    live: path.join(baseDir, "live"),
+    reports: path.join(baseDir, "reports"),
+  };
+}
+
+async function detectGlobalNpmRoot() {
+  const { execFileSync } = require("node:child_process");
+  return execFileSync("npm", ["root", "-g"], { encoding: "utf8" }).trim();
+}
+
+module.exports = {
+  ensureDir,
+  formatOutput,
+  loadLckResults,
+  parseArgs,
+  readJson,
+  readText,
+  resolveCachePaths,
+  writeJson,
+};

package/skills/lck-analytics/scripts/analyze-live-game.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+const fs = require("node:fs");
+const path = require("node:path");
+const {
+  formatOutput,
+  loadLckResults,
+  parseArgs,
+  readJson,
+  resolveCachePaths,
+  writeJson,
+} = require("./_lib");
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const gameId = args.game;
+  if (!gameId) {
+    throw new Error("--game <gameId> is required");
+  }
+
+  const cacheDir = path.resolve(args.cache || path.join(process.cwd(), ".openclaw-lck-cache"));
+  const paths = resolveCachePaths(cacheDir);
+  const historicalWrapper = readJson(paths.historical, { data: {} });
+  const pkg = await loadLckResults();
+
+  const liveWindowPayload = args.window ? JSON.parse(fs.readFileSync(path.resolve(args.window), "utf8")) : undefined;
+  const liveDetailsPayload = args.details ? JSON.parse(fs.readFileSync(path.resolve(args.details), "utf8")) : undefined;
+
+  const analysis = await pkg.getGameAnalysis(gameId, {
+    matchId: args.match,
+    number: args.number ? Number(args.number) : null,
+    state: args.state || undefined,
+    historicalDataset: historicalWrapper.data,
+    liveWindowPayload,
+    liveDetailsPayload,
+  });
+
+  const reportFile = path.join(paths.reports, `game-${gameId}.json`);
+  writeJson(reportFile, analysis);
+
+  process.stdout.write(formatOutput({
+    ok: true,
+    reportFile,
+    patch: analysis.patch,
+    turningPoints: analysis.turningPoints,
+    draftEdge: analysis.draft?.overallEdge || null,
+  }));
+}
+
+main().catch((error) => {
+  console.error(error.stack || String(error));
+  process.exitCode = 1;
+});

package/skills/lck-analytics/scripts/build-match-report.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+const path = require("node:path");
+const {
+  formatOutput,
+  loadLckResults,
+  parseArgs,
+  readJson,
+  resolveCachePaths,
+  writeJson,
+} = require("./_lib");
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const date = args.date;
+  if (!date) {
+    throw new Error("--date <YYYY-MM-DD> is required");
+  }
+
+  const cacheDir = path.resolve(args.cache || path.join(process.cwd(), ".openclaw-lck-cache"));
+  const paths = resolveCachePaths(cacheDir);
+  const historicalWrapper = readJson(paths.historical, { data: {} });
+  const pkg = await loadLckResults();
+
+  const analysis = await pkg.getMatchAnalysis(date, {
+    team: args.team || undefined,
+    historicalDataset: historicalWrapper.data,
+  });
+
+  const reportFile = path.join(paths.reports, `match-${date}${args.team ? `-${args.team}` : ""}.json`);
+  writeJson(reportFile, analysis);
+
+  process.stdout.write(formatOutput({
+    ok: true,
+    reportFile,
+    queryDate: analysis.queryDate,
+    matchCount: analysis.matches.length,
+    teams: analysis.matches.map((match) => `${match.team1?.name} vs ${match.team2?.name}`),
+  }));
+}
+
+main().catch((error) => {
+  console.error(error.stack || String(error));
+  process.exitCode = 1;
+});

package/skills/lck-analytics/scripts/sync-oracle.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+const path = require("node:path");
+const {
+  formatOutput,
+  loadLckResults,
+  parseArgs,
+  readText,
+  resolveCachePaths,
+  writeJson,
+} = require("./_lib");
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const cacheDir = path.resolve(args.cache || path.join(process.cwd(), ".openclaw-lck-cache"));
+  const csvPath = args.csv ? path.resolve(args.csv) : path.join(__dirname, "..", "samples", "oracle-lck-sample.csv");
+  const league = args.league || "LCK";
+  const csvText = readText(csvPath);
+
+  if (!csvText.trim()) {
+    throw new Error(`CSV not found or empty: ${csvPath}`);
+  }
+
+  const pkg = await loadLckResults();
+  const historical = pkg.buildHistoricalAnalytics(csvText, { league });
+  const paths = resolveCachePaths(cacheDir);
+
+  writeJson(paths.historical, {
+    source: {
+      type: "oracle-style-csv",
+      csvPath,
+      league,
+      updatedAt: new Date().toISOString(),
+    },
+    data: historical,
+  });
+
+  process.stdout.write(formatOutput({
+    ok: true,
+    cacheFile: paths.historical,
+    teamRatings: historical.teamPowerRatings.length,
+    matchupStats: historical.matchupStats.length,
+    synergyStats: historical.synergyStats.length,
+    patchMeta: historical.patchMeta.length,
+  }));
+}
+
+main().catch((error) => {
+  console.error(error.stack || String(error));
+  process.exitCode = 1;
+});

package/skills/lck-analytics/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "lck-analytics",
+  "description": "Riot 공식 LoL Esports 데이터와 Oracle's Elixir 스타일 historical 데이터로 LCK 경기 결과, 현재 순위, live turning point, 밴픽 matchup/synergy, patch meta, 팀 파워 레이팅을 조회한다.",
+  "profiles": [
+    "vault",
+    "lookup"
+  ],
+  "frontmatter": "name: lck-analytics\ndescription: Riot 공식 LoL Esports 데이터와 Oracle's Elixir 스타일 historical 데이터로 LCK 경기 결과, 현재 순위, live turning point, 밴픽 matchup/synergy, patch meta, 팀 파워 레이팅을 조회한다.\nlicense: MIT\nmetadata:\n  category: sports\n  locale: ko-KR\n  phase: v1"
+}

package/skills/lh-notice-search/instruction.md

@@ -0,0 +1,206 @@
+# LH 청약 공고문 조회
+
+## What this skill does
+
+한국토지주택공사(LH)가 `apply.lh.or.kr` 로 공고하는 **임대주택·분양주택·주거복지(신혼희망타운 등)·토지·상가 공고**를 공공데이터포털(`data.go.kr`)의 공식 LH 공고 Open API로 조회한다. 요청은 `k-skill-proxy` 의 `/v1/lh-notice/*` 라우트로 보내고, 결과는 공고 목록·공고 상세(주택형별 공급 정보)로 정리한다.
+
+본 스킬은 사회초년생, 청년, 신혼부부처럼 **LH 공고 존재 자체를 모르는 사용자**가 공고 마감 전에 공고문을 빠르게 찾을 수 있도록 돕는다.
+
+## When to use
+
+- "LH 영구임대 공고 지금 뭐 올라와 있어?"
+- "신혼희망타운 공고 요즘 나온 거 정리해줘"
+- "부산광역시 LH 임대주택 공고중인 것 보여줘"
+- "전세임대 공고 중 마감 임박한 거 찾아줘"
+- "공고번호 2015122300019828 상세 정보 보여줘"
+- "행복주택 청년 모집 공고 요약해줘"
+
+## When not to use
+
+- 개별 사용자의 자격 심사, 당첨 예측, 가점 계산
+- 청약 신청 자동화/자동 제출 (본 스킬은 read-only 조회다)
+- 청약통장·주택도시기금 계좌 업무 (해당 범위는 LH 공고와 별개다)
+- SH(서울주택도시공사)·GH(경기주택도시공사)·iH(인천도시공사) 전용 공고 (본 스킬은 LH 공고만 다룬다)
+
+## Inputs
+
+- `panSs` (또는 `status`): 공고 상태. `공고중`, `접수중`, `접수마감`, `당첨자발표`, `추정공고` 중 하나. 비우면 전체.
+- `uppAisTpCd` (또는 `category`): 주택 대분류. `01`(토지), `05`(분양주택), `06`(임대주택), `13`(주거복지·신혼희망타운), `22`(상가).
+- `aisTpCd`: 세부 분류 코드 (숫자). 예: `09`=영구임대, `10`=행복주택, `17`=전세임대.
+- `cnpCdNm` (또는 `region`): 지역명. 예: `서울특별시`, `부산광역시`, `전국`.
+- `panNm` (또는 `q`, `keyword`): 공고명 부분 검색 키워드. 예: `행복주택`, `청년`, `든든주택`.
+- `panNtStDt` (또는 `startDate`): 공고 게시일 시작. YYYY-MM-DD / YYYYMMDD / YYYY.MM.DD 모두 허용.
+- `clsgDt` (또는 `endDate`): 접수 마감일 종료. 날짜 포맷 동일.
+- `page` (기본 1, 최대 1000), `pageSize` (기본 50, 최대 1000).
+
+상세 조회 (`/v1/lh-notice/detail`) 는 `panId`, `ccrCnntSysDsCd`, `splInfTpCd` 세 값 모두 필수다. 이 값은 목록 응답의 `pan_id`, `ccr_cnnt_sys_ds_cd`, `spl_inf_tp_cd` 를 그대로 쓰면 된다.
+
+## Prerequisites
+
+- 인터넷 연결
+- `curl` (또는 동일한 HTTP 호출이 가능한 도구)
+
+사용자에게 필요한 시크릿은 없다. 공공데이터포털 `DATA_GO_KR_API_KEY` 는 `k-skill-proxy` 서버 쪽에만 둔다.
+
+## Default path
+
+`KSKILL_PROXY_BASE_URL` 환경변수가 있으면 그 값, 없으면 기본 `https://k-skill-proxy.nomadamas.org` 를 사용한다.
+
+```bash
+BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
+BASE="${BASE%/}"
+```
+
+## Supported endpoints
+
+### 공고 목록 조회
+
+```
+GET /v1/lh-notice/search
+```
+
+필터는 선택사항이다. 필터 없이 호출하면 최근 공고를 상태 무관하게 최대 50건 돌려준다. 마감 임박한 공고만 보고 싶다면 `panSs=공고중` 과 `clsgDt` 로 구간을 좁힌다.
+
+### 공고 상세 조회
+
+```
+GET /v1/lh-notice/detail?panId={공고ID}&ccrCnntSysDsCd={연계시스템코드}&splInfTpCd={공급정보유형코드}
+```
+
+상세 응답은 `notice`(공고 요약) + `supply_infos`(주택형/필지/상가호 별 공급 정보 배열) 를 돌려준다.
+
+## Example requests
+
+### 목록 — 부산 영구임대 공고중
+
+```bash
+curl -fsS --get "${BASE}/v1/lh-notice/search" \
+  --data-urlencode 'panSs=공고중' \
+  --data-urlencode 'uppAisTpCd=06' \
+  --data-urlencode 'cnpCdNm=부산광역시' \
+  --data-urlencode 'pageSize=20'
+```
+
+### 목록 — 키워드 "행복주택" 으로 접수중
+
+```bash
+curl -fsS --get "${BASE}/v1/lh-notice/search" \
+  --data-urlencode 'q=행복주택' \
+  --data-urlencode 'status=접수중'
+```
+
+### 상세 — 특정 공고
+
+```bash
+curl -fsS --get "${BASE}/v1/lh-notice/detail" \
+  --data-urlencode 'panId=2015122300019828' \
+  --data-urlencode 'ccrCnntSysDsCd=03' \
+  --data-urlencode 'splInfTpCd=051'
+```
+
+## Response shape
+
+### 목록 응답
+
+```json
+{
+  "items": [
+    {
+      "pan_id": "2015122300019828",
+      "pan_nm": "2026년 상반기 부산광역시 영구임대주택 예비입주자 모집 공고",
+      "upp_ais_tp_cd": "06",
+      "ais_tp_cd": "09",
+      "ais_tp_cd_nm": "영구임대",
+      "cnp_cd_nm": "부산광역시",
+      "pan_ss": "공고중",
+      "pan_dt": "2026-04-21",
+      "clsg_dt": "2026-05-06",
+      "rcrit_pblanc_dt": null,
+      "spl_inf_tp_cd": "051",
+      "ccr_cnnt_sys_ds_cd": "03",
+      "detail_url": "https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancInfo.do?panId=2015122300019828&..."
+    }
+  ],
+  "summary": {
+    "page": 1,
+    "page_size": 20,
+    "returned_count": 1,
+    "total_count": 1
+  },
+  "query": {
+    "pan_ss": "공고중",
+    "upp_ais_tp_cd": "06",
+    "cnp_cd_nm": "부산광역시"
+  },
+  "proxy": {
+    "name": "k-skill-proxy",
+    "cache": { "hit": false, "ttl_ms": 300000 }
+  }
+}
+```
+
+### 상세 응답
+
+```json
+{
+  "notice": {
+    "pan_id": "2015122300019828",
+    "pan_nm": "2026년 상반기 부산광역시 영구임대주택 예비입주자 모집 공고",
+    "ais_tp_cd_nm": "영구임대",
+    "...": "목록 응답과 동일한 필드"
+  },
+  "supply_infos": [
+    { "HOUSE_TY": "영구임대 29㎡", "SPL_CNT": "120" },
+    { "HOUSE_TY": "영구임대 39㎡", "SPL_CNT": "80" }
+  ],
+  "query": {
+    "pan_id": "2015122300019828",
+    "ccr_cnnt_sys_ds_cd": "03",
+    "spl_inf_tp_cd": "051"
+  },
+  "proxy": { "...": "..." }
+}
+```
+
+## Response policy
+
+- 공식 LH 공고(`apply.lh.or.kr`) 정보만 사용한다. 커뮤니티 요약, 블로그 후기, 사설 부동산 정보는 섞지 않는다.
+- **마감 여부는 KST 기준 현재 날짜와 `clsg_dt` 를 비교해 판정**한다. 오늘 = 마감일이면 "오늘 마감"으로 표기한다.
+- 상세 응답의 `detail_url` 을 항상 함께 보여 준다. 사용자는 공고문 원본으로 바로 접근할 수 있어야 한다.
+- 공고번호(`pan_id`) 를 숨기지 말고 요약에 포함한다. 이후 상세 조회에 그대로 쓴다.
+- **본 스킬은 SH·GH·iH 공고를 포함하지 않는다.** 사용자가 서울시·경기도·인천시 공사 공고를 찾으면 본 스킬로는 못 찾는다는 점을 분명히 말한다.
+
+## Keep the answer compact
+
+사용자에게 돌려줄 때는 이렇게 압축한다.
+
+- 필터 요약: 지역 + 공고 유형 + 상태
+- 결과 건수 (`summary.total_count` 와 `returned_count`)
+- 상위 3-5건 대표 공고: 공고명, 지역, 공고일, 마감일, 상태, 링크
+- 마감 임박(D-3 이하) 공고는 별도로 강조
+- 상세 조회 제안: "공고번호 X 상세 보고 싶으면 `lh-notice/detail` 로 조회"
+
+## Failure modes
+
+- 필터 값이 잘못되면 `400 bad_request` 가 돌아온다. 오류 메시지를 그대로 노출해 사용자가 교정하게 한다.
+- 프록시 서버에 `DATA_GO_KR_API_KEY` 가 없으면 `503 upstream_not_configured` 가 돌아온다.
+- upstream(공공데이터포털) 이 일시 장애이면 `502 upstream_error` + `upstream_code` 를 돌려준다. 재시도는 캐시되지 않으므로 바로 다시 호출해도 된다.
+- upstream 이 XML 에러 envelope(`OpenAPI_ServiceResponse`) 를 돌려주면 `502 upstream_error` + `upstream_code`(예: `30` = 등록되지 않은 서비스키) 로 변환한다.
+- 응답이 JSON 이 아니면 `502 upstream_invalid_payload` 로 내려간다.
+
+## Done when
+
+- 사용자의 지역·공고 유형·상태 의도에 맞춰 적어도 한 번 `/v1/lh-notice/search` 를 호출했다.
+- 결과에 공고명, 지역, 공고일/마감일, 상태, 공식 링크가 모두 포함되어 있다.
+- 마감 여부를 KST 기준으로 판정해 표기했다.
+- 필요하면 상세 조회로 이어가거나 사용자가 스스로 상세를 조회할 수 있도록 `panId`/`ccrCnntSysDsCd`/`splInfTpCd` 를 함께 안내했다.
+
+## Notes
+
+- 공식 LH 청약플러스 포털: `https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancList.do?mi=1026`
+- 공공데이터포털 카탈로그: `https://www.data.go.kr/data/15058530/openapi.do` (LH 임대공고문 정보)
+- upstream `panSs` 값은 한국어로 정확히 맞춰서 보낸다. 영문/공백 변형은 받지 않는다.
+- 대분류/세부분류 코드 매핑 참고:
+  - `06` 임대주택: `09` 영구임대, `10` 행복주택, `17` 전세임대, `08` 국민임대, `26` 매입임대 등
+  - `13` 주거복지: `17` 전세임대, 신혼희망타운 등
+  - `05` 분양주택, `01` 토지, `22` 상가

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

@@ -0,0 +1,10 @@
+{
+  "name": "lh-notice-search",
+  "description": "Search official LH 청약 (Korea Land & Housing Corporation lease/subscription) 공고 lists through k-skill-proxy. Use when a user asks about 청년/행복/영구/국민/매입/전세임대, 분양주택, 신혼희망타운 공고 marketed on apply.lh.or.kr. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "vault",
+    "action:submission"
+  ],
+  "frontmatter": "name: lh-notice-search\ndescription: Search official LH 청약 (Korea Land & Housing Corporation lease/subscription) 공고 lists through k-skill-proxy. Use when a user asks about 청년/행복/영구/국민/매입/전세임대, 분양주택, 신혼희망타운 공고 marketed on apply.lh.or.kr. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: real-estate\n  locale: ko-KR\n  phase: v1"
+}