# K-Skill을 Codex에서 활용하기

KDI 고급 과정 마지막 선택 모듈 · 30분/5단계. 기준 확인일2026-10-13.

## 실습 순서

1. 공식 저장소에서 원하는 업무와 스킬 원본을 찾는다.
2. codex-kdi-lab과 프로젝트 .agents/skills, Node.js/npx/Python 및 통신 범위를 확인한다.
3. kosis-stats 한 개를 프로젝트에 설치한다.
4. Codex 채팅에서 $kosis-stats로 공개 통계표 후보를 조회한다.
5. 기관·표ID·기간·단위·분모·원문 링크를 검수하고 work/k-skill-check.md에 기록한다.

## 설치 명령 (터미널)

codex-kdi-lab 위치에서 설치 범위와 기존 파일을 먼저 확인한다. 이 수업은 프로젝트 선택 설치를 사용한다.

```bash
npx skills add NomaDamas/k-skill --skill kosis-stats --agent codex --copy
```

--skill은 설치할 스킬, --agent codex는 대상 에이전트, --copy는 복사 방식이다. -g/--all을 붙이지 않는다. 확인 화면에서 Project 범위인지 읽고 기존 파일 덮어쓰기는 비교 후 진행한다. 설치 결과의 .agents/skills/kosis-stats/SKILL.md와 실제 frontmatter name을 확인한다. 반영이 안 보이면 Codex를 재시작한다.

## 설치 전 확인

K-Skill은 외부 커뮤니티 모음이다. 필요한 기능만 원본에서 검토한다. kosis-stats는 공식 통계 검색·조회, 기존 수업용 stat-brief는 받은 CSV의 분석·원고 작성이다. 후보 bok-ecos-stats·korean-law-search·gov-overseas-trip-report는 각자의 원본 문서에서 조건을 다시 확인한다.

현재 일부 SKILL.md는 전체 지침을 CLI로 읽는 어댑터다. 짧은 파일만 복사한 것으로 준비가 끝났다고 가정하지 않는다. 연결 instruction.md와 CLI/runtime 요구사항을 확인한다. 일반 KOSIS 조회의 hosted proxy와 direct/bigdata의 키 요건은 다르다. 내부자료나 계정정보를 외부 요청에 넣지 않는다. Node.js/npx와 Python helper 요건, 허용 네트워크를 먼저 점검한다. 이 수업에서 자동 설정·개인 시크릿 탐색·전역 갱신은 실행하지 않는다.

## 호출 요청 (Codex 채팅)

```text
$kosis-stats 공개 검색어 "1인 가구"로 통계표 후보를 최대3개 찾아 기관, 표ID, 표명, 제공 기간과 공식 링크를 정리해 주세요. 설치된 SKILL.md와 연결 지침을 먼저 확인하고, 후보 하나의 지역·항목·단위 메타데이터를 읽어 주세요. 가능한 경우에만2024년의 작은 범위를 조회하세요. 공개 검색어만 전송하고 direct/bigdata·키 발급·개인 시크릿 탐색·전역 갱신·자동 설정은 하지 마세요. 실패하면 실패 내용을 표시하고 수치를 만들지 마세요.
```

검색 결과는 실제 수치를 확인한 데이터가 아니다. 표 후보→메타데이터→작은 범위 순으로 읽고 기준연도·모집단·지역·단위가 맞는지 검사한다. 최신 표와 교육용2024 전사CSV가 같다고 가정하지 않는다. 실패하면 KOSIS 웹 다운로드 또는 제공 CSV를 사용하고 라이브 조회 성공으로 보고하지 않는다.

## 기록 요청 (Codex 채팅)

```text
지금까지 실제 확인한 내용만 work/k-skill-check.md에 정리해 주세요. K-Skill 원본 링크, 설치 경로/name, 외부 조회 조건, 기관·표ID·기준기간·단위·분모·공식 URL, 검수 결과와 미확인 사항을 기록하세요. 조회 실패와 제공 CSV 사용은 구분하세요. inbox/·assets/·계정 설정은 변경하지 말고 외부 발송은 하지 마세요.
```

이 안내는 원본 스킬을 재배포하거나 수강생 PC에 설치한 파일이 아니다. 실제 설치·호출은 수강생 환경에서 확인한다. 라이선스와 도구·프록시 이용조건은 원본 링크에서 확인한다.

## 원본과 공식 문서

- https://github.com/NomaDamas/k-skill
- https://github.com/NomaDamas/k-skill/blob/main/docs/install.md
- https://github.com/NomaDamas/k-skill/blob/main/kosis-stats/SKILL.md
- https://github.com/NomaDamas/k-skill/blob/main/kosis-stats/instruction.md
- https://github.com/NomaDamas/k-skill/blob/main/docs/features/kosis-stats.md
- https://github.com/vercel-labs/skills
- https://learn.chatgpt.com/docs/build-skills