[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73HDW2NPDR92PBAYMW5QT2P":3,"skill-same:01M73HDW2NPDR92PBAYMW5QT2P":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":56,"commitSha":57,"skillDirectory":58,"forksCount":59,"repositoryHtmlUrl":60,"repositoryHomepageUrl":6,"ownerHtmlUrl":61,"ownerBlogUrl":6,"ownerDescription":62,"updatedAt":63,"install":64,"resources":76},"01M73HDW2NPDR92PBAYMW5QT2P","k-kosis",null,"Queries the Korean Statistical Information Service (`통계청 KOSIS`, `국가통계포털`) Open API for national statistics — population, price indices, macroeconomic indicators, and other government-published statistical tables. Covers keyword search, table-list browsing, statistical data retrieval, and metadata lookup. Requires KOSIS_API_KEY environment variable.","5throck\u002Fai-workspace-standards","5throck","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10958964?v=4","01M73BFEH0V0VS483TW4JD49JW","01M73BFEJ5VQZJHJSFTVPAZGDM",25,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Fk-kosis\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: k-kosis\nscope: common\ndescription: >\n  Queries the Korean Statistical Information Service (`통계청 KOSIS`, `국가통계포털`)\n  Open API for national statistics — population, price indices, macroeconomic\n  indicators, and other government-published statistical tables. Covers\n  keyword search, table-list browsing, statistical data retrieval, and\n  metadata lookup. Requires KOSIS_API_KEY environment variable.\nversion: 1.0.3\nlast_reviewed: 2026-08-23\nstatus: active\nowner: public-data-analyst\nprerequisites: KOSIS_API_KEY environment variable\nrelates_to:\n  - skill: k-dart\n    type: composes_with\n  - skill: k-ecos\n    type: composes_with\n  - skill: k-law\n    type: relates_to\nl2_propagate: true\nmetadata:\n  type: domain\n  source: https:\u002F\u002Fkosis.kr\u002Fopenapi\u002F\n  license: KOGL (`공공누리`)\n  category: macro-statistics\n  locale: ko-KR\n  triggers:\n    - k-kosis\n    - \u002Fk-kosis\n    - KOSIS\n    - '`통계청`'\n    - '`국가통계포털`'\n    - '`인구통계`'\n    - '`물가지수`'\n    - '`경제통계`'\n    - '`국가통계`'\n    - Korean national statistics\n---\n\n## Context\n\nUnified skill for the Korean Statistical Information Service (KOSIS, `통계청 국가통계포털`) Open API — covers integrated keyword search, statistics-table-list browsing, statistical data retrieval, and statistics metadata lookup. Complements DART-based company financials (`k-dart`) and legal research (`k-law`): KOSIS supplies the macro\u002Fpopulation\u002Fprice-index context (e.g. CPI, population, industry production indices) needed to frame a company or market narrative against the broader Korean economy. Useful for pitch-deck research requiring macro-economic or industry-sizing context with citation.\n\n## When to Use\n\n- National statistic keyword search (e.g., \"find the KOSIS table for `소비자물가지수`\")\n- Browsing a statistics category to find the right table\u002Fclassification structure\n- Pulling actual time-series data for a known table (e.g., \"get annual population figures 2015-2024\")\n- Statistics metadata\u002Fexplanation lookup (survey basis, period, source law, notes)\n- Macro-economic or demographic context research to support market-sizing or industry-context slides\n- Any engagement requiring verified Korean government statistical data with citation\n\n## Execution Steps\n\n1. **Verify Prerequisites**: Confirm `KOSIS_API_KEY` environment variable is set. If not, guide the user to the KOSIS Open API portal at \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F> (\"`활용신청`\" menu) to apply for a key. ⚠️ **Unverified**: the exact approval process\u002Fturnaround is not documented on the fetched devGuide pages — do not assume a specific timeline; point the user to the portal itself.\n2. **Discover the target table**: If the user only knows a statistic by name (not `orgId`\u002F`tblId`), call `statisticsSearch.do` (`통합검색`) with `searchNm` to find candidate `ORG_ID`\u002F`TBL_ID` pairs.\n3. **Understand classification structure**: If the table's classification codes (`objL1`~`objL8`) or item codes (`itmId`) are not already known, call `statisticsList.do` (`통계목록조회`) starting from a relevant `vwCd`\u002F`parentId` to browse the list and confirm structure, or inspect `TBL_VIEW_URL`\u002F`LINK_URL` from the search result.\n4. **Retrieve data**: Call `Param\u002FstatisticsParameterData.do` (`통계자료조회`) with the resolved `orgId`, `tblId`, `objL1`(~`objL8`), `itmId`, `prdSe`, and either (`startPrdDe`+`endPrdDe`) or `newEstPrdCnt` — never both.\n5. **Metadata lookup (optional)**: If the user needs survey methodology, source law, or period notes, call `statisticsExplData.do` (`통계설명`) with `statId` (or `orgId`+`tblId`) and `metaItm`.\n6. **Process Response**: Always pass `format=json` explicitly. Treat any non-list\u002Fnon-array JSON response as a possible error envelope and print it raw for inspection — the exact error-response shape was not confirmed from the fetched devGuide pages and needs live-testing.\n7. **Format Output**: Present results with compact formatting; append disclaimer \"`통계청 KOSIS 국가통계포털 Open API 자료 기준`\".\n8. **Save to Deliverables**: Store research findings in `deliverables\u002Fresearch\u002F` per project conventions.\n\n## Output Format\n\n- Integrated search: `TBL_NM` \u002F `ORG_NM` \u002F `STAT_NM` \u002F `STRT_PRD_DE`~`END_PRD_DE` \u002F `TBL_VIEW_URL` (top 5-10 relevant matches)\n- Statistics list: `LIST_NM` \u002F `TBL_NM` \u002F `ORG_ID` \u002F `TBL_ID` \u002F `STAT_ID` (classification tree navigation)\n- Statistical data: `TBL_NM` \u002F `C1_NM`(~`C8_NM`) \u002F `ITM_NM` \u002F `UNIT_NM` \u002F `PRD_DE` \u002F `DT` (the value), sorted by period\n- Statistics explanation: requested `metaItm` field(s) verbatim (e.g. `statsPeriod`, `basisLaw`, `dataUserNote`)\n\n## Reference Material\n\n- `references\u002Fterms-ko.json`: Korean-original KOSIS terminology mapping (service names, period types, error messages, seed table codes). Non-Markdown reference asset, exempt from the workspace English-only doc policy. New stable `vwCd`\u002Fclassification patterns from recurring lookups go there.\n\n## Related Skills\n\n- k-dart\n- k-ecos\n- k-law\n- research\n- storyline\n\n## KOSIS Open API Specification\n\n### Prerequisites\n\n`KOSIS_API_KEY` environment variable must be set. Sign up and apply for a key at: \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F> (\"`활용신청`\" menu in the portal navigation). ⚠️ The approval process itself is not confirmed from the fetched devGuide pages — guide the user to the portal rather than assuming a specific timeline.\n\n### Discovery Flow\n\n1. **`통합검색`** (`statisticsSearch.do`) — keyword search across all KOSIS tables when the user only knows the statistic's Korean name. Returns candidate `ORG_ID`\u002F`TBL_ID` pairs plus `TBL_VIEW_URL`.\n2. **`통계목록조회`** (`statisticsList.do`) — browse the hierarchical statistics list (by `vwCd`\u002F`parentId`) to confirm classification structure (`objL1`~`objL8`) and item codes (`itmId`) before pulling data.\n3. **`통계자료조회`** (`Param\u002FstatisticsParameterData.do`) — retrieve the actual numeric time-series once `orgId`, `tblId`, classification codes, and `itmId` are known.\n4. **`통계설명`** (`statisticsExplData.do`) — optional metadata\u002Fmethodology lookup, keyed by `statId` or `orgId`+`tblId`.\n\n### 1. Statistical Data Retrieval (`통계자료조회`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FParam\u002FstatisticsParameterData.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `orgId` | Y | Organization ID |\n| `tblId` | Y | Statistical table ID |\n| `objL1` | Y | Classification 1 (first classification code) |\n| `objL2`~`objL8` | N | Classification 2~8 |\n| `itmId` | Y | Item |\n| `prdSe` | Y | Period type (e.g. `Y`=annual, `Q`=quarterly, `M`=monthly) |\n| `startPrdDe` | N* | Start period |\n| `endPrdDe` | N* | End period |\n| `newEstPrdCnt` | N* | Number of most recent periods (defaults to most recent 1 period if omitted) |\n| `prdInterval` | N | Period interval |\n| `format` | Y | Response format (`json`) |\n| `outputFields` | N | Response fields to include |\n| `smblChk` | N | Statistical symbol flag |\n\n\\* Use either (`startPrdDe`+`endPrdDe`) OR `newEstPrdCnt`, not both. If neither is set, defaults to the most recent 1 time point.\n\nResponse fields: `ORG_ID`, `TBL_ID`, `TBL_NM`, `C1_NM`~`C8_NM` (+ `_ENG` variants), `ITM_ID`, `ITM_NM` (+`_ENG`), `UNIT_NM` (+`_ENG`), `PRD_SE`, `PRD_DE`, `DT` (the numeric value), `LST_CHN_DE`.\n\n### 2. Statistics List (`통계목록조회`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsList.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `vwCd` | Y | Service view code (e.g. `MT_ZTITLE`, `MT_OTITLE`) |\n| `parentId` | Y | Starting list ID (some docs call it `parentListId`) |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\nResponse fields: `VW_CD`, `VW_NM`, `LIST_ID`, `LIST_NM`, `ORG_ID`, `TBL_ID`, `TBL_NM`, `STAT_ID`, `SEND_DE`, `REC_TBL_SE`.\n\n### 3. Integrated Search (`통합검색`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsSearch.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `searchNm` | Y | Search keyword |\n| `orgId` | N | Organization ID filter |\n| `sort` | N | `RANK`=relevance (default) \\| `DATE`=most recent |\n| `startCount` | N | Page\u002Fstart offset |\n| `resultCount` | N | Result count |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\nResponse fields: `ORG_ID`, `ORG_NM`, `TBL_ID`, `TBL_NM`, `STAT_ID`, `STAT_NM`, `CONTENTS`, `STRT_PRD_DE`, `END_PRD_DE`, `TBL_VIEW_URL`, `LINK_URL`, `STAT_DB_CNT`.\n\n### 4. Statistics Explanation (`통계설명`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsExplData.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `statId` | Y | Survey ID (alternatively `orgId`+`tblId`) |\n| `metaItm` | Y | `All` or specific field(s): `statsNm`, `statsKind`, `basisLaw`, `writingPurps`, `statsPeriod`, `examinHistory`, `sampleExtrMthd`, `pubPeriod`, `dataUserNote` |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\n### Example Requests\n\n```bash\n# Integrated search — find tables matching a keyword (e.g. 소비자물가지수)\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsSearch.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'searchNm=소비자물가지수' \\\n  --data-urlencode 'sort=RANK' \\\n  --data-urlencode 'resultCount=10' \\\n  --data-urlencode 'format=json'\n\n# Statistics list — browse a classification tree\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsList.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'vwCd=MT_ZTITLE' \\\n  --data-urlencode 'parentId=A' \\\n  --data-urlencode 'format=json'\n\n# Statistical data retrieval — annual population figures, most recent 5 periods\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FParam\u002FstatisticsParameterData.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'orgId=101' \\\n  --data-urlencode 'tblId=DT_1B040A3' \\\n  --data-urlencode 'objL1=00' \\\n  --data-urlencode 'itmId=T20' \\\n  --data-urlencode 'prdSe=Y' \\\n  --data-urlencode 'newEstPrdCnt=5' \\\n  --data-urlencode 'format=json'\n```\n\n> `orgId`\u002F`tblId`\u002F`objL1`\u002F`itmId` values above are illustrative placeholders for the request shape — always resolve the real codes via the Discovery Flow (search → list) before querying live data.\n\n### Response Shape \u002F Response Policy\n\n**Verified by live testing (2026-08-22)** — all four endpoints respond correctly with a valid `KOSIS_API_KEY`:\n\n- Successful responses are a **raw JSON array** of row objects, e.g. `[{ORG_ID:\"101\",ORG_NM:\"...\",...}, ...]`.\n- **Error responses use a confirmed `{err, errMsg}` object** (not an array): `{err:\"30\",errMsg:\"데이터가 존재하지 않습니다.\"}` (no matching data) or `{err:\"21\",errMsg:\"잘못된 요청 변수를 호출 하였습니다.\"}` (invalid request parameter — e.g. wrong `objL1`\u002F`itmId` for the given `tblId`). Treat any object response (not wrapped in `[...]`) as an error; surface `err` + `errMsg` to the user directly.\n- ⚠️ **Non-standard JSON**: KOSIS returns object keys **without quotes** (e.g. `{ORG_ID:\"101\",...}` rather than `{\"ORG_ID\":\"101\",...}`). This is not strict JSON — a strict `JSON.parse`\u002F`json.loads` will fail. Parse with a lenient\u002FJS-literal-tolerant method (e.g. Python: quote the keys with a regex before `json.loads`, or use a JS engine's `eval`-safe parser) rather than a strict JSON parser.\n- ⚠️ **Korean-keyword encoding**: passing a literal Korean string directly as a `curl --data-urlencode` argument value can get mis-encoded in some shells (observed in Git Bash on Windows) — the server received garbled bytes and returned `err:30` (no data) even for a keyword that has real matches. **Always percent-encode Korean query values manually first** (e.g. `python3 -c \"import urllib.parse; print(urllib.parse.quote('검색어'))\"`) and inline the `%XX` sequence directly into the URL, rather than relying on `--data-urlencode` to encode a Korean literal passed inline in the command.\n- Always pass `format=json` explicitly; omitting it may return HTML.\n- For `statisticsParameterData.do`, default to `newEstPrdCnt=1` behavior (most recent period) only when the user does not specify a time range; otherwise prefer explicit `startPrdDe`\u002F`endPrdDe`.\n- **No code-lookup endpoint exists** among the four documented APIs for enumerating a table's valid `objL1`~`objL8`\u002F`itmId` codes directly. In practice, resolve these either from `statisticsList.do`'s classification browsing, or by opening the table's `TBL_VIEW_URL`\u002F`LINK_URL` (from a search\u002Flist result) in a browser to read the classification codes off the KOSIS web UI — guessing common codes (e.g. `00`, `T1`) reliably fails with `err:21`.\n- Format numeric `DT` values with their `UNIT_NM` for readability, while preserving original figures.\n- Append disclaimer at the end: \"`통계청 KOSIS 국가통계포털 Open API 자료 기준`\".\n\n### Failure Modes\n\n- `KOSIS_API_KEY` not set -> guide to portal `활용신청`, then stop\n- `{err:\"30\", errMsg:\"데이터가 존재하지 않습니다.\"}` -> no matching data; broaden the search keyword (and double-check the keyword wasn't mangled by shell encoding — see Response Policy) or verify `orgId`\u002F`tblId`\n- `{err:\"21\", errMsg:\"잘못된 요청 변수를 호출 하였습니다.\"}` -> invalid parameter, most commonly a wrong `objL1`~`objL8`\u002F`itmId` for the given `tblId` — do not guess these; resolve via `statisticsList.do` or the table's web view URL\n- Any other `{err, errMsg}` object -> surface the message verbatim to the user\n- Table\u002Fclassification structure unclear -> fall back to `statisticsList.do` browsing or the table's `TBL_VIEW_URL` before guessing `objL1`~`objL8`\u002F`itmId` values\n\n### Notes\n\n- Data source: [KOSIS 국가통계포털 Open API](https:\u002F\u002Fkosis.kr\u002Fopenapi\u002F)\n- This skill is read-only query only.\n- License: `공공누리`(KOGL) — cite source when reproducing statistical figures in deliverables.\n- Auth\u002Fapproval process for `KOSIS_API_KEY` is not fully documented from the fetched devGuide pages; do not invent a signup URL or approval timeline beyond directing the user to the \"`활용신청`\" menu at \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F>.\n- Promoted from `co-pitch` (originally imported from `co-test`, 2026-08-22) into `templates\u002Fcommon\u002Fskills\u002F` (2026-08-23) to match sibling common skills `k-dart`\u002F`k-law`; `scope: common` and `l2_propagate: true` already set at the source.\n","## Context\n\nUnified skill for the Korean Statistical Information Service (KOSIS, `통계청 국가통계포털`) Open API — covers integrated keyword search, statistics-table-list browsing, statistical data retrieval, and statistics metadata lookup. Complements DART-based company financials (`k-dart`) and legal research (`k-law`): KOSIS supplies the macro\u002Fpopulation\u002Fprice-index context (e.g. CPI, population, industry production indices) needed to frame a company or market narrative against the broader Korean economy. Useful for pitch-deck research requiring macro-economic or industry-sizing context with citation.\n\n## When to Use\n\n- National statistic keyword search (e.g., \"find the KOSIS table for `소비자물가지수`\")\n- Browsing a statistics category to find the right table\u002Fclassification structure\n- Pulling actual time-series data for a known table (e.g., \"get annual population figures 2015-2024\")\n- Statistics metadata\u002Fexplanation lookup (survey basis, period, source law, notes)\n- Macro-economic or demographic context research to support market-sizing or industry-context slides\n- Any engagement requiring verified Korean government statistical data with citation\n\n## Execution Steps\n\n1. **Verify Prerequisites**: Confirm `KOSIS_API_KEY` environment variable is set. If not, guide the user to the KOSIS Open API portal at \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F> (\"`활용신청`\" menu) to apply for a key. ⚠️ **Unverified**: the exact approval process\u002Fturnaround is not documented on the fetched devGuide pages — do not assume a specific timeline; point the user to the portal itself.\n2. **Discover the target table**: If the user only knows a statistic by name (not `orgId`\u002F`tblId`), call `statisticsSearch.do` (`통합검색`) with `searchNm` to find candidate `ORG_ID`\u002F`TBL_ID` pairs.\n3. **Understand classification structure**: If the table's classification codes (`objL1`~`objL8`) or item codes (`itmId`) are not already known, call `statisticsList.do` (`통계목록조회`) starting from a relevant `vwCd`\u002F`parentId` to browse the list and confirm structure, or inspect `TBL_VIEW_URL`\u002F`LINK_URL` from the search result.\n4. **Retrieve data**: Call `Param\u002FstatisticsParameterData.do` (`통계자료조회`) with the resolved `orgId`, `tblId`, `objL1`(~`objL8`), `itmId`, `prdSe`, and either (`startPrdDe`+`endPrdDe`) or `newEstPrdCnt` — never both.\n5. **Metadata lookup (optional)**: If the user needs survey methodology, source law, or period notes, call `statisticsExplData.do` (`통계설명`) with `statId` (or `orgId`+`tblId`) and `metaItm`.\n6. **Process Response**: Always pass `format=json` explicitly. Treat any non-list\u002Fnon-array JSON response as a possible error envelope and print it raw for inspection — the exact error-response shape was not confirmed from the fetched devGuide pages and needs live-testing.\n7. **Format Output**: Present results with compact formatting; append disclaimer \"`통계청 KOSIS 국가통계포털 Open API 자료 기준`\".\n8. **Save to Deliverables**: Store research findings in `deliverables\u002Fresearch\u002F` per project conventions.\n\n## Output Format\n\n- Integrated search: `TBL_NM` \u002F `ORG_NM` \u002F `STAT_NM` \u002F `STRT_PRD_DE`~`END_PRD_DE` \u002F `TBL_VIEW_URL` (top 5-10 relevant matches)\n- Statistics list: `LIST_NM` \u002F `TBL_NM` \u002F `ORG_ID` \u002F `TBL_ID` \u002F `STAT_ID` (classification tree navigation)\n- Statistical data: `TBL_NM` \u002F `C1_NM`(~`C8_NM`) \u002F `ITM_NM` \u002F `UNIT_NM` \u002F `PRD_DE` \u002F `DT` (the value), sorted by period\n- Statistics explanation: requested `metaItm` field(s) verbatim (e.g. `statsPeriod`, `basisLaw`, `dataUserNote`)\n\n## Reference Material\n\n- `references\u002Fterms-ko.json`: Korean-original KOSIS terminology mapping (service names, period types, error messages, seed table codes). Non-Markdown reference asset, exempt from the workspace English-only doc policy. New stable `vwCd`\u002Fclassification patterns from recurring lookups go there.\n\n## Related Skills\n\n- k-dart\n- k-ecos\n- k-law\n- research\n- storyline\n\n## KOSIS Open API Specification\n\n### Prerequisites\n\n`KOSIS_API_KEY` environment variable must be set. Sign up and apply for a key at: \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F> (\"`활용신청`\" menu in the portal navigation). ⚠️ The approval process itself is not confirmed from the fetched devGuide pages — guide the user to the portal rather than assuming a specific timeline.\n\n### Discovery Flow\n\n1. **`통합검색`** (`statisticsSearch.do`) — keyword search across all KOSIS tables when the user only knows the statistic's Korean name. Returns candidate `ORG_ID`\u002F`TBL_ID` pairs plus `TBL_VIEW_URL`.\n2. **`통계목록조회`** (`statisticsList.do`) — browse the hierarchical statistics list (by `vwCd`\u002F`parentId`) to confirm classification structure (`objL1`~`objL8`) and item codes (`itmId`) before pulling data.\n3. **`통계자료조회`** (`Param\u002FstatisticsParameterData.do`) — retrieve the actual numeric time-series once `orgId`, `tblId`, classification codes, and `itmId` are known.\n4. **`통계설명`** (`statisticsExplData.do`) — optional metadata\u002Fmethodology lookup, keyed by `statId` or `orgId`+`tblId`.\n\n### 1. Statistical Data Retrieval (`통계자료조회`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FParam\u002FstatisticsParameterData.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `orgId` | Y | Organization ID |\n| `tblId` | Y | Statistical table ID |\n| `objL1` | Y | Classification 1 (first classification code) |\n| `objL2`~`objL8` | N | Classification 2~8 |\n| `itmId` | Y | Item |\n| `prdSe` | Y | Period type (e.g. `Y`=annual, `Q`=quarterly, `M`=monthly) |\n| `startPrdDe` | N* | Start period |\n| `endPrdDe` | N* | End period |\n| `newEstPrdCnt` | N* | Number of most recent periods (defaults to most recent 1 period if omitted) |\n| `prdInterval` | N | Period interval |\n| `format` | Y | Response format (`json`) |\n| `outputFields` | N | Response fields to include |\n| `smblChk` | N | Statistical symbol flag |\n\n\\* Use either (`startPrdDe`+`endPrdDe`) OR `newEstPrdCnt`, not both. If neither is set, defaults to the most recent 1 time point.\n\nResponse fields: `ORG_ID`, `TBL_ID`, `TBL_NM`, `C1_NM`~`C8_NM` (+ `_ENG` variants), `ITM_ID`, `ITM_NM` (+`_ENG`), `UNIT_NM` (+`_ENG`), `PRD_SE`, `PRD_DE`, `DT` (the numeric value), `LST_CHN_DE`.\n\n### 2. Statistics List (`통계목록조회`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsList.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `vwCd` | Y | Service view code (e.g. `MT_ZTITLE`, `MT_OTITLE`) |\n| `parentId` | Y | Starting list ID (some docs call it `parentListId`) |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\nResponse fields: `VW_CD`, `VW_NM`, `LIST_ID`, `LIST_NM`, `ORG_ID`, `TBL_ID`, `TBL_NM`, `STAT_ID`, `SEND_DE`, `REC_TBL_SE`.\n\n### 3. Integrated Search (`통합검색`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsSearch.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `searchNm` | Y | Search keyword |\n| `orgId` | N | Organization ID filter |\n| `sort` | N | `RANK`=relevance (default) \\| `DATE`=most recent |\n| `startCount` | N | Page\u002Fstart offset |\n| `resultCount` | N | Result count |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\nResponse fields: `ORG_ID`, `ORG_NM`, `TBL_ID`, `TBL_NM`, `STAT_ID`, `STAT_NM`, `CONTENTS`, `STRT_PRD_DE`, `END_PRD_DE`, `TBL_VIEW_URL`, `LINK_URL`, `STAT_DB_CNT`.\n\n### 4. Statistics Explanation (`통계설명`)\n\n```\nGET https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsExplData.do?method=getList\n```\n\n| Parameter | Required | Description |\n|---|---|---|\n| `apiKey` | Y | Issued authentication key |\n| `statId` | Y | Survey ID (alternatively `orgId`+`tblId`) |\n| `metaItm` | Y | `All` or specific field(s): `statsNm`, `statsKind`, `basisLaw`, `writingPurps`, `statsPeriod`, `examinHistory`, `sampleExtrMthd`, `pubPeriod`, `dataUserNote` |\n| `format` | Y | Response format (`json`) |\n| `content` | N | `html` or `json` |\n\n### Example Requests\n\n```bash\n# Integrated search — find tables matching a keyword (e.g. 소비자물가지수)\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsSearch.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'searchNm=소비자물가지수' \\\n  --data-urlencode 'sort=RANK' \\\n  --data-urlencode 'resultCount=10' \\\n  --data-urlencode 'format=json'\n\n# Statistics list — browse a classification tree\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FstatisticsList.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'vwCd=MT_ZTITLE' \\\n  --data-urlencode 'parentId=A' \\\n  --data-urlencode 'format=json'\n\n# Statistical data retrieval — annual population figures, most recent 5 periods\ncurl -fsS --get 'https:\u002F\u002Fkosis.kr\u002Fopenapi\u002FParam\u002FstatisticsParameterData.do' \\\n  --data-urlencode \"apiKey=$KOSIS_API_KEY\" \\\n  --data-urlencode 'method=getList' \\\n  --data-urlencode 'orgId=101' \\\n  --data-urlencode 'tblId=DT_1B040A3' \\\n  --data-urlencode 'objL1=00' \\\n  --data-urlencode 'itmId=T20' \\\n  --data-urlencode 'prdSe=Y' \\\n  --data-urlencode 'newEstPrdCnt=5' \\\n  --data-urlencode 'format=json'\n```\n\n> `orgId`\u002F`tblId`\u002F`objL1`\u002F`itmId` values above are illustrative placeholders for the request shape — always resolve the real codes via the Discovery Flow (search → list) before querying live data.\n\n### Response Shape \u002F Response Policy\n\n**Verified by live testing (2026-08-22)** — all four endpoints respond correctly with a valid `KOSIS_API_KEY`:\n\n- Successful responses are a **raw JSON array** of row objects, e.g. `[{ORG_ID:\"101\",ORG_NM:\"...\",...}, ...]`.\n- **Error responses use a confirmed `{err, errMsg}` object** (not an array): `{err:\"30\",errMsg:\"데이터가 존재하지 않습니다.\"}` (no matching data) or `{err:\"21\",errMsg:\"잘못된 요청 변수를 호출 하였습니다.\"}` (invalid request parameter — e.g. wrong `objL1`\u002F`itmId` for the given `tblId`). Treat any object response (not wrapped in `[...]`) as an error; surface `err` + `errMsg` to the user directly.\n- ⚠️ **Non-standard JSON**: KOSIS returns object keys **without quotes** (e.g. `{ORG_ID:\"101\",...}` rather than `{\"ORG_ID\":\"101\",...}`). This is not strict JSON — a strict `JSON.parse`\u002F`json.loads` will fail. Parse with a lenient\u002FJS-literal-tolerant method (e.g. Python: quote the keys with a regex before `json.loads`, or use a JS engine's `eval`-safe parser) rather than a strict JSON parser.\n- ⚠️ **Korean-keyword encoding**: passing a literal Korean string directly as a `curl --data-urlencode` argument value can get mis-encoded in some shells (observed in Git Bash on Windows) — the server received garbled bytes and returned `err:30` (no data) even for a keyword that has real matches. **Always percent-encode Korean query values manually first** (e.g. `python3 -c \"import urllib.parse; print(urllib.parse.quote('검색어'))\"`) and inline the `%XX` sequence directly into the URL, rather than relying on `--data-urlencode` to encode a Korean literal passed inline in the command.\n- Always pass `format=json` explicitly; omitting it may return HTML.\n- For `statisticsParameterData.do`, default to `newEstPrdCnt=1` behavior (most recent period) only when the user does not specify a time range; otherwise prefer explicit `startPrdDe`\u002F`endPrdDe`.\n- **No code-lookup endpoint exists** among the four documented APIs for enumerating a table's valid `objL1`~`objL8`\u002F`itmId` codes directly. In practice, resolve these either from `statisticsList.do`'s classification browsing, or by opening the table's `TBL_VIEW_URL`\u002F`LINK_URL` (from a search\u002Flist result) in a browser to read the classification codes off the KOSIS web UI — guessing common codes (e.g. `00`, `T1`) reliably fails with `err:21`.\n- Format numeric `DT` values with their `UNIT_NM` for readability, while preserving original figures.\n- Append disclaimer at the end: \"`통계청 KOSIS 국가통계포털 Open API 자료 기준`\".\n\n### Failure Modes\n\n- `KOSIS_API_KEY` not set -> guide to portal `활용신청`, then stop\n- `{err:\"30\", errMsg:\"데이터가 존재하지 않습니다.\"}` -> no matching data; broaden the search keyword (and double-check the keyword wasn't mangled by shell encoding — see Response Policy) or verify `orgId`\u002F`tblId`\n- `{err:\"21\", errMsg:\"잘못된 요청 변수를 호출 하였습니다.\"}` -> invalid parameter, most commonly a wrong `objL1`~`objL8`\u002F`itmId` for the given `tblId` — do not guess these; resolve via `statisticsList.do` or the table's web view URL\n- Any other `{err, errMsg}` object -> surface the message verbatim to the user\n- Table\u002Fclassification structure unclear -> fall back to `statisticsList.do` browsing or the table's `TBL_VIEW_URL` before guessing `objL1`~`objL8`\u002F`itmId` values\n\n### Notes\n\n- Data source: [KOSIS 국가통계포털 Open API](https:\u002F\u002Fkosis.kr\u002Fopenapi\u002F)\n- This skill is read-only query only.\n- License: `공공누리`(KOGL) — cite source when reproducing statistical figures in deliverables.\n- Auth\u002Fapproval process for `KOSIS_API_KEY` is not fully documented from the fetched devGuide pages; do not invent a signup URL or approval timeline beyond directing the user to the \"`활용신청`\" menu at \u003Chttps:\u002F\u002Fkosis.kr\u002Fopenapi\u002F>.\n- Promoted from `co-pitch` (originally imported from `co-test`, 2026-08-22) into `templates\u002Fcommon\u002Fskills\u002F` (2026-08-23) to match sibling common skills `k-dart`\u002F`k-law`; `scope: common` and `l2_propagate: true` already set at the source.\n",{"name":5,"owner":23,"scope":24,"status":25,"version":26,"metadata":27,"relates_to":43,"description":52,"l2_propagate":53,"last_reviewed":54,"prerequisites":55},"public-data-analyst","common","active","1.0.3",{"type":28,"locale":29,"source":30,"license":31,"category":32,"triggers":33},"domain","ko-KR","https:\u002F\u002Fkosis.kr\u002Fopenapi\u002F","KOGL (`공공누리`)","macro-statistics",[5,34,35,36,37,38,39,40,41,42],"\u002Fk-kosis","KOSIS","`통계청`","`국가통계포털`","`인구통계`","`물가지수`","`경제통계`","`국가통계`","Korean national statistics",[44,47,49],{"type":45,"skill":46},"composes_with","k-dart",{"type":45,"skill":48},"k-ecos",{"type":50,"skill":51},"relates_to","k-law","Queries the Korean Statistical Information Service (`통계청 KOSIS`, `국가통계포털`) Open API for national statistics — population, price indices, macroeconomic indicators, and other government-published statistical tables. Covers keyword search, table-list browsing, statistical data retrieval, and metadata lookup. Requires KOSIS_API_KEY environment variable.\n",true,1787443200000,"KOSIS_API_KEY environment variable","main","b57e612781a79b0e3e60878294ce59c86cc68e5d","templates\u002Fcommon\u002Fskills\u002Fk-kosis",9,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards","https:\u002F\u002Fgithub.com\u002F5throck","Experienced in digital transformation, enterprise IT, startup acceleration, and business strategy. Focused on building practical systems that connect technolo","2026-11-14 21:22:34",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":53},[66,69,72],{"tool":67,"command":68},"npx","npx skills add 5throck\u002Fai-workspace-standards --skill k-kosis",{"tool":70,"command":71},"bunx","bunx skills add 5throck\u002Fai-workspace-standards --skill k-kosis",{"tool":73,"command":74},"pnpm","pnpm dlx skills add 5throck\u002Fai-workspace-standards --skill k-kosis","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Fk-kosis\u002FSKILL.md",[77],{"path":78,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fterms-ko.json","REFERENCE","参考文档",1828,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Fk-kosis\u002Freferences\u002Fterms-ko.json",[84,92,97,102,107,112],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":91},"01M7BBJDYHJMGTJYSC37JVWY8S","i18n-layout","Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL\u002Fbidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF\u002FBOM issues surface.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":93,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":91},"01M7BBJ9XHAAS1AVGKZZ841VBZ","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.hermes\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":98,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":91},"01M7BBJ5C3X8TKFKG5R9P9P49W","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.gemini\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":103,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":91},"01M7BBJ1B52X0QMJ2QVBMPJB37","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.codex\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":108,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":91},"01M7BBHX91BW2Q2R276MRX5AW3","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.claude\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":113,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":91},"01M7BBHQWGXPSFRWN1PRC2NMMV","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.agents\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[]]