k-skill 사용법: 한국 생활 자동화를 AI 에이전트에게 맡기기 전 확인할 것

AI 에이전트를 써 보다가 가장 자주 막히는 지점은 “한국 사이트에서 실제로 쓸 수 있나?”입니다. 해외 서비스 기준 예제는 많지만, 막상 KTX 예매, SRT 조회, 로또 확인, 미세먼지, 카카오톡, 쿠팡·다이소·올리브영 검색처럼 한국 생활에 가까운 일을 시키려면 인증, 공공 API, 국내 사이트 구조, 한글 문서 형식이 한꺼번에 걸립니다. k-skill은 이 문제를 한국 사용자 관점에서 모아 둔 AI 에이전트용 스킬 모음집입니다.

이 글에서는 GitHub에 공개된 NomaDamas/k-skill 저장소와 공식 문서를 기준으로, k-skill이 무엇을 해결하는지, 어떤 기능이 있는지, 설치 전 무엇을 확인해야 하는지, 실제로 쓸 때 주의할 점을 정리합니다.

재검증일: 2026-08-30. GitHub 저장소의 main 브랜치와 npm 패키지 @nomadamas/k-skill 0.5.0을 확인했습니다. 저장소에는 SKILL.md가 123개 있었고, Node.js 26.5.0 환경에서 설치 안내와 미세먼지 조회 경로를 점검했습니다. 계정 로그인·예약·결제·취소는 실행하지 않았습니다.

k-skill 한 줄 요약

k-skill은 Claude Code, Codex, OpenCode, OpenClaw/ClawHub 같은 코딩·자동화 에이전트가 한국 생활 서비스를 다루기 쉽도록 만든 한국형 스킬·가이드 묶음입니다. 저장소 README는 SRT, KTX, KBO, 로또, 당근, 쿠팡, 카카오톡, 정부24, 홈택스 등 “귀찮은 것을 AI 에이전트에게 시키는” 용도를 전면에 내세웁니다.

핵심은 단순 프롬프트 모음이 아니라, 기능별 입력값과 실행 흐름, 실패 조건을 문서화한 데 있습니다. 2026년 8월 30일 기준 KTX와 SRT는 로그인·예약·결제 기능이 아니라 조회 전용 스킬입니다. 미세먼지처럼 hosted proxy를 쓰는 기능도 있지만, 실제 사용 전에는 프록시 상태와 원본 데이터 출처를 함께 확인해야 합니다.

누가 쓰면 좋은가

AI 에이전트에게 한국 생활 정보를 조회시키고 싶은 사람
매번 사이트를 열어 검색·확인하는 반복 업무를 줄이고 싶은 사람
한국 공공데이터, 민원, 교통, 쇼핑, 금융 정보를 에이전트 워크플로에 붙이고 싶은 개발자
Claude Code·Codex 같은 도구를 쓰지만 국내 서비스 자동화 예제가 부족하다고 느낀 사람
개인용 자동화는 하고 싶지만 시크릿을 어디에 둘지, 어떤 기능이 로그인 없이 가능한지 먼저 확인하고 싶은 사람

“AI가 결제·예약·계정 작업까지 모두 끝내 주는 도구”로 이해하면 범위를 잘못 잡게 됩니다. 조회 전용 스킬과 실제 실행을 지원하는 스킬이 섞여 있으므로, 각 SKILL.md와 기능 문서에서 지원 범위를 먼저 확인해야 합니다.

대표 기능 예시

분야	예시 기능	확인할 점
교통	KTX, SRT, 고속버스, 시외버스, 서울 지하철 도착정보	KTX·SRT는 조회 전용, 버스 예매는 별도 기능 문서 확인
생활 정보	날씨, 미세먼지, 한강 수위, 생활쓰레기 배출정보, 학교 급식	일부 기능은 hosted proxy로 사용자 키 없이 조회 가능
공공·법률	한국 법령 검색, 부동산 실거래가, 특허 검색, 사업자등록정보 확인	직접 API 키가 필요한 경로와 프록시 경로 구분
쇼핑·가격	쿠팡, 다이소, 올리브영, 당근, 네이버 쇼핑, 다나와	사이트 정책과 재고·가격 변동성 확인
문서·생산성	HWP 문서 조회·편집, 맞춤법 검사, 한글 글자수, 한국어 문체 도구	문서 원본 보존과 변환 결과 검수 필요

현재 공식 README는 KTX와 SRT를 조회 전용으로 안내합니다. KTX는 코레일 공개 XLSX 기반 계획 시간표를, SRT는 live 시간표와 일반실·특실 이용 가능 여부를 조회합니다. 로그인·예약·예약대기·결제·취소는 수행하지 않습니다. 이전 글에 적었던 KSKILL_KTX_ID, KSKILL_KTX_PASSWORD 기반 예약 흐름은 현재 문서와 맞지 않아 삭제했습니다.

설치 전 체크리스트

사용 중인 에이전트 확인: README는 Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 여러 에이전트 지원을 언급합니다. 본인이 쓰는 도구가 스킬 파일을 어디에서 읽는지 먼저 확인합니다.
시크릿이 필요한 기능 구분: 공통 설정 가이드는 기능별 필요한 환경변수와 credential resolution order를 정리합니다.
기본 프록시 사용 여부 확인: 미세먼지, 한강 수위, 일부 공공데이터 조회처럼 hosted proxy를 쓰면 사용자 키가 없어도 되는 기능이 있습니다. self-host를 할 때만 별도 API 키가 필요할 수 있습니다.
계정 작업의 책임 범위 확인: 예약, 로그인, 결제, 민감정보가 들어가는 기능은 자동화가 편하더라도 최종 확인은 사용자가 해야 합니다.
실패 시 대체 경로 준비: 국내 사이트는 보안 모듈, 봇 차단, UI 변경이 잦습니다. 공식 문서, 브라우저 수동 확인, 원본 사이트 링크를 함께 남겨 두는 것이 좋습니다.

시크릿 관리는 어떻게 하나

k-skill 공식 설정 문서는 credential-bearing 스킬이 환경변수, 에이전트 자체 secret vault, ~/.config/k-skill/secrets.env 순서로 값을 찾는다고 안내합니다. 여기서 중요한 점은 비밀번호를 프롬프트 본문에 직접 붙여 넣지 않는 것입니다. 계정 정보가 필요한 기능이라면 변수 이름을 먼저 확인하고, 운영 중인 secret vault나 권한이 제한된 dotenv 파일에 넣어야 합니다.

KTX와 SRT 조회는 현재 사용자 로그인이 필요하지 않습니다. 반면 고속버스·시외버스 예매처럼 계정 작업이 포함된 스킬은 별도 인증 경로를 씁니다. 같은 교통 기능이라도 요구사항이 다르므로 실행 전에 해당 스킬의 최신 지침을 다시 읽어야 합니다.

실제로 쓸 때 좋은 패턴

k-skill은 조회와 실행 범위를 먼저 나누고 쓰는 편이 안전합니다. 기차표는 날짜·출발역·도착역·희망 시간을 넣어 시간표와 좌석 가능 여부를 확인하는 데까지만 맡기고, 예약과 결제는 공식 서비스에서 별도로 진행합니다. 실제 실행을 지원하는 스킬도 결과를 원본 화면과 대조한 뒤 다음 단계로 넘어가야 합니다.

조회 → 후보 비교 → 실행 순서로 나눈다.
결제, 취소, 예약처럼 되돌리기 어려운 단계는 사용자 확인을 받는다.
공식 사이트 링크와 조회 시각을 함께 기록한다.
에이전트가 반환한 결과를 원본 서비스 화면이나 공식 API와 교차 확인한다.
실패한 경우 봇 차단, 인증 만료, API 키 누락, 사이트 구조 변경 중 무엇인지 구분한다.

Daily Info Lab 독자에게 유용한 활용 예

Daily Info Lab은 AI 도구와 개발자용 오픈소스를 직접 설치해 확인합니다. k-skill도 기능 목록만 옮기기보다 에이전트가 어떤 지침을 읽는지, 실제 조회가 어디에서 실패하는지 확인하는 쪽이 이 사이트의 검증 방식에 맞습니다.

공개 데이터 조회는 비교적 가볍게 시험할 수 있지만 hosted proxy가 항상 응답하는 것은 아닙니다. 로그인·예약·결제 기능은 각 공식 서비스의 현재 정책과 원본 결과를 다시 확인해야 합니다.

주의할 점

자동화 가능 범위와 합법·약관 범위는 다릅니다. 사이트 약관, 과도한 요청, 계정 공유, 결제 자동화는 별도로 검토해야 합니다.
민감정보를 대화창에 그대로 넣지 마세요. 계정 ID, 비밀번호, API 키는 환경변수나 secret vault로 관리합니다.
공식 문서를 기준으로 확인하세요. GitHub README와 docs가 최신 사용법의 기준입니다.
AI 결과를 그대로 믿지 마세요. 교통편, 가격, 재고, 정부 신청 조건은 조회 시점에 따라 바뀔 수 있습니다.
예약·취소·결제는 특히 보수적으로 처리하세요. 에이전트가 후보를 좁혀 주더라도 최종 선택은 사람이 확인하는 방식이 안전합니다.

FAQ

k-skill은 일반 앱인가요?

일반 소비자 앱이라기보다 AI 에이전트가 참고하고 실행할 수 있는 스킬·문서·헬퍼 묶음에 가깝습니다. 사용 중인 에이전트 환경에 맞게 설치하고 호출하는 방식입니다.

모든 기능에 로그인이 필요한가요?

아닙니다. 공식 README와 설정 문서는 기능별로 사용자 로그인 필요, 불필요, 선택사항을 구분합니다. 예매·계정 기반 기능은 로그인이 필요할 수 있고, 일부 생활정보 조회는 hosted proxy로 사용자 키 없이 사용할 수 있습니다.

비밀번호를 AI에게 알려줘도 되나요?

대화창에 직접 입력하는 방식은 피하는 것이 좋습니다. k-skill 문서처럼 환경변수, secret vault, 권한이 제한된 설정 파일을 통해 필요한 값만 주입하는 방식이 안전합니다.

k-skill만 있으면 자동 예약과 결제가 끝나나요?

아닙니다. 2026년 8월 30일 기준 KTX와 SRT는 조회 전용이며 로그인·예약·결제·취소를 수행하지 않습니다. 다른 예매 스킬은 기능별 문서를 확인하고, 결제나 취소처럼 영향이 큰 단계는 사람이 직접 확인해야 합니다.

직접 확인한 설치와 조회 결과

2026년 8월 30일 Node.js 26.5.0 환경에서 저장소 commit 6f200646을 clone해 확인했습니다. 저장소에는 SKILL.md가 123개 있었고, npm의 최신 @nomadamas/k-skill 버전은 0.5.0이었습니다.

k-skill 저장소 실제 실행 화면 — k-skill 저장소를 clone하고 SKILL.md 파일을 확인한 터미널 화면입니다.

현재 설치 명령

# 전체 스킬 설치
npx --yes skills add NomaDamas/k-skill --all -g

# 특정 스킬만 설치
npx --yes skills add NomaDamas/k-skill --skill fine-dust-location -g

# 실행 환경에 맞는 지침 확인
npx -y @nomadamas/k-skill@0 instruct fine-dust-location

기본 설치에는 Node.js 18 이상과 npx가 필요합니다. KTX·SRT 조회 helper를 실행할 때는 Python 3.11 이상과 uv가 추가로 필요합니다.

실패한 경로

이 환경에서 npx -y @nomadamas/k-skill@0 instruct fine-dust-location은 출력 없이 exit code 255로 끝났습니다. npm tarball을 내려받아 포함된 CLI를 직접 실행했을 때는 generic runtime용 지침이 정상 출력됐습니다.

지침에 나온 미세먼지 report endpoint를 서울 관악구로 호출했지만 HTTP 530과 Cloudflare error code 1033이 반환됐습니다. 따라서 hosted proxy가 항상 응답한다고 가정하면 안 됩니다. 실제 자동화에는 원본 데이터 조회나 수동 확인 경로를 함께 두는 편이 안전합니다.

공식 출처

공개 정보 확인 시점: 2026-08-30 01:37 UTC. GitHub API와 npm, 공식 저장소에서 아래 값을 확인했습니다.

항목	확인값
GitHub stars	7,366
forks	899
open issues	57
기본 브랜치	`main`
npm 패키지	`@nomadamas/k-skill` 0.5.0
저장소 내 SKILL.md	123개
라이선스	MIT

k-skill은 한국 서비스용 스킬을 한곳에서 살펴보는 출발점으로 쓸 만합니다. 다만 저장소의 기능 범위와 설치 방식이 빠르게 바뀌고, 이번 확인에서는 hosted proxy가 응답하지 않았습니다. 설치 직전 최신 SKILL.md를 읽고 조회 결과를 원본 서비스와 대조해야 합니다.

AI/IT도구에서 이어서 보면 좋은 글

한 번 더 클릭하게 만드는 내부 링크 구간입니다. 같은 주제의 실용 글로 이동시키고, 카테고리 허브로도 연결합니다.