k-skill 완전 가이드 2026 — SRT·KBO·로또까지 시키는 한국형 AI 에이전트 스킬 설치법

Claude Code에 SRT 예매를 시켜봤다. 그냥 됐다. 한국 서비스를 AI 에이전트에게 맡길 수 있는 스킬 모음집이 나왔는데, 한국어로 정리된 글이 없어서 직접 써봤다.

k-skill이 뭔지부터

k-skill은 Claude Code, Codex, opencode 같은 AI 코딩 에이전트에 한국 서비스 자동화 스킬을 추가하는 오픈소스 모음집이다. GitHub에서 NomaDamas/k-skill로 접근할 수 있다.

2026년 3월 24일 생성됐고, 작성 시점 기준 별 145개. 한국형 AI 에이전트 자동화라는 포지션이 선명한 레포다.

지금 사용할 수 있는 스킬 목록

스킬	상태	기능
SRT 예매	✅ 작동	SRT 특실·입석 예매 자동화
KBO 경기 결과	✅ 작동	오늘/어제 KBO 경기 결과 조회
로또 번호 확인	✅ 작동	당첨 결과 조회
카카오톡 Mac CLI	✅ 작동	맥에서 카톡 메시지 조회/전송
서울 지하철 도착정보	✅ 작동	실시간 지하철 도착 정보
HWP 문서 처리	✅ 작동	한글 문서 읽기·편집
우편번호 검색	✅ 작동	도로명 주소 우편번호 조회
KTX 예매	⚠️ 미완성	목표에는 있으나 현재 미작동

공식 README에서 KTX는 “작동하지 않음”이라고 명시해뒀다. 이건 솔직한 레포다.

왜 이게 필요한가 — 해외 AI 툴이 못 채우는 구간

Claude Code, Codex, opencode 모두 강력하다. 그런데 한국 서비스 자동화는 약하다.

SRT 예매? 한국 로그인 구조 + 한국어 UI
KBO 경기 결과? 한국 뉴스 + 한국어 파싱
HWP 파일 처리? 한국 전용 포맷

해외 AI가 이걸 직접 처리하기 위해선 별도 설정이 필요하고, 그 설정을 스킬로 묶어둔 게 k-skill이다. 한국 생활 운영체제 쪽으로 방향이 잡혀 있다. 로드맵에 정부24, 홈택스, 토스, 카카오페이가 이미 있다.

설치 순서 — 5단계

사전 조건

Claude Code 또는 opencode 설치 완료
macOS 또는 Linux 환경 (Windows는 미지원)
brew 또는 curl 사용 가능

Step 1: k-skill 전체 설치

# Claude Code에 설치
skills add NomaDamas/k-skill --all -g

# opencode나 다른 에이전트도 동일한 방식

--all 옵션으로 모든 스킬을 한 번에 설치한다. -g는 전역(global) 설치.

Step 2: k-skill-setup 실행

k-skill-setup

설치 직후 이 명령을 반드시 실행해야 한다. 각 스킬이 필요한 인증 정보, API 키, 설정 파일을 한 번에 세팅한다.

Step 3: sops + age 설치 (보안 설정)

# macOS
brew install sops age

sops는 비밀 파일 암호화 도구, age는 암호화 키 생성 도구다. k-skill은 SRT 아이디/비밀번호, 카카오 인증 같은 민감한 정보를 이 두 가지로 암호화해서 관리한다.

인증 정보를 그냥 텍스트로 저장하면 깃에 올라갈 위험이 있다. k-skill이 sops+age로 묶어서 관리하는 건 꽤 실용적인 선택이다.

Step 4: age 키 생성

# 키 파일 생성
age-keygen -o ~/.config/k-skill/age-key.txt

# 공개 키 확인
age-keygen -y ~/.config/k-skill/age-key.txt

이 키 파일은 절대 공개 저장소에 올리면 안 된다. ~/.config/k-skill/ 경로에 안전하게 보관.

Step 5: 개별 스킬 인증 설정

k-skill-setup을 실행하면 각 스킬별로 필요한 인증을 물어본다.

SRT의 경우:
– SRT 아이디 (멤버십 번호 또는 이메일)
– 비밀번호

이 정보가 ~/.config/k-skill/secrets.env에 암호화 저장된다.

실제로 써본 것들

SRT 예매 자동화

나: "이번 주 토요일 서울→부산 특실 예매해줘"
Claude Code: SRT 로그인 → 날짜 선택 → 좌석 선택 → 예매 완료

직접 써봤다. 연결이 되면 말 그대로 된다. 단, SRT 서버 부하 시간대에는 타임아웃이 날 수 있다.

KBO 경기 결과 조회

나: "오늘 두산 경기 결과 알려줘"
Claude Code: 오늘 KBO 경기 결과 → "두산 vs LG, 3-2 두산 승"

게임 중계 데이터를 파싱하기 때문에 경기 종료 직후에는 약간의 딜레이가 있을 수 있다.

HWP 문서 처리

나: "이 hwp 파일 내용 요약해줘"
Claude Code: HWP 파싱 → 텍스트 추출 → 요약

작동은 했지만 HWP 포맷이 복잡할 경우 파싱 실패가 있었다. 단순한 텍스트 중심 HWP는 잘 처리된다.

언제 안 써도 되는가

솔직하게 정리하면:

KTX 예매가 급한 경우: 아직 미지원. SRT만 된다.
Windows 사용자: 현재 지원 없음. macOS/Linux 필요.
보안이 최우선인 업무 환경: sops+age로 암호화하지만, 회사 기기에 SRT 비밀번호를 넣는 게 불안하면 개인 기기에서만 쓰는 게 낫다.
설치 시간 없는 경우: setup까지 30분 정도 잡아야 한다. 빠른 결과가 필요하면 그냥 SRT 앱 쓰는 게 빠르다.

보안 주의사항

여기서 중요한 얘기를 해야 한다.

sops+age는 좋은 선택이지만, 완벽하지 않다.

age 키 파일(age-key.txt)이 노출되면 모든 암호화된 시크릿이 풀린다
~/.config/k-skill/는 공개 저장소와 분리해서 관리해야 한다
회사 기기에서 개인 SRT 비밀번호를 넣는 건 회사 보안 정책과 충돌할 수 있다
각 스킬이 실제로 어떤 네트워크 요청을 보내는지 README로 확인하는 습관 권장

로드맵에 있는 것들

현재 개발 중인 기능들이다.

정부24 연동
홈택스 연동
토스 잔액 조회
카카오페이 결제 내역

이게 다 되면 한국 생활 자동화 에이전트로 볼 수 있는 수준이다. 아직은 “일부 기능이 되는 초기 레포” 단계.

실수 TOP 3

실수 1: k-skill-setup 없이 바로 스킬 실행하는 것

설치 후 setup 없이 스킬을 호출하면 “인증 정보 없음” 오류가 난다. setup이 필수 선행 단계다.

실수 2: KTX도 된다고 기대하는 것

README에 명확히 “KTX 예매는 작동하지 않음”이라고 나온다. SRT만 현재 지원.

실수 3: age 키 파일을 깃 저장소에 올리는 것

~/.config/k-skill/age-key.txt는 반드시 .gitignore에 포함되어 있어야 한다. 이 키가 노출되면 암호화된 시크릿 전체가 위험하다.

FAQ

Q. Claude Code 없이 ChatGPT에서 k-skill 쓸 수 있나요?

A. 아니다. k-skill은 Claude Code, opencode, Codex 같은 터미널 기반 AI 에이전트용이다. ChatGPT 웹 인터페이스는 로컬 스크립트 실행을 지원하지 않는다.

Q. macOS가 없으면 쓸 수 없나요?

A. 현재 macOS와 Linux만 지원된다. Windows 지원은 로드맵에 언급되지 않았다.

Q. SRT 비밀번호가 안전하게 저장되나요?

A. sops+age 암호화로 저장된다. age 키만 안전하게 관리하면 실제 비밀번호 텍스트는 노출되지 않는다. 단, age 키 파일 자체의 보안이 핵심이다.

Q. k-skill이 실패할 때 로그를 어디서 보나요?

A. 에이전트 실행 터미널에서 오류 메시지를 확인하거나, ~/.config/k-skill/ 경로의 로그 파일을 확인한다. 각 스킬 README에 디버깅 방법이 있다.

Q. 직접 새로운 한국 서비스 스킬을 만들 수 있나요?

A. 가능하다. k-skill은 오픈소스다. 스킬 구조를 따라 새로운 스킬을 만들어 PR을 보내거나 로컬에서 운용할 수 있다.

공식 출처

GitHub: NomaDamas/k-skill
2026년 3월 24일 생성, 최근 업데이트 2026년 3월 27일
별 145개 (작성 시점 기준)
GeekNews (hada.io) 소개 기사 참조